OSI /MHS SCF Reference Manual Abstract This manual describes how to use the Subsystem Control Facility (SCF) interactive interface to configure and control a Compaq Open System Interconnection/Message Handling System (OSI/MHS) subsystem. This manual also describes how to use the PTrace program to display trace files. This manual is intended for operators, network managers, and application programmers.
Document History Part Number Product Version Published 069674 OSI/MHS C32 March 1993 099930 OSI/MHS D20 September 1993 104439 OSI/MHS D21 May 1994 112152 OSI/MHS D22 June 1995 132300 OSI/MHS D41 February 1997 424828-001 OSI/MHS D42 December 1999 Ordering Information For manual ordering information: domestic U.S. customers, call 1-800-243-6886; international customers, contact your local sales representative.
OSI /MHS SCF Reference Manual Glossary Index Figures Tables What’s New in This Manual ix Manual Information ix New and Changed Information ix About This Manual xi Who Should Read This Manual? What’s in This Manual? Related Manuals xi xi xii Your Comments Invited xvi Notation Conventions xvi Abbreviations xx 1.
1. Introduction (continued) Contents 1. Introduction (continued) SUBSYS Object null Object 1-8 1-9 1-9 Wild-Card and Special Characters Wild-Card Notation in Object Names 1-9 Wild-Card Notation in O/R Names 1-10 Wild-Card Notation in ROUTE and APPL X.121 Addresses and Numeric User Identifiers 1-11 CONFIRM Option 1-13 Error Messages 1-14 Subsystem Identifier 1-14 Common Versus Subsystem-Specific Errors 1-14 Summary States Supported by OSI/MHS 1-15 2.
2. OSI/MHS SCF Commands (continued) Contents 2.
3. Formatting Trace Files With PTrace Contents 3. Formatting Trace Files With PTrace Running PTrace 3-1 Starting a Noninteractive Session 3-1 Starting an Interactive Session 3-2 PTrace Commands 3-3 SELECT Command 3-3 3-6 DESELECT Command LABEL Command 3-6 Getting Help 3-7 Device Types and Subtypes 3-7 Trace Record Formats 3-8 MON Trace Records 3-8 3-12 PROCESS Trace Records GIP Trace Records 3-23 A.
A. OSI/MHS SCF Command Syntax Summary (continued) Contents A.
A. OSI/MHS SCF Command Syntax Summary (continued) Contents A.
A. OSI/MHS SCF Command Syntax Summary (continued) Contents A. OSI/MHS SCF Command Syntax Summary (continued) STATUS SUBSYS Command STOP APPL Command A-42 A-42 STOP CLASS Command A-42 STOP GROUP Command A-42 STOP MON Command A-42 A-42 STOP SUBSYS Command SUSPEND APPL Command TRACE MON Command A-43 A-43 TRACE PROCESS Command A-44 VERSION PROCESS Command A-44 VERSION null PROCESS A-44 B. OSI/MHS SCF Error Messages Glossary Index Figures Figure i. OSI/MHS Manual Set xiii Figure ii.
Contents OSI /MHS SCF Reference Manual—424828-001 viii
What’s New in This Manual Manual Information SCF Reference Manual for Tandem OSI/MHS Abstract This manual describes how to use the Subsystem Control Facility (SCF) interactive interface to configure and control a Compaq Open System Interconnection/Message Handling System (OSI/MHS) subsystem. This manual also describes how to use the PTrace program to display trace files. This manual is intended for operators, network managers, and application programmers.
New and Changed Information What’s New in This Manual OSI /MHS SCF Reference Manual—424828-001 x
About This Manual This manual describes how to use the Subsystem Control Facility (SCF) interactive interface to configure and control a Compaq Open Systems Interconnection/Message Handling System (OSI/MHS) data communications subsystem. It also describes how to use the PTrace program to display trace files. For information about the programmatic interface to the Compaq OSI/MHS subsystem, see the OSI/MHS Management Programming Manual.
Related Manuals About This Manual • • • Section 3, Formatting Trace Files With PTrace, describes the subsystem-specific details for formatting and displaying OSI/MHS trace files using the PTrace program. Appendix A, OSI/MHS SCF Command Syntax Summary, lists the commands alphabetically and displays their syntax. Appendix B, OSI/MHS SCF Error Messages, lists and describes each OSI/MHS subsystem-specific error message.
Related Manuals About This Manual • OSI/MHS Management Programming Manual, describes the Subsystem Programmatic Interface (SPI) and Event Management Service (EMS) used by management applications to manage OSI/MHS. This manual also describes the master password server process provided by OSI/MHS and the password server programmatic interfaces used by password server applications. It serves as both a reference manual and a programmer’s guide for the development of network-management applications.
Related Manuals About This Manual Figure ii shows how this manual is related to other Compaq manuals. The following is a description of the purpose and content of each manual in Figure ii. For background information on the Compaq environment, you may want to read the following manuals: • • • Introduction to Compaq Networking and Data Communications. This manual provides an overview of aspects of networking and data communications specific to Compaq systems.
Related Manuals About This Manual • SCF Reference Manual for X25AM. This manual describes how to use SCF commands to install, control, and inquire about the Compaq X25AM subsystem. Figure ii. Related Manuals Introduction to Networking and Data Comm.
Your Comments Invited About This Manual Your Comments Invited After using this manual, please take a moment to send us your comments. You can do this by returning a Reader Comment Card or by sending an Internet mail message. A Reader Comment Card is located at the back of printed manuals and as a separate file on the Compaq CD Read disc. You can either FAX or mail the card to us. The FAX number and mailing address are provided on the card.
General Syntax Notation About This Manual { } Braces. A group of items enclosed in braces is a list from which you are required to choose one item. The items in the list may be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines. For example: LISTOPENS PROCESS { $appl-mgr-name } { $process-name } ALLOWSU { ON | OFF } | Vertical Line.
Notation for Messages About This Manual !i and !o. In procedure calls, the !i notation follows an input parameter (one that passes data to the called procedure); the !o notation follows an output parameter (one that returns data to the calling program). For example: CALL CHECKRESIZESEGMENT ( segment-id , error ) ; !i !o !i,o. In procedure calls, the !i,o notation follows an input/output parameter (one that both passes data to the called procedure and returns data to the calling program).
Notation for Management Programming Interfaces About This Manual { } Braces. A group of items enclosed in braces is a list of all possible items that can be displayed, of which one is actually displayed. The items in the list might be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines. For example: LBU { X | Y } POWER FAIL process-name State changed from old-objstate to objstate { Operator Request.
Abbreviations About This Manual Abbreviations The following list defines abbreviations used in this manual and in other Compaq OSI/MHS manuals. Both industry-standard terms and Compaq terms are included; Compaq terms are marked as such. ADMD. Administration management domain API. Application program interface APIA. Application Program Interface Association ASN.1. Abstract Syntax Notation One AU. Access unit BER. Basic encoding rules CCITT. International Telegraph and Telephone Consultative Committee DDL.
Abbreviations About This Manual IDU. Internal data unit IM. Interpersonal messaging IPC. Interprocess communication IPM. Interpersonal message IPN. Interpersonal notification ISO. International Organization for Standards MD. Management domain MH. Message handling MHS. Message handling system MOTIS. Message-Oriented Text Interchange System MPDU. Message protocol data unit MR. Message relay MRP. Message relay process MS. Message store MTA. Message transfer agent MTS. Message transfer system NBPS.
Abbreviations About This Manual PDU. Protocol data unit PRMD. Private management domain RTS. Reliable transfer service RTSE. Reliable Transfer Service Entity SC. Store cleaner SCF. Subsystem Control Facility (Compaq term) SCP. Subsystem Control Point (Compaq term) SPI. Subsystem Programmatic Interface (Compaq term) TAL. Transaction Application Language (Compaq term) TMF. Transaction Management Facility (Compaq term) UA. User agent UTC. Universal Coordinated Time XAPIA. X.
1 Introduction The Compaq Open Systems Interconnection/Message Handling System (OSI/MHS) is a 1988 implementation of the X.400 Message Handling System (MHS) model. Compaq OSI/MHS allows you to build a large-scale X.400 messaging network on Compaq computers. The OSI/MHS subsystem runs on any Compaq NonStop computer that uses the NonStop operating system. OSI/MHS can interoperate with Compaq systems and other X.400 systems.
Object Specification Introduction Object Specification Object types and object names make up the object specification. The object types that OSI/MHS supports are listed in Table 1-1, along with the object name format for each type. The syntax of the name format is described in detail below the table, followed by a definition of each object. Table 1-1. OSI/MHS Object Types and Name Formats Object Type Name Format APPL [\psystem.]$proc.#applname CLASS [\psystem.]$proc.#class CUG [\psystem.]$proc.
Object Specification Introduction class is an alphanumeric string. It can be one of the following values: GI, LO, MR, MS, or RS. You can use this qualifier when directing requests to the class as a whole and when constructing names to identify individual groups. cug is an alphanumeric string with a maximum length of 32 characters. It specifies the name of an individual closed user group (CUG). cugmember is an alphanumeric string with a maximum length of 32 characters.
OSI/MHS Object Hierarchy Introduction pname is an alphanumeric string with a maximum length of four characters. It specifies a valid process name route is an alphanumeric string with a maximum length of 16 characters. It is used to define the location of routing information in the OSI/MHS routing database. subsys is an alphanumeric string with a maximum length of four characters, the first of which must be an alphabetic character. It specifies the name of the subsystem.
APPL Object Introduction Figure 1-2. OSI/MHS Subsystem Object Hierarchy SUBSYS CLASS GATEWAY GROUP APPL MON DLIST CUG MTA DLISTMEMBER CUGMEMBER ROUTE ENTRY PROCESS CDT 004.CDD APPL Object The APPL object type defines an application to the OSI/MHS subsystem. The APPL object is used to configure the routing database and the OSI/MHS user database.
CUG Object Introduction • • #MS, which refers to the message store CLASS object #RS, which refers to the remote operations service CLASS object Examples of CLASS object names are: $ZMHS.#GI $ZMHS.#LO $ZMHS.#MR $ZMHS.#MS $ZMHS.#RS CUG Object The CUG object type defines a closed user group within the OSI/MHS subsystem. CUGMEMBER Object The CUGMEMBER object type identifies an individual member of a closed user group.
GATEWAY Object Introduction GATEWAY Object The GATEWAY object type allows you to define, control, and inquire about gateways attached to the OSI/MHS subsystem. You can configure up to 16 gateways per OSI/MHS subsystem. An example of a GATEWAY object name is: $ZMHS.#TG GROUP Object The GROUP object type identifies a group of related processes. It is used to configure, stop, and start related processes. If you issue the START command to a group, all processes in that group are started.
MTA Object Introduction MTA Object The MTA object type defines adjacent MTAs and their attributes to the OSI/MHS subsystem. This object is used to control and inquire about adjacent MTAs. Routes are defined for remote X.400 users or sets of remote X.400 users using these MTA objects. You can configure up to 800 adjacent MTA objects. Examples of MTA object names include: $ZMHS.#NEWYORK $ZMHS.#TOKYO $ZMHS.#HK PROCESS Object The PROCESS object type defines a process to the OSI/MHS subsystem.
null Object Introduction null Object A null object type is used as the object type in commands that do not require you to specify a particular object type. The null object type is not an actual object type: “null” is a term used to represent the absence of an object type in the command. If an SCF command supports the null object type, you can issue it without specifying an object type. The null object type has no hierarchical relationship to any of the other object types that OSI/MHS supports.
Wild-Card Notation in O/R Names Introduction Here are some examples of how you might use wild-card characters: NAMES GROUP $ZMHS.* lists the names of all groups. NAMES GROUP $ZMHS.#MS.* lists the names of all groups in the MS class. NAMES GROUP $ZMHS.*.\ZOMM.* lists the names of all groups on the node \ZOMM. NAMES PROCESS $ZMHS.#ZAC? lists all four-character processes starting with “ZAC.
Wild-Card Notation in ROUTE and APPL X.121 Addresses and Numeric User Identifiers Introduction • In the ALTER command, you can use an asterisk to remove a previously specified name element. This example changes the SUR-NAME attribute so that the APPL accepts any legal value: ALTER APPL $ZMHS.
Wild-Card Notation in ROUTE and APPL X.121 Addresses and Numeric User Identifiers Introduction This address matches all X121-ADDR attributes that begin with 493. Similarly, this address matches all NUMERIC-USER-IDENTIFIER attributes that begin with 7752: NUMERIC-USER-IDENTIFIER 7752* Note. The X121-ADDR string is 1 to 15 numeric characters long; the NUMERIC-USERIDENTIFIER string is 1 to 32 numeric characters long.
CONFIRM Option Introduction To indicate full wild-carding, use a double asterisk (**). For example, the following X.121 address matches all legal X.121 names: X121-ADDR ** It is important to understand the OSI/MHS implementation of the single asterisk and double asterisk wild-card characters. In all O/R names, including X.121 and numeric user identifier names, a single asterisk means “not used.” Thus, a single asterisk causes the O/R name to be ignored in routing decisions.
Error Messages Introduction Error Messages SCF displays an error message when it cannot complete the requested action. This happens when the command is entered incorrectly or is not appropriate for some reason (for example, the target object cannot be found or is not in the required state, or the user does not have a proper user ID to perform a sensitive command). Subsystem Identifier Error messages for SCF commands sent to Compaq OSI/MHS processes can originate from the OSI/MHS subsystem or from SCF.
Summary States Supported by OSI/MHS Introduction Examples For example, the following error can be returned by the Compaq OSI/MHS subsystem and is specific to the Compaq OSI/MHS subsystem—no other subsystem generates this same error number and text. Cause and recovery information for this error is given in Appendix B, OSI/MHS SCF Error Messages, of this manual. Note that the error number is a positive number.
Summary States Supported by OSI/MHS Introduction Table 1-3. OSI/MHS Summary States State Definition DEFINED The object is known (defined) to the subsystem. The object is unconfigured and has no link established to or from it. STARTING The object is being initialized and is attempting to start. STARTED The object is initialized and ready for normal data traffic. STOPPING The object is being stopped. The object is in the STOPPING state if its next state is expected to be STOPPED.
2 OSI/MHS SCF Commands This section describes the SCF commands that the Compaq Open Systems Interconnection/Message Handling System (OSI/MHS) subsystem supports. Table 2-1 shows the object types that each OSI/MHS command supports. The command/object-type table is followed by some information about sensitive and nonsensitive commands, syntax variables used in the commands, and a complete description of each command. Table 2-1.
OSI/MHS SCF Commands Table 2-1.
OSI/MHS Commands OSI/MHS SCF Commands OSI/MHS Commands This section provides descriptions of the SCF OSI/MHS commands, in alphabetic order, and includes the syntax, object specification, attributes, considerations, and examples for each command. Sensitive and Nonsensitive Commands Because some commands can have detrimental effects if used improperly, special qualification is required to use them.
Syntax Variables in OSI/MHS Commands OSI/MHS SCF Commands IA5-string is a string of alphanumeric characters (A through Z, 0 through 9). If enclosed in quotation marks, it can include these additional characters: space and ‘ ( ) + , - . / : = ?. In this implementation, IA5-string is restricted to the character set that SCF will accept in a quoted string. To preserve the case of the characters, the string must be entered within quotation marks.
Syntax Variables in OSI/MHS Commands OSI/MHS SCF Commands string depending on where used, represents: • • • a string of numeric characters (0 through 9) a string of alphabetic characters (A through Z). If enclosed in quote marks, it can include these additional special characters: space and ’ ( ) + , - . / : = ? a string of alphanumeric characters (A through Z, 0 through 9). If enclosed in quote marks, it can include these special characters: space and ’ ( ) + , - .
ABORT Command OSI/MHS SCF Commands ABORT Command The ABORT command stops objects as quickly as possible—only enough processing is done to ensure the integrity of the OSI/MHS subsystem. You can use the ABORT command to stop the APPL, CLASS, GROUP, MON, and SUBSYS objects. When you issue this command, the object to which it is directed must be in a state other than the STOPPED state. The object is left in the STOPPED state after it is aborted.
ABORT Command OSI/MHS SCF Commands SEL [ NOT ] state directs the command only at objects in the specified state or not in the specified state. Valid values for state are: DEFINED, STARTING, STARTED, STOPPING, STOPPED, and SUSPENDED. States are described in Section 1, Introduction. Considerations • • • • When the ABORT command is directed at the MON object, the MHS manager stops itself. The MHS manager disappears (that is, it becomes undefined).
ACTIVATE Command OSI/MHS SCF Commands ACTIVATE Command The ACTIVATE command is valid only for APPL object types. The ACTIVATE command causes a suspended APPL object to return to the STARTED state. This is a sensitive command. ACTIVATE [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#applname is the name of the APPL object to be activated.
ADD APPL Command OSI/MHS SCF Commands ADD APPL Command The ADD APPL command defines a user or a set of users (and associated configuration information) accessing the OSI/MHS subsystem. The APPL object can represent a user accessing the OSI/MHS subsystem through either a message store or a gateway. The initial state for the added APPL will be the STOPPED state; incoming messages with this APPL named as a recipient will be rejected with Non Delivery Notification (NDN) until the APPL is STARTED.
ADD APPL Command OSI/MHS SCF Commands ACCESS-TYPE specifies one of two access methods used for message submission and delivery: • • GW indicates that the APPL object accesses OSI/MHS through a gateway application such as a Transfer X400 or GPI gateway. MS indicates that the APPL object accesses OSI/MHS through a group in the MS class. The following attribute specifications specify O/R (originator/recipient) name attributes.
ADD APPL Command OSI/MHS SCF Commands COMMON-NAME specifies the common name. This value has a maximum length of 64 alphanumeric characters. DEL-MAX-MSG-LEN specifies the maximum size that can be delivered to this APPL object. This value has a range from 1 through 10,485,760 bytes (10 megabytes). The default value is 512,000. DOM-TYPE-(1-4) specifies the attribute type of the X.400 attribute domainDefinedAttributes. This value has a maximum length of eight characters.
ADD APPL Command OSI/MHS SCF Commands ORG-UNIT-(1-4) specifies the organizational unit name. This value has a maximum length of 32 characters. PRMD specifies the private domain name. This value has a maximum length of 16 alphanumeric characters. SUR-NAME specifies the surname (last name) of the personal name set. This value has a maximum length of 40 alphanumeric characters. TERMINAL-ID specifies the terminal identifier. This value has a maximum length of 24 alphanumeric characters.
ADD APPL Command OSI/MHS SCF Commands DEL-EDI specifies that messages with content type PEDI can be delivered to this APPL object. The default value is ON. This attribute corresponds to the built-in content type of 35 (PEDI) and the external object ID content type (2,6,7,10,0), defined in X.435. DEL-EXTERNAL specifies that messages with content type EXTERNAL can be delivered to this APPL object. The default value is ON. This corresponds to the built-in content type of 1 (external), defined in X.411.
ADD APPL Command OSI/MHS SCF Commands The following attributes specify the encoded information types that can be delivered to this APPL object.
ADD APPL Command OSI/MHS SCF Commands EIT-EDI-ANSIX12-T61 specifies that this APPL object can receive EDI messages with a primary body part that uses the ANSI X.12 standard and the recommended T61 character set. The default value is OFF. EIT-EDI-EDIFACT-ISO646 specifies that this APPL object can receive EDI messages with a primary body part that uses the EDIFACT (ISO 9735) standard and the ISO 646 character set. The default value is OFF.
ADD APPL Command OSI/MHS SCF Commands ENCODED-INFO-TYPE-G3FAX specifies that this APPL object can receive G3 FAX messages. The default value is OFF. ENCODED-INFO-TYPE-IA5TEXT specifies that this APPL object can receive IA5 text messages. The default value is ON. ENCODED-INFO-TYPE-SFD specifies that this APPL object can receive SFD messages. The default value is OFF. ENCODED-INFO-TYPE-TIF0 specifies that this APPL object can receive TIF0/G4-CLASS-1 messages. The default value is OFF.
ADD APPL Command OSI/MHS SCF Commands The attribute-spec for the ADD APPL command for access type MS is one of the following attribute name and value combinations. You must specify the USER-PASSWORD attribute. [ SUB-MAX-MSG-LEN integer ] USER-PASSWORD IA5-string SUB-MAX-MSG-LEN specifies the maximum length of a message that you can submit. This value is in the range 1 through 10,485,760 bytes (10 megabytes). The default value is 512,000.
ADD APPL Command OSI/MHS SCF Commands SUB-MSG-ALLOWED specifies whether or not the APPL object can submit messages. The default value is ON. SUB-PROBE-ALLOWED specifies whether or not the APPL object can submit probes. The default value is OFF. SUB-RELIABLE-TRANSFER defines the method used and path taken by messages from the LO group to the OSI/MHS subsystem. ON ensures that messages are submitted exactly once, provided that the P7 API application assigns invoke IDs in a particular way.
ADD APPL Command OSI/MHS SCF Commands The following message-retrieval attribute applies to the list-and-fetch-attribute defaults maintained by the message store (MS). [ SET-RTVL-DEFAULTS { ON | OFF } ] SET-RTVL-DEFAULTS specifies how the list-and-fetch attributes are set according to the message-retrieval attributes configured for this APPL. If the value is OFF and an APPL is added, the list-and-fetch attributes for the new or altered APPL are reset to the empty set.
ADD APPL Command OSI/MHS SCF Commands At least one of the following attributes must be present. The default value for all of the following attributes is ON.
ADD APPL Command OSI/MHS SCF Commands BIL-DEF-BODY-PART allows the APPL object to use the X.400 attribute bilaterallyDefinedBodyParts. BLIND-COPY-RECIPS allows the APPL object to use the X.400 attribute blindCopyRecipients. BODY allows the APPL object to use the X.400 attribute body. CHILD-SEQ-NO allows the APPL object to use the X.400 attribute childSequenceNumber. CONTENT allows the APPL object to use the X.400 attribute content. CONTENT-ID allows the APPL object to use the X.
ADD APPL Command OSI/MHS SCF Commands IMPORTANCE allows the APPL object to use the X.400 attribute importance. IPM-ENTRY-TYPE allows the APPL object to use the X.400 attribute IPMEntryType. MSG-DEL-ENVELOPE allows the APPL object to use the X.400 attribute messageDeliveryEnvelope. MSG-DEL-ID allows the APPL object to use the X.400 attribute messageDeliverIdentifier. MSG-DEL-TIME allows the APPL object to use the X.400 attribute messageDeliveryTime.
ADD APPL Command OSI/MHS SCF Commands REP-DEL-ENVELOPE allows the APPL object to use the X.400 attribute reportDeliveryEnvelope. REPLIED-TO-IPMS allows the APPL object to use the X.400 attribute repliedtoIPMs. REPLY-RECIPS allows the APPL object to use the X.400 attribute replyRecipients. REPLY-TIME allows the APPL object to use the X.400 attribute replyTime. SENSITIVITY allows the APPL object to use the X.400 attribute sensitivity. SEQ-NO allows the APPL object to use the X.
ADD APPL Command OSI/MHS SCF Commands in its databases; they are simply passed through to the external password server when an APPL object is added or altered. [ [ [ [ APPL-NSAP hex-character-string APPL-PSELECTOR hex-character-string APPL-SSELECTOR hex-character-string APPL-TSELECTOR hex-character-string ] ] ] ] APPL-NSAP specifies the NSAP portion of the APPL object’s OSI calling address. This value has a maximum length of 40 characters.
ADD APPL Command OSI/MHS SCF Commands DUPL-SUPRN specifies whether duplicate message and report suppression is enabled (ON) or disabled (OFF) for the MS APPL object. The default value is OFF. DUPL-SUPRN-WINDOW specifies the minimum length of time that duplicate suppression is enforced for an individual message or report received by the MS APPL object.
ADD APPL Command OSI/MHS SCF Commands • • • By default, the value of all MS APPL message-retrieval attributes is ON. To save message-store space, change the value to OFF for any message-retrieval attribute the APPL object does not require. Only the attributes that are currently specified as ON are stored in the mailbox for that message. That is, if an MS APPL message-retrieval attribute is set to OFF, then that attribute is not stored in the Message Store.
ADD APPL Command OSI/MHS SCF Commands This command adds a generic APPL object: ADD APPL $ZMHS.
ADD CLASS Command OSI/MHS SCF Commands ADD CLASS Command The ADD CLASS command configures information that is specific to a group class. This is a sensitive command. ADD [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#class specifies the name of the CLASS object to be added. attribute-spec is a specification of an attribute and a value to be assigned to it.
ADD CLASS Command OSI/MHS SCF Commands [ [ [ [ [ [ [ [ [ [ [ [ [ RECOVERY-TIME time REPORT-ROUTE-RETRY-DELAY time REPORT-ROUTE-RETRY-GROW integer REPORT-ROUTE-RETRY-TIME time ROUTE-RETRY-CHECK { MTS | LOCAL } SAFE-STORE-WINDOW integer TOTAL-ASSOCS integer URGENT-COUNT integer URGENT-ROUTE-RETRY-DELAY time URGENT-ROUTE-RETRY-GROW integer URGENT-ROUTE-RETRY-TIME time URGENT-TIME time WINDOW-SIZE integer ] ] ] ] ] ] ] ] ] ] ] ] ] ASSOC-CLOSE-TIME specifies the time allowed for the RT-CLOSE primitive to b
ADD CLASS Command OSI/MHS SCF Commands CLOSE-TIME specifies the time to maintain an association when no messages are on queue. This value is expressed in seconds and has a range of 1 through 36000. The default value is 300. CUG-CHECK specifies whether or not the closed user group (CUG) validation of messages and probes is performed by MR groups. ALL indicates that CUG validation is performed for the originator and all recipients of messages and probes. NONE indicates that no CUG validation is performed.
ADD CLASS Command OSI/MHS SCF Commands NONURGENT-ROUTE-RETRY-DELAY specifies the initial time the MR group has to wait after it has exhausted all the routes for sending a nonurgent message, before it can retry starting with the first route. This value is expressed in minutes, and the range is 0 through 36000. The value 0 means an infinite time is allowed; that is, no route retry attempts are made. The default value is 60. This attribute applies to nonurgent-priority messages.
ADD CLASS Command OSI/MHS SCF Commands NORMAL-ROUTE-RETRY-DELAY specifies the initial time the MR group has to wait after it has exhausted all the routes for sending a normal message, before it can retry starting with the first route. This value is expressed in minutes, and the range is 0 through 36000. The value 0 means an infinite time is allowed; that is, no route retry attempts are made. The default value is 30. This attribute applies to normal-priority messages.
ADD CLASS Command OSI/MHS SCF Commands REPORT-ROUTE-RETRY-DELAY specifies the time the MR group has to wait after it has exhausted all the routes for sending a report, before it can retry starting with the first route. This value is expressed in minutes, and the range is 0 through 36000. The value 0 means an infinite time is allowed; that is, no route retry attempts are made.
ADD CLASS Command OSI/MHS SCF Commands TOTAL-ASSOCS specifies the maximum number of incoming and outgoing associations a single MR group can support. This value is in the range 5 through 20. The default value is 10. URGENT-COUNT specifies the maximum number of urgent messages the MRP can have on its queue for a given destination before it attempts to establish an association with the adjacent MTA.
ADD CLASS Command OSI/MHS SCF Commands an adjacent MTA before this time expires if the URGENT-COUNT threshold is reached for the adjacent MTA. This value is expressed in seconds and has a range of 1 through 36000. The default value is 300. WINDOW-SIZE specifies the number of data packets to be sent before an acknowledgment is sent. This value is in the range 1 through 100. The default value is 3.
ADD CLASS Command OSI/MHS SCF Commands Examples These commands add CLASS objects $ZMHS.#MS, $ZMHS.#MR, $ZMHS.#RS, and $ZMHS.#GI. Each example specifies some of the attributes you can use with the ADD CLASS command: ADD ADD ADD ADD CLASS CLASS CLASS CLASS $ZMHS.#MS, $ZMHS.#MR, $ZMHS.#RS, $ZMHS.
ADD CUG Command OSI/MHS SCF Commands ADD CUG Command The ADD CUG command defines a closed user group object to the OSI/MHS subsystem. A CUG defines a set of users who may exchange messages only with one another. If CUG checking is enabled, then all message and probe transfers must be within locally defined CUGs. This is a sensitive command. ADD [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file.
ADD CUG Command OSI/MHS SCF Commands CONTENT-TYPE-CHECK specifies whether content-type checks are performed for this CUG. OFF indicates that all content types are valid within the CUG and no check is performed. ON indicates that only content types defined by the ALLOWED-CONTENT-TYPE-x attribute (described above) are permitted. This is an optional attribute. The default value is OFF. LOWEST-PRIORITY specifies the lowest X.400 priority of a message that can be sent within this CUG.
ADD CUGMEMBER Command OSI/MHS SCF Commands ADD CUGMEMBER Command The ADD CUGMEMBER command defines a closed user group member object to the OSI/MHS subsystem. This is a sensitive command. ADD [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.cugmember [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#cug.cugmember is the name of the CUGMEMBER object to be added.
ADD CUGMEMBER Command OSI/MHS SCF Commands [ TERMINAL-ID printable-string [ TERMINAL-TYPE { G3FACSIMILE } { G4FACSIMILE } { IA5TERMINAL } { TELEX } { TELETEX } { VIDEOTEX } [ X121-ADDR string ] ] ] ADMD specifies the CUG member administration management domain name. This value has a maximum length of 16 alphanumeric characters, the first character of which must be alphabetic. COMMON-NAME specifies the CUG member common name. It has a maximum length of 64 alphanumeric characters.
ADD CUGMEMBER Command OSI/MHS SCF Commands NUMERIC-USER-IDENTIFIER specifies the CUG member numeric user identifier. This value has a maximum length of 32 numeric characters. ORG-NAME specifies the CUG member organization name. This value has a maximum length of 64 alphanumeric characters. ORG-UNIT-(1-4) specifies the CUG member organizational unit name. This value has a maximum length of 32 characters. PRMD specifies the CUG member private management domain name.
ADD CUGMEMBER Command OSI/MHS SCF Commands • A fully-qualified mnemonic, numeric, or terminal O/R name, specified in X.402 notation The O/R name attributes specified for a CUGMEMBER object should conform to one of the attribute sets listed above. Note that OSI/MHS does not validate that the O/R name attributes of a CUGMEMBER object conform to one of these types.
ADD DLIST Command OSI/MHS SCF Commands ADD DLIST Command The ADD DLIST command defines a local distribution list object to the OSI/MHS subsystem. Distribution lists are expanded by OSI/MHS in accordance with the X.400 recommendations. This is a sensitive command. ADD [ / OUT file-spec / ] DLIST [\psystem.]$proc.#dlist [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#dlist specifies the name of the DLIST object to be added.
ADD DLIST Command OSI/MHS SCF Commands [ DL-TERMINAL-ID printable-string ] [ DL-TERMINAL-TYPE { G3FACSIMILE } { G4FACSIMILE } { IA5TERMINAL } { TELEX } { TELETEX } { VIDEOTEX } ] [ DL-X121-ADDR string ] [ NOTIFY-POLICY { NOTIFY-ORIG-NORM } { NOTIFY-ORIG-ON-EXPANS } ] DL-ADMD specifies the administration domain name for the distribution list. This value has a maximum length of 16 alphanumeric characters. DL-COMMON-NAME specifies the common name for the distribution list.
ADD DLIST Command OSI/MHS SCF Commands DL-NUMERIC-USER-IDENTIFIER specifies the numeric user identifier for the distribution list. This value has a maximum length of 32 numeric characters. DL-ORG-NAME specifies the organization name for the distribution list. This value has a maximum length of 64 characters. DL-ORG-UNIT-(1-4) specifies the organizational unit name for the distribution list. This value has a maximum length of 32 characters.
ADD DLIST Command OSI/MHS SCF Commands The default value for this attribute is NOTIFY-ORIG-NORM. Note. The following attributes are distribution list owner O/R name attributes. These attributes can be specified for informational purposes. Distribution list owner O/R attributes are not used within OSI/MHS.
ADD DLIST Command OSI/MHS SCF Commands OW-DOM-VALUE-(1-4) specifies the attribute value of the X.400 attribute domainDefinedAttributes for the distribution list owner. This value has a maximum length of 128 characters. OW-GENERATION specifies the generation qualifier of the personal name set for the distribution list owner. This value has a maximum length of three characters. OW-GIVEN-NAME specifies the given name (first name) of the personal name set for the distribution list owner.
ADD DLIST Command OSI/MHS SCF Commands OW-TERMINAL-TYPE specifies the terminal type for the distribution list owner. OW-X121-ADDR specifies the X.121 address for the distribution list owner. You must specify a valid X.121 address. This value has a maximum length of 15 numeric characters. Considerations • The O/R name of a distribution list (the attributes having a DL-prefix) must be unique within an OSI/MHS subsystem and must not conflict with any existing DLIST, APPL, or ROUTE object type O/R name.
ADD DLISTMEMBER Command OSI/MHS SCF Commands ADD DLISTMEMBER Command The ADD DLISTMEMBER command defines a local distribution list member object to the OSI/MHS subsystem. This is a sensitive command. ADD [ / OUT file-spec / ] DLISTMEMBER [\psystem.]$proc.#dlist.dlistmember [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#dlist.dlistmember is the name of the DLISTMEMBER object to be added.
ADD DLISTMEMBER Command OSI/MHS SCF Commands [ TERMINAL-TYPE { G3FACSIMILE { G4FACSIMILE { IA5TERMINAL { TELEX { TELETEX { VIDEOTEX [ X121-ADDR string } } } } } } ] ] ADMD specifies the DLIST member administration management domain name. This value has a maximum length of 16 alphanumeric characters. COMMON-NAME specifies the DLIST member common name. It has a maximum length of 64 alphanumeric characters. DOM-TYPE-(1-4) specifies the DLIST member attribute type of the X.
ADD DLISTMEMBER Command OSI/MHS SCF Commands ORG-NAME specifies the DLIST member organization name. This value has a maximum length of 64 alphanumeric characters. ORG-UNIT-(1-4) specifies the DLIST member organizational unit name. This value has a maximum length of 32 alphanumeric characters. PRMD specifies the DLIST member private management domain name. This value has a maximum length of 16 alphanumeric characters. SUR-NAME specifies the DLIST member surname (last name) of the personal name set.
ADD DLISTMEMBER Command OSI/MHS SCF Commands Example This command adds a DLISTMEMBER object $ZMHS.#USERS.USER1 and specifies some of the attributes you can use with the ADD DLISTMEMBER command: ADD DLISTMEMBER $ZMHS.#USERS.
ADD GATEWAY Command OSI/MHS SCF Commands ADD GATEWAY Command The ADD GATEWAY command defines a gateway object to the OSI/MHS subsystem. This is a sensitive command. ADD [ / OUT file-spec / ] GATEWAY [\psystem.]$proc.#gateway [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#gateway is the name of the GATEWAY object to be added. attribute-spec is a specification of an attribute and a value to be assigned to it.
ADD GATEWAY Command OSI/MHS SCF Commands NORMAL defines a gateway to which messages are routed normally. NORMAL can be used for both GPI and TRANSFER gateways. NORMAL is the default value. P1-EXIT defines a special exit gateway. P1-EXIT is used only for GPI gateways. If P1-EXIT is specified, subsequent MPDUs received from the RTS are sent directly to the P1-EXIT gateway before OSI/MHS decodes or routes them.
ADD GATEWAY Command OSI/MHS SCF Commands Considerations • • • • If an exit gateway is specified (that is, if GW-TYPE is P1-EXIT), messages received by OSI/MHS from any local MS APPL object or from any gateway are not sent to the exit gateway. These messages are processed normally by OSI/MHS. No APPL objects can be defined for an exit gateway (that is, if GW-TYPE is P1-EXIT). Only one exit gateway (GW-TYPE is P1-EXIT) can be defined for an OSI/MHS subsystem.
ADD GROUP Command OSI/MHS SCF Commands ADD GROUP Command The ADD GROUP command defines a group of a given class to the OSI/MHS subsystem. Several groups can be defined for each of the five classes—GI, LO, MR, MS, and RS. These groups are referred to as the GI, LO, MR, MS, and RS groups. This is a sensitive command. ADD [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file.
ADD GROUP Command OSI/MHS SCF Commands PDU-LOG-FILE specifies the PDU log file the processes in the group are to access. The file must exist. A PDU log file is unique to a group. If the same PDU log file is specified for more than one group, an error occurs. The PDU log file must be on the same node as the MHS manager. PDU-STORE specifies the PDU store the processes in the group are to access. The PDU file must exist. A PDU store is unique to a group.
ADD GROUP Command OSI/MHS SCF Commands GI-PNAME specifies the name of the GI process within this group. mhs-proc-name must be entered as $proc.#pname. The node name cannot be specified. The process must reside on the same node as the MHS manager. GI-PRI specifies the execution priority at which the GI process runs. This attribute is optional; if it is omitted, the default priority-level value for the group is assumed.
ADD GROUP Command OSI/MHS SCF Commands The additional attribute-spec for the ADD GROUP command when the class is MR is one of the following attribute name and value combinations: MR-NSAP hex-character-string [ MR-P-SELECTOR [ hex-character-string ] ] [ MR-S-SELECTOR [ hex-character-string ] ] [ MR-T-SELECTOR [ hex-character-string ] ] [ MR-TRANSMIT-MODE { DRAIN | NORMAL } ] [ MRP-BACKUP cpu-number ] [ MRP-CPU cpu-number ] MRP-PNAME mhs-proc-name [ MRP-PRI integer ] [ RTS-BACKUP cpu-number ] [ RTS-CPU cpu-
ADD GROUP Command OSI/MHS SCF Commands MR-TRANSMIT-MODE specifies the mode of operation of an MR group. This value can be DRAIN or NORMAL. The default value is NORMAL. DRAIN means that an MR group continues to transmit to local or remote recipients messages it is currently processing, but that it does not accept any incoming messages from any source.
ADD GROUP Command OSI/MHS SCF Commands MRP-PNAME specifies the process name of the MRP within this group. mhs-proc-name must be entered as $proc.#pname. The node name cannot be specified. The process must reside on the same node as the MHS manager. MRP-PRI specifies the priority at which the MRP is to run. The maximum value is the priority of the MHS manager minus 1. If you do not specify this value, the default value for the group is used.
ADD GROUP Command OSI/MHS SCF Commands SC-PNAME specifies the process name of the store cleaner process within this group. mhsproc-name must be entered as $proc.#pname. The node name cannot be specified. The process must reside on the same node as the MHS manager. SC-PRI specifies the priority at which the store cleaner is to run. If you do not specify this value, the default value for this group is used.
ADD GROUP Command OSI/MHS SCF Commands object served by this MS group is added, altered, or deleted. The process specified in this attribute must reside on the same node as the MHS manager. MS-CPU specifies the CPU in which the MS process is to run. This attribute is optional; if you omit it, the default CPU for the group is assumed. No range checking is done; however, the maximum value of cpu-number should not exceed the number of CPUs on the target system (for example, 0 to 7 on an eight-CPU system).
ADD GROUP Command OSI/MHS SCF Commands RS-CPU specifies the CPU in which the RS process is to run. This attribute is optional; if you omit it, the default CPU for the group is assumed. No range checking is done; however, the maximum value of cpu-number should not exceed the number of CPUs on the target system minus one (for example, 0 to 7 on an eight-CPU system).
ADD GROUP Command OSI/MHS SCF Commands Considerations • • • • • • • When you add a group, the group is not started automatically; it is in the STOPPED state after it is added. To add an MS group, you must first add at least one MR group. You can configure different MR groups with the same OSI address, and you can configure different RS groups with the same OSI address (although you will lose the robust strategy of multiple groups).
ADD GROUP Command OSI/MHS SCF Commands PDU-STORE $PDUST2.MS2SV.PDU2, PDU-LOG-FILE $PDUST2.MS2SV.LOG2, MSG-STORE-SV $SQLV.SQLSV, MS-PNAME $ZMHS.#MS2, MS-BIND-PW-SVR $PWSVR, MR-COUNT 2, MR-NAME MRGRP1, MR-NAME MRGRP2 ADD GROUP $ZMHS.#RS.RSGRP1, CPU 2, BACKUP 1, PRI 140, PDU-STORE $DATA4.RSDB1.PDU1, PDU-LOG-FILE $DATA4.RSDB1.
ADD MTA Command OSI/MHS SCF Commands ADD MTA Command The ADD MTA command defines an adjacent MTA to the OSI/MHS subsystem. This is a sensitive command. In addition, ADD MTA requires you to have either the super ID (255,255) or the same group and user ID as the MHS manager. ADD [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#mta is the name of the MTA object to be added.
ADD MTA Command OSI/MHS SCF Commands [ [ [ [ [ [ [ [ [ LOC-TSELECTOR-1 [ LOC-TSELECTOR-2 [ LOC-TSELECTOR-3 [ LOC-TSELECTOR-4 [ LOC-TSELECTOR-5 [ LOC-TSELECTOR-6 [ LOC-TSELECTOR-7 [ PASSW-SERVER { ON REM-ABS-SYNTAX-ID hex-character-string ] ] hex-character-string ] ] hex-character-string ] ] hex-character-string ] ] hex-character-string ] ] hex-character-string ] ] hex-character-string ] ] | OFF } ] { ID-AS-MTA-RTSE } { ID-AS-MTS-RTSE } ] REM-ADMD printable-string REM-APPLIC-CONTEXT { MTS-TRANSFER } { MT
ADD MTA Command OSI/MHS SCF Commands [ [ [ [ [ [ [ [ [ [ REM-THEIR-PASSW { IA5-string | * } REM-THEIR-PASSW-RSP { IA5-string | * } REM-TSELECTOR-1 [ hex-character-string REM-TSELECTOR-2 [ hex-character-string REM-TSELECTOR-3 [ hex-character-string REM-TSELECTOR-4 [ hex-character-string REM-TSELECTOR-5 [ hex-character-string REM-TSELECTOR-6 [ hex-character-string REM-TSELECTOR-7 [ hex-character-string X121-COUNTRY-NAME string ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] COUNTRY-NAME specifies the actual name of
ADD MTA Command OSI/MHS SCF Commands LOC-TSELECTOR-(1-7) defines the T-selector part of this subsystem’s OSI address. This value identifies a transport layer entity. It is a hexadecimal string with a maximum length of 40 characters, and the string must contain an even number of characters. If you do not use this part of the address, it has a length of zero and the string portion is blankfilled.
ADD MTA Command OSI/MHS SCF Commands REM-MAX-MSG-LEN specifies the maximum message size that an adjacent MTA can receive. This value has a range of 0 through 10,485,760 bytes (10 megabytes), as represented by the literals ZMHS-VAL-MIN-MSG-LEN and ZMHS-VAL-MAX-MSG-LEN. The default value is 0, which indicates that no length check is performed. REM-MSG-OVERHEAD specifies the maximum time required to complete message acceptance after data transfer has occurred.
ADD MTA Command OSI/MHS SCF Commands REM-OUR-PASSW-RSP specifies the password expected from our OSI/MHS in response to the adjacent MTA's logon attempt. If REM-LOGON-VALIDATION is ON, this attribute is required. This value has a maximum length of 62 characters. An asterisk (*) indicates a null password. REM-PRMD specifies the private management domain name of the MTA. This value has a maximum length of 16 characters. REM-PSELECTOR-(1-7) defines the P-selector part of the adjacent MTA’s OSI address.
ADD MTA Command OSI/MHS SCF Commands REM-TSELECTOR-(1-7) defines the T-selector part of the adjacent MTA’s OSI address. This value identifies a transport layer entity. It is a hexadecimal string with a maximum of 64 characters, and the string must contain an even number of characters. If you specify the attribute name without any characters in the address, this part of the address is unused. X121-COUNTRY-NAME specifies the X.121 country name of the MTA. It has a length of three numeric characters.
ADD MTA Command OSI/MHS SCF Commands attributes instead of -1, as illustrated in the example that follows. You do not need to use consecutive numbers. The -1 pair is the first choice and the -7 pair is the last choice for communication with the adjacent MTA. You must specify at least one pair of addresses. • • • • • To specify a pair of addresses, you must specify at least the remote and local NSAP. You can specify other elements as well.
ADD ROUTE Command OSI/MHS SCF Commands ADD ROUTE Command The ADD ROUTE command defines an adjacent MTA for messages to be sent to an X.400 user or a set of X.400 users. This is a sensitive command. ADD [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#mta.route is the name of the ROUTE object to be added.
ADD ROUTE Command OSI/MHS SCF Commands [ SUR-NAME printable-string ] [ TERMINAL-ID printable-string ] [ TERMINAL-TYPE { G3FACSIMILE } { G4FACSIMILE } { IA5TERMINAL } { TELEX } { TELETEX } { VIDEOTEX } ] [ X121-ADDR { partial-numeric-string } ] { string } ] ADMD specifies the administration management domain name. This is an alphanumeric string with a maximum length of 16 characters, and the first character must be an alphabetic. The default value is the wild card.
ADD ROUTE Command OSI/MHS SCF Commands ISO-COUNTRY-NAME specifies the country name. The default value is the wild card. The length of the value is 2 characters. If the ADMD name is present (that is, not an asterisk (*)), then the ISO-COUNTRY name must also be present; otherwise, this route cannot be accessed. NUMERIC-USER-IDENTIFIER specifies the numeric user identifier. This value has a maximum length of 32 numeric characters.
ADD ROUTE Command OSI/MHS SCF Commands X121-ADDR specifies the X.121 address. This value has a maximum length of 15 numeric characters. OSI/MHS supports both partial wild-carding and full wild-carding of this attribute. For details, see Wild-Card Notation in ROUTE and APPL X.121 Addresses and Numeric User Identifiers on page 1-11 of this manual. Considerations • • • The most important attributes for a ROUTE command are the O/R name attributes.
ADD SUBSYS Command OSI/MHS SCF Commands ADD SUBSYS Command The ADD SUBSYS command defines a SUBSYS object to the OSI/MHS subsystem. It allows global data to be configured for all objects on a subsystem wide basis. After the SUBSYS object is added it will be in the STOPPED state. Only one SUBSYS object is allowed for an OSI/MHS subsystem. This is a sensitive command. ADD [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.#subsys [ , attribute-spec ]...
ADD SUBSYS Command OSI/MHS SCF Commands subvolume defined by the CONFIG-DB-SVOL parameter (for example, $USER7.DJOSIMHS.ZD1XDB). DL-FNAME specifies the file name of the distribution list database for this subsystem. The file must exist and must reside on the same node as the MHS manager. This attribute is optional. The default value is subsystem-nameJDB in the subvolume defined by the CONFIG-DB-SVOL parameter (for example, $USER7.DJOSIMHS.ZD1JDB).
ADD SUBSYS Command OSI/MHS SCF Commands OSI-MGR specifies the local OSI manager process. It must be on the same node as the MHS manager. PRMD-NAME specifies the private management domain (PRMD) name of this OSI/MHS subsystem. This value is a maximum of 16 characters long. ROUTING-FNAME specifies the name of the routing database. The file must exist and must be on the same node as the MHS manager. USER-FNAME specifies the name of the file containing data about the users of this subsystem.
ADD SUBSYS Command OSI/MHS SCF Commands ACCT-DEFER specifies that deferred delivery storage and cancellation be reported. ACCT-DELIVER-RECIP-INFO specifies that recipient information for delivered messages be reported. ACCT-DLIST-EXPANSION specifies that expansion of distribution lists be reported. ACCT-DUPL-SUPRN specifies that duplicate message suppression accounting events be reported.
ADD SUBSYS Command OSI/MHS SCF Commands ACCT-PROBE-SUBMIT specifies that submission of probes be reported. ACCT-REGISTRATION specifies that user registration be reported. ACCT-RELAY-RECIP-INFO specifies that recipient information for relayed messages be reported. ACCT-REPORT-DELIVER specifies that delivery of reports be reported. ACCT-REPORT-GEN specifies that generation of reports be reported. ACCT-REPORT-RELAY specifies that relay of reports be reported.
ADD SUBSYS Command OSI/MHS SCF Commands ACCT-UMPDU-RELAY specifies that relay of user message protocol data units (UMPDUs) be reported. ACCT-UMPDU-SUBMIT specifies that submission of user message protocol data units (UMPDUs) be reported. ACCT-UNROUTE-RECIP-INFO specifies that recipient information for unrouteable messages be reported. ACCT-UNROUTEABLE specifies that unrouteable messages (such as UMPDUs, probes, and reports) be reported.
ALTER APPL Command OSI/MHS SCF Commands ALTER APPL Command The ALTER APPL command changes the attributes of an application. This is a sensitive command. ALTER [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#applname is the name of the APPL object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER APPL Command OSI/MHS SCF Commands Example This command changes the logon password for APPL object $ZMHS.#APPL1: ALTER APPL $ZMHS.
ALTER CLASS Command OSI/MHS SCF Commands ALTER CLASS Command The ALTER CLASS command changes the configuration of an MHS class. This is a sensitive command. ALTER [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#class is the name of the CLASS object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER CLASS Command OSI/MHS SCF Commands URGENT-ROUTE-RETRY-DELAY URGENT-ROUTE-RETRY-GROW URGENT-ROUTE-RETRY-TIME URGENT-TIME ASSOC-CLOSE-TIME ASSOC-OPEN-TIME CLOSE-TIME Generally, altering these attributes does not affect existing associations and queue timers—only new associations and queue timers are affected. ALTERing the xxx-ROUTE-RETRY-DELAY or the xxx-ROUTE-RETRYGROW attributes causes a recalculation of the current delay between rerouting attempts.
ALTER CUG Command OSI/MHS SCF Commands ALTER CUG Command The ALTER CUG command changes the attributes of a closed user group object. This is a sensitive command. ALTER [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#cug is the name of the CUG object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER CUGMEMBER Command OSI/MHS SCF Commands ALTER CUGMEMBER Command The ALTER CUGMEMBER command changes the attributes of a closed user group member object. This is a sensitive command. ALTER [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.cugmember [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#cug.cugmember is the name of the CUGMEMBER object to be altered.
ALTER DLIST Command OSI/MHS SCF Commands ALTER DLIST Command The ALTER DLIST command changes the attributes of a local distribution list object. This is a sensitive command. ALTER [ / OUT file-spec / ] DLIST [\psystem.]$proc.#dlist [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#dlist is the name of the DLIST object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER DLISTMEMBER Command OSI/MHS SCF Commands ALTER DLISTMEMBER Command The ALTER DLISTMEMBER command changes the attributes of a local distribution list member object. This is a sensitive command. ALTER [ / OUT file-spec / ] DLISTMEMBER [\psystem.]$proc.#dlist.dlistmember [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#dlist.dlistmember is the name of the DLISTMEMBER object to be altered.
ALTER GATEWAY Command OSI/MHS SCF Commands ALTER GATEWAY Command The ALTER GATEWAY command changes the attributes of a GATEWAY object. This is a sensitive command. ALTER [ / OUT file-spec / ] GATEWAY [\psystem.]$proc.#gateway [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#gateway is the name of the GATEWAY object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER GROUP Command OSI/MHS SCF Commands ALTER GROUP Command The ALTER GROUP command changes the attribute values associated with a group. This is a sensitive command. ALTER [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#class.[\gsystem.]group is the name of the GROUP object to be altered.
ALTER MON Command OSI/MHS SCF Commands ALTER MON Command The ALTER MON command changes the attributes of the MON object. The MON attributes can be altered when the MON object is in the STARTED state (unlike all other objects, which must be in the STOPPED state to be altered). This is a sensitive command. ALTER [ / OUT file-spec / ] MON [\psystem.]$proc [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.
ALTER MON Command OSI/MHS SCF Commands DEBUG-ON-ERR specifies whether to call ABEND or DEBUG when a fatal error occurs. This attribute should be used only by Compaq analysts in problem-solving situations. The default is OFF. EMS-PNAME specifies the collector file for EMS events. If you do not specify a process name, then no events are sent to EMS. LOG-FNAME specifies the file for log records. If you do not specify a file name, then no log records are written.
ALTER MTA Command OSI/MHS SCF Commands ALTER MTA Command The ALTER MTA command changes the configuration of an adjacent MTA. This is a sensitive command. ALTER [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#mta is the name of the MTA object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER ROUTE Command OSI/MHS SCF Commands ALTER ROUTE Command The ALTER ROUTE command changes a route in the OSI/MHS configuration. This is a sensitive command. ALTER [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#mta.route is the name of the ROUTE object to be altered. attribute-spec is a specification of an attribute and a value to be assigned to it.
ALTER SUBSYS Command OSI/MHS SCF Commands ALTER SUBSYS Command The ALTER SUBSYS command alters global configuration information for the OSI/MHS subsystem. The SUBSYS object must be in the STOPPED state when you issue this command. This is a sensitive command. ALTER [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.#subsys [ , attribute-spec ]... OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.#subsys is the name of the SUBSYS object to be altered.
DELETE Command OSI/MHS SCF Commands DELETE Command The DELETE command removes an object from the OSI/MHS subsystem configuration. You can use the DELETE command to remove the APPL, CLASS, CUG, CUGMEMBER, DLIST, DLISTMEMBER, GATEWAY, GROUP, MTA, ROUTE, and SUBSYS objects from the OSI/MHS subsystem. This is a sensitive command.
DELETE Command OSI/MHS SCF Commands NORMAL | MAX are power modifiers that you can specify only with the DELETE APPL command. NORMAL indicates that the APPL object can be deleted only if there are no messages to be retrieved by this APPL object. MAX indicates that the APPL object can be deleted regardless of the number of messages that are to be retrieved by this APPL object. Considerations • • • • • • • • • • • An object must be in the STOPPED state before you can delete it.
DELETE Command OSI/MHS SCF Commands This command deletes CUGMEMBER object $ZMHS.#CUG1.MEMBER1: DELETE CUGMEMBER $ZMHS.#CUG1.MEMBER1 This command deletes DLIST object type $ZMHS.#READERSLIST: DELETE DLIST $ZMHS.#READERSLIST This command deletes DLISTMEMBER object $ZMHS.#USERS.USER1: DELETE DLISTMEMBER $ZMHS.#USERS.USER1 This command deletes GATEWAY object $ZMHS.#TG from the OSI/MHS subsystem: DELETE GATEWAY $ZMHS.#TG This command deletes GROUP object $ZMHS.#MS.MSGRP3: DELETE GROUP $ZMHS.#MS.
INFO Command OSI/MHS SCF Commands INFO Command The INFO command displays the current attribute settings for a specified object. You can display information about the APPL, CLASS, CUG, CUGMEMBER, DLIST, DLISTMEMBER, GATEWAY, GROUP, MON, MTA, ROUTE, and SUBSYS objects. This is a nonsensitive command. INFO [ / OUT file-spec / ] [ object-spec ] [ , SUB [ ALL | NONE | ONLY ] ] [ , SEL [ NOT ] state ] [ , DETAIL ] OUT file-spec directs any SCF output generated for this command to the specified file.
INFO Command Displays OSI/MHS SCF Commands See the command syntax summary in Appendix A, OSI/MHS SCF Command Syntax Summary, to see where SUB is supported for this command. SEL [ NOT ] state directs the command only at objects in the specified state or not in the specified state. Valid values for state are: DEFINED, STARTING, STARTED, STOPPING, STOPPED, and SUSPENDED. States are described in Section 1, Introduction. DETAIL causes the command to produce a detailed display.
INFO Command Displays OSI/MHS SCF Commands Access-name is the name of the gateway or MS group for which information is being displayed. An example of the display for the INFO APPL command (where the access type is GW) without the DETAIL option is: MHS info APPL Appl GWUA0003 Access-type GW Access-name GATEWAYOBJECT An example of the display for the INFO APPL command (where the access type is GW) with the DETAIL option is: MHS Detailed info APPL GWUA0003 GENERAL ATTRIBUTES: Access-type......
INFO Command Displays OSI/MHS SCF Commands ENCODED INFORMATION TYPES: *EIT-Check........ ON OFF *EIT-IA5text...... ON OFF *EIT-TIF0......... OFF OFF *EIT-TLX.......... OFF OFF *EIT-Unspecified.. OFF OFF *EIT-Voice........ OFF OFF *EIT-Edi-fact-t61. OFF OFF *EIT-Edi-ansi-iso. OFF OFF *EIT-Edi-ansi-oct. OFF OFF *EIT-Edi-untd-iso. OFF OFF *EIT-Edi-untd-oct. OFF OFF *EIT-Edi-undf-oct. OFF DELIVERY TYPES: *Content-type-chk. ON ON *IPM84............ ON ON *Unidentified..... ON OFF *EIT-G3Fax........ *EIT-SFD..
INFO Command Displays OSI/MHS SCF Commands An example of the display for the INFO APPL command (where the access type is MS) with the DETAIL option is: MHS Detailed info APPL MSAPPL3 GENERAL ATTRIBUTES: Access-type...... MS Access-name...... \PENGUIN.MSGRP1 ORNAME ATTRIBUTES: *ISO-Country-name. *ADMD............. *PRMD............. *X121-Address..... *Terminal-ID...... *Numeric-user-ID.. *Common-name...... *Terminal-type.... *Org-Name......... *Org-Unit-1....... *Org-Unit-2....... *Org-Unit-3.......
INFO Command Displays OSI/MHS SCF Commands DELIVERY TYPES: *Content-type-chk. ON *IPM84............ ON *Unidentified..... ON *External......... ON *IPM88............ ON MS-SPECIFIC ATTRIBUTE SETTINGS: *Sub-max-msg-len.. 512000 *Dupl-suprn....... OFF *Dupl-suprn-window 0 *Set-rtvl-defaults OFF SUBMISSION CONTROL: *Sub-lowest-pri... 0 *Sub-probe-allowed OFF DELIVERY CONTROL: *Lowest-pri....... 0 *Report-allowed... ON *Sub-msg-allowed.. ON *Sub-rel-transfer. OFF *Msg-allowed......
INFO Command Displays OSI/MHS SCF Commands INFO CLASS GI Display An example of the display for the INFO CLASS GI command without the DETAIL option is: MHS info CLASS Class GI Number of sessions 1 An example of the display for the INFO CLASS GI command with the DETAIL option is: MHS Detailed info CLASS GI *Num of sessions.
INFO Command Displays OSI/MHS SCF Commands An example of the display for the INFO CLASS MR command with the DETAIL option is: MHS Detailed info CLASS MR *Cleaner-interval..1 *Check-point-Size. 2 *Safe-store-window 2 *Delay-time....... 60 *CUG-Check.........NONE *Total-Assocs..... 10 *Window-Size...... 3 *Recovery-time.... 600 *Open-retry-time.. 120 *Route-Retry-check.
INFO Command Displays OSI/MHS SCF Commands An example of the display for the INFO CLASS MS command with the DETAIL option is: MHS Detailed info CLASS MS Number of mboxes.. 100 For descriptions of the items in this display, see the attribute descriptions included in the ADD CLASS command.
INFO Command Displays OSI/MHS SCF Commands The examples above show a single entry for the ALLOWED-CONTENT-TYPE-x attribute. The number of allowed content types can vary from none to 20, depending on the configuration. INFO CUGMEMBER Display An example of the display for the INFO CUGMEMBER command without the DETAIL option is: MHS info CUGMEMBER $ZMHS.#CUG1.MEMBER1 An example of the display for the INFO CUGMEMBER command with the DETAIL option is: MHS Detailed info CUGMEMBER $ZMHS.#CUG1.
INFO Command Displays OSI/MHS SCF Commands INFO DLIST Display An example of the display for the INFO DLIST command without the DETAIL option is: MHS info DLIST DLIST $ZMHS.#DLX11S50 Number-of-members 50 An example of the display for the INFO DLIST command with the DETAIL option is: MHS Detailed info DLIST DLX11S50 GENERAL-ATTRIBUTES: *Number-of-members....... 50 *Reporting-policy........ NOTIFY-ORIG-ON-EXPANS DL ORNAME ATTRIBUTES: *DL-ISO-Country-name..... *DL-ADMD................. *DL-PRMD.............
INFO Command Displays OSI/MHS SCF Commands *OW-Terminal-type........ *OW-Org-Name............. *OW-Org-Unit-1........... *OW-Org-Unit-2........... *OW-Org-Unit-3........... *OW-Org-Unit-4........... *OW-Sur-name............. *OW-Given-name........... *OW-Initials............. *OW-Generation........... *OW-Dom-Type-1........... *OW-Dom-Value-1.......... * * * * * * * * * * * * *OW-Dom-Type-2........... * *OW-Dom-Value-2.......... * *OW-Dom-Type-3........... * *OW-Dom-Value-3.......... * *OW-Dom-Type-4...
INFO Command Displays OSI/MHS SCF Commands An example of the display for the INFO DLISTMEMBER command with the DETAIL option is: MHS Detailed info DLISTMEMBER DLX11S50.UAGW1D1002 DL MEMBER ORNAME ATTRIBUTES: *ISO-Country-name. US *ADMD............. PM1 *PRMD............. DEVELOPMENT *X121-Address..... * *Terminal-ID...... * *Numeric-user-ID.. * *Common-name...... * *Terminal-type.... * *Org-Name......... MTA1 *Org-Unit-1....... *Org-Unit-2....... *Org-Unit-3....... *Org-Unit-4....... *Sur-name.........
INFO Command Displays OSI/MHS SCF Commands For descriptions of the items in this display, see the attribute descriptions included in the ADD GATEWAY command. The GW Process Name field can display up to five GW process names. INFO GROUP GI Display A sample display for the INFO GROUP GI command with the DETAIL option is: MHS Detailed info GROUP GI.\POPI.GIGRP1 GENERAL: *CPU.............. 7 *Backup-CPU....... 14 *Priority......... 145 *PDU-Store........ \POPI.$POTC.PDB1.PDUGI1 *PDU-Log-file..... \POPI.
INFO Command Displays OSI/MHS SCF Commands INFO GROUP MR Display An example of the display for the INFO GROUP MR command without the DETAIL option is: MHS info GROUP Group MR.\SLEEPY.MRGR 0 Pri-CPU 1 Bkup-CPU 145 Priority An example of the display for the INFO GROUP MR command with the DETAIL option is: MHS Detailed info GROUP MR.\POPI.MRGRP1 GENERAL: *CPU.............. 6 *Backup-CPU....... 9 *Priority......... 145 *PDU-Store........ \POPI.$POTC.PDB1.PDUMR1 *PDU-Log-file..... \POPI.$POTC.PDB1.
INFO Command Displays OSI/MHS SCF Commands An example of the display for the INFO GROUP MS command with the DETAIL option is: MHS Detailed info GROUP MS.\HAPPY.MSGRP1 GENERAL: *CPU.............. 3 *Backup-CPU....... 2 *Priority......... 130 *PDU-Store........ \HAPPY.$DATA4.FDB4.PDUMS1 *PDU-Log-file..... \HAPPY.$DATA4.FDB4.LOGMS1 *Work-SV.......... \HAPPY.$DATA4.ZF4 MS-SPECIFIC: *MS-Process-name.. *MS-CPU........... *MS-Backup-CPU.... *MS-Priority...... *MS-subvolume..... *MR-groups........ *MR-group-name.
INFO Command Displays OSI/MHS SCF Commands An example of the display for the INFO GROUP RS command with the DETAIL option is: MHS Detailed info GROUP RS.\HAPPY.RSGRP1 GENERAL: *CPU.............. 3 *Backup-CPU....... 2 *Priority......... 130 *PDU-Store........ \HAPPY.$DATA4.FDB4.PDURS1 *PDU-Log-file..... \HAPPY.$DATA4.FDB4.LOGRS1 *Work-SV.......... \HAPPY.$DATA4.ZF4 RS-SPECIFIC: *RS-Process-name.. *RS-CPU........... *RS-Backup-CPU.... *RS-Priority...... *RS-P-Selector.... *RS-S-Selector.... *RS-T-Selector.
INFO Command Displays OSI/MHS SCF Commands INFO MTA Display An example of the display for the INFO MTA command without the DETAIL option is: MHS info MTA MTA DA US Country-code DANETMTA MTA-name An example of the display for the INFO MTA command with the DETAIL option is: MHS Detailed info MTA MTA2 *Password-server.. *Logon-validation. *Applicn-context.. *Dialogue-mode.... *Max-msg-length... *Local-init....... *Remote-init...... *Rem-P-SELECTOR-1. *Rem-S-SELECTOR-1. *Rem-T-SELECTOR-1.
INFO Command Displays OSI/MHS SCF Commands Considerations • • The password attributes and values (Our-Passw, Their-Passw, Our-Passw-Rsp, and Their-Passw-Rsp) will be shown only if the requestor (SCF or another program) is running with the same user ID as the MHSMGR process, or as user ID 255,255. If a password server process is configured for the MTA, then no password information will be displayed, whatever the user ID of the requestor.
INFO Command Displays OSI/MHS SCF Commands Considerations For the INFO ROUTE command, the following considerations apply: • • In this display, an asterisk following the attribute name indicates that an attribute value has not been defined for this object. For the X121-ADDR and the NUMERIC-USER-IDENTIFIER attributes, the symbol "**" (double asterisk) in the value indicates that the field is fully wildcarded. See ADD ROUTE and Section 1, Introduction, for more details.
INFO Command Displays OSI/MHS SCF Commands For descriptions of the items in this display, see the attribute descriptions included in the ADD SUBSYS command.
LISTOPENS Command OSI/MHS SCF Commands LISTOPENS Command The LISTOPENS command displays the names of all processes that have opened this MON object. This is a nonsensitive command. LISTOPENS [ / OUT file-spec / ] MON [\psystem.]$proc OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc is the name of the MON object for which to display information.
LISTOPENS MON Display OSI/MHS SCF Commands Backup-CPU is the backup CPU of the opener or -1 if the opener is not a nonstop process pair. Primary-File-num is the file number used in the open. Backup-File-num is the file number of the backup of the opener. ZBKUP-FNUM is 0 if the opener is not a nonstop process pair or the file does not exist on the backup CPU. Primary-PIN is the PIN of the opener. Backup-PIN is the backup PIN of the opener or 0 if the opener is not a nonstop process pair.
NAMES Command OSI/MHS SCF Commands NAMES Command The NAMES command displays the controllable object names and types for all OSI/MHS supported objects. This is a nonsensitive command. NAMES [ / OUT file-spec / ] [ object-spec ] [ , SUB [ ALL | NONE | ONLY ] ] [ , SEL [ NOT ] state ] OUT file-spec directs any SCF output generated for this command to the specified file. object-spec is the name of the object whose controllable object names and types will be displayed.
NAMES Command Displays OSI/MHS SCF Commands See the command syntax summary in Appendix A, OSI/MHS SCF Command Syntax Summary, to see where SUB is supported for this command. SEL [ NOT ] state directs the command only at objects in the specified state or not in the specified state. Valid values for state are: DEFINED, STARTING, STARTED, STOPPING, STOPPED, and SUSPENDED. States are described in Section 1, Introduction.
NAMES Command Displays OSI/MHS SCF Commands NAMES CLASS Display The format of the display for the NAMES CLASS command is: MHS names CLASS class-name CLASS class-name GROUP group-name PROCESS process-name CLASS is the class for which group and process names are to be provided. GROUP is a group within the specified class. PROCESS is a process associated with the group listed. Note. The group and process information is repeated for each group within that class.
NAMES Command Displays OSI/MHS SCF Commands NAMES CUG Display The format of the display for the NAMES CUG command is: MHS Names CUG cug-name CUG cug-name CUGMEMBER cugmember-name . . . . CUG is the name of a CUG object. CUGMEMBER is a list of CUGMEMBER object names associated with the previously displayed CUG object name. The information is repeated for each CUG object and its associated CUGMEMBER objects. An example of the display for the NAMES CUG command is: MHS Names CUG \POPI.
NAMES Command Displays OSI/MHS SCF Commands NAMES DLIST Display The format of the display for the NAMES DLIST command is: MHS Names DLIST dlist-name DLIST dlist-name DLISTMEMBER dlistmember-name . . . . DLIST is the name of a DLIST object. DLISTMEMBER is a list of DLISTMEMBER object names associated with the previously displayed DLIST object name. The information is repeated for each DLIST object and its associated DLISTMEMBER objects.
NAMES Command Displays OSI/MHS SCF Commands An example of the display for the NAMES DLIST command follows. The example has been edited because of its size. MHS Names DLIST \POPI.* DLIST DLG11R3A DLISTMEMBER DLG11R3A.DLG11R3A . . . DLIST DLX11S50 DLG11R3A.DLX11N2LEV3 DLISTMEMBER DLX11S50.UAGW1D1001 DLX11S50.UAGW1D1004 DLX11S50.UAGW1D1007 DLX11S50.UAGW1D1010 DLX11S50.UAGW1D1103 DLX11S50.UAGW1D1106 DLX11S50.UAGW1D1109 DLX11S50.UAGW1D1202 DLX11S50.UAGW1D1205 DLX11S50.UAGW1D1208 DLX11S50.UAMS1D1001 DLX11S50.
NAMES Command Displays OSI/MHS SCF Commands An example of the display for the NAMES DLISTMEMBER command is: MHS Names DLISTMEMBER \POPI.* DLISTMEMBER DLG11R3A.DLG11R3A DLG11S1.UAGW1D10 DLG11S3.UAGW1D12 DLG1XN3.UAGW2D10 DLM11N1LEV3.UAMS1D11 DLM11R3B.UAMS1D11 DLM11S5.UAMS1D12 DLX11N2LEV3.UAGW1D10 DLX11N3LEV1.UAGW1D10 DLX11N4LEV2.DLX11N2LEV3 DLX11R3C.UAMS1D12 DLX11S50.UAGW1D1003 DLX11S50.UAGW1D1006 DLX11S50.UAGW1D1009 DLX11S50.UAGW1D1102 DLX11S50.UAGW1D1105 DLX11S50.UAGW1D1108 DLX11S50.UAGW1D1201 DLX11S50.
NAMES Command Displays OSI/MHS SCF Commands NAMES GATEWAY Display The format of the display for the NAMES GATEWAY command is: MHS Names GATEWAY gateway-name GATEWAY gateway-name GATEWAY is a list of GATEWAY object names. An example of the display for the NAMES GATEWAY command is: MHS Names GATEWAY \POPI.
NAMES Command Displays OSI/MHS SCF Commands NAMES MON Display The format of the display for the NAMES MON command is: MHS Names MON mon-name MON mon-name MON is the name of the MON object. An example of the display for the NAMES MON command is: MHS Names MON \POPI.$ZP1 MON $ZP1 NAMES MTA Display The format of the display for the NAMES MTA command is: MHS Names MTA process-name MTA mta-name ROUTE route-name MTA is the MTA for which route names are to be provided.
NAMES Command Displays OSI/MHS SCF Commands NAMES PROCESS Display The format of the display for the NAMES PROCESS command is: MHS Names PROCESS process-name PROCESS process-name PROCESS is a list of PROCESS object names. An example of the display for the NAMES PROCESS command is: MHS Names PROCESS \POPI.* PROCESS \POPI.$IP11 \POPI.$LP11 \POPI.$MP31 \POPI.$PP11 \POPI.$SP11 \POPI.$IP21 \POPI.$LP21 \POPI.$MP41 \POPI.$RP11 \POPI.$SP21 \POPI.$IP31 \POPI.$LP31 \POPI.$OP11 \POPI.$RP21 \POPI.$SP31 \POPI.
NAMES Command Displays OSI/MHS SCF Commands An example of the display for the NAMES SUBSYS command is: MHS Names SUBSYS \POPI.
NAMES Command Displays OSI/MHS SCF Commands APPL is a list of the APPL objects. CLASS is the name of a CLASS object. GROUP is the name of a GROUP object for the previously displayed CLASS object. PROCESS is the name of a PROCESS object for the previously displayed CLASS object Note. The group and process information is repeated for each group within that class. MTA is the name of an MTA object. ROUTE is a list of ROUTE objects associated with the previously displayed MTA object. Note.
NAMES Command Displays OSI/MHS SCF Commands ENTRY is a list of ENTRY object names. An example of the display for the NAMES (null object type) command follows. This example has been edited because of its size. MHS Names MON \POPI.
NAMES Command Displays OSI/MHS SCF Commands CLASS MS GROUP MS.\POPI.MSGRP1 PROCESS \POPI.$IP11 GROUP MS.\POPI.MSGRP2 PROCESS \POPI.$IP21 . . . CLASS RS GROUP RS.\POPI.RSGRP1 PROCESS \POPI.$OP11 GROUP RS.\POPI.RSGRP2 PROCESS \POPI.$OP21 . . . MTA MTA2 ROUTE MTA2.ROUTE1 MTA MTA3 MTA2.ROUTE2 MTA2.ROUTE3 MTA2.ROUTE4 MTA4 ROUTE MTA4.ROUTE1 MTA4.ROUTE2 DLIST DLG11R3A DLISTMEMBER DLG11R3A.DLG11R3A . . . DLG11R3A.DLX11N2LEV3 DLG11R3A.
NAMES Command Displays OSI/MHS SCF Commands DLIST DLX11S50 DLISTMEMBER DLX11S50.UAGW1D1001 DLX11S50.UAGW1D1004 DLX11S50.UAGW1D1007 DLX11S50.UAGW1D1010 . . . DLX11S50.UAMS1D1303 DLX11S50.UAMS1D1306 DLX11S50.UAMS1D1309 DLX11S50.UAGW1D1002 DLX11S50.UAGW1D1005 DLX11S50.UAGW1D1008 DLX11S50.UAGW1D1101 DLX11S50.UAGW1D1003 DLX11S50.UAGW1D1006 DLX11S50.UAGW1D1009 DLX11S50.UAGW1D1102 DLX11S50.UAMS1D1304 DLX11S50.UAMS1D1307 DLX11S50.UAMS1D1310 DLX11S50.UAMS1D1305 DLX11S50.
PRIMARY Command OSI/MHS SCF Commands PRIMARY Command The PRIMARY command causes the backup process of the MON object to become the primary process and the primary process to become the backup process. This is a sensitive command. PRIMARY [ / OUT file-spec / ] MON [\psystem.]$proc , number OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc is the name of the MON object that is to have its primary and backup CPUs switched.
START Command OSI/MHS SCF Commands START Command The START command initiates the operation of an object. The object must be in the STOPPED state before you can issue this command. You can use the START command to initiate the operation of the APPL, CLASS, GROUP, and SUBSYS objects. This is a sensitive command. START [ / OUT file-spec / ] [ object-spec ] [ , SUB [ ALL | NONE | ONLY ] ] OUT file-spec directs any SCF output generated for this command to the specified file.
START Command OSI/MHS SCF Commands This command starts CLASS object $ZMHS.#MR: START CLASS $ZMHS.#MR This command starts GROUP object $ZMHS.#MS.MSGRP1: START GROUP $ZMHS.#MS.MSGRP1 This command starts SUBSYS object $ZMHS.#SUBSYSA: START SUBSYS $ZMHS.
STATS Command OSI/MHS SCF Commands STATS Command The STATS command displays the current statistical counters for the APPL, MON and PROCESS objects. This is a sensitive command only when the RESET option is used. STATS [ / OUT file-spec / ] [ object-spec ] [ , RESET ] [ , SEL [ NOT ] state ] OUT file-spec directs any SCF output generated for this command to the specified file. SEL [ NOT ] state directs the command only at objects in the specified state or not in the specified state.
STATS Command Displays OSI/MHS SCF Commands Examples This command displays the current statistical counters for APPL object $ZMHS.#APPL1: STATS APPL $ZMHS.#APPL1 STATS Command Displays The formats of the STATS APPL, STATS MON, and STATS PROCESS commands are shown on the following pages. STATS APPL Display The STATS APPL command is supported for MS APPLs only.
STATS Command Displays OSI/MHS SCF Commands STORED MESSAGES: reports the statistics related to messages that have been stored in the mailbox since the last reset time. Stored-reports The number of delivered reports stored in the MS APPL mailbox since the last reset. This count includes only the X400 main entries. It does not include any returned content messages that were returned with reports; these are counted under the heading Stored-ret-content.
STATS Command Displays OSI/MHS SCF Commands the actual disc space used by entries in the SQL tables and the PDUs in the PDU store and log file. It does not include space occupied by index blocks, data block headers or free space resulting from data blocks being incompletely filled. DELETED MESSAGES: reports the statistics related to messages that have been deleted from the mailbox since the last reset time.
STATS Command Displays OSI/MHS SCF Commands Deleted-disc-space The amount of disc space in bytes freed by deleting messages of all types for this MS APPL. It includes the space allocated to the PDU store, PDU logs and the various SQL tables that are used by the mailbox entries. This count records the actual disc space that was used by entries deleted from the SQL tables and the PDUs deleted from the PDU store and log file.
STATS Command Displays OSI/MHS SCF Commands An example of the display for the STATS APPL command is: MHS stats APPL MSUA0003 Reset-time.......... 31 Jul 1992, 14:52:07.035 Sample-time.......... 32 Jul 1992, 12:54:04.035 STORED MESSAGES: Stored-reports...... Stored-messages..... Stored-msg-size.... 0 5 1256 Stored-ret-content.... Stored-child-msgs..... Stored-disc-space..... 0 1 12987 DELETED MESSAGES: Deleted-reports......1 Deleted-messages... 3 Deleted-msg-size... 97438 Deleted-ret-cont.....
STATS Command Displays OSI/MHS SCF Commands EXTENDED MEMORY: Config-bytes records the total number of bytes assigned to this pool. This value is fixed when the pool is originally allocated, but may grow if the pool allocation is automatically adjusted. Curr-bytes records the total number of bytes currently allocated from the pool. If the values recorded here are consistently near one-half of the total pool size, it indicates that the pool may be overused.
STATS Command Displays OSI/MHS SCF Commands BUFFER MEMORY: is displayed only in abnormal circumstances when there is a problem obtaining memory from the extended memory pool. Config-bytes records the total number of bytes assigned to this pool. This value is fixed when the pool is originally allocated, but may grow if the pool allocation is automatically adjusted. Curr-bytes records the total number of bytes currently allocated from the pool.
STATS Command Displays OSI/MHS SCF Commands RECEIVE QUEUE: Actual-max-reqs records the maximum number at any one time since process initialization, the last backup takeover, or the last RESETSTATS. Config-max-reqs records the configured or designed upper limit. Current-requests records the current number. Reset-Time records the latest time at which process initialization, backup takeover or RESETSTATS occurred. Sample-Time records when the sample was taken.
STATS Command Displays OSI/MHS SCF Commands An example of the display for the STATS MON command is: MHS stats MON $ZF4 EXTENDED MEMORY: Config-bytes...... 387072 Curr-bytes........ 174164 Curr-frags........ 8 Fail-last-mem-req. 0 Max-bytes-alloc....384484 Max-frags......... 26 Growth-count...... 188 Reset-Time........ 22 Jan 1991, 14:04:57.608 Growth-time....... 22 Jan 1991, 14:01:40.995 Sample-Time....... 22 Jan 1991, 14:57:34.390 RECEIVE QUEUE: Actual-max-reqs... Config-max-reqs... Current-requests..
STATS Command Displays OSI/MHS SCF Commands Sessions-opened records the number of sessions opened. Sessions-closed records the number of sessions closed. Outbound-P1-relays records the number of outbound P1 pass-through MPDUs. Inbound-P1-relays records the number of inbound P1 pass-through MPDUs. Outbound-user-msgs records the number of outbound P1 user MPDUs. Inbound-user-msgs records the number of inbound P1 user MPDUs. Outbound-probes records the number of outbound P1 probe MPDUs.
STATS Command Displays OSI/MHS SCF Commands Number-OTs records the total number of object trees. Bad-transfer-in records the number of incomplete start-transfer-ins. Bad-transfer-out records the number of incomplete start-transfer-outs. MR-Group-switches records the number of forced MR group switches. Bad-received-msgs records the number of unknown messages on $RECEIVE. An example of the display for the STATS PROCESS GI command is: MHS stats PROCESS GI \POPI.$PP11: Reset-time........ Sample-time.....
STATS Command Displays OSI/MHS SCF Commands Sample-time reports when the sample was taken (when the response buffer was built). CPU reports the CPU in that the process is running, or -1 if the process is not running. Protocol-errors is the number of protocol errors that have been detected. Msgs-sent is the number of APDUs sent by the ROS. Msg-bytes-sent is the number of message bytes sent by the ROS, in kilobytes. Msgs-received is the number of APDUs received by the ROS.
STATS Command Displays OSI/MHS SCF Commands STATS PROCESS MS Display The format of the display for the STATS PROCESS MS command is: PROCESS Type MS: MHS stats PROCESS MS process-id: Reset-time........ Sample-time....... CPU............... MTA-delivered..... UAs-logged-on..... UA-cancel......... UA-fetch.......... UA-submitted...... UA-summary........ timestamp timestamp cpu-no int32 int32 int32 int32 int32 int32 MTA-reports....... UAs-logged-off.... UA-delete......... UA-list........... UA-probes.......
STATS Command Displays OSI/MHS SCF Commands UA-fetch is the number of message fetch operations performed for UAs. UA-list is the number of list operations performed for UAs. UA-submitted is the number of messages submitted by UAs by way of the MS. This count does not include the number of messages submitted by P7/API applications by way of LO groups or RS groups. UA-probes is the number of probes submitted by UAs to the MS. UA-summary is the number of summarize operations performed for UAs.
STATS Command Displays OSI/MHS SCF Commands Sample-time reports when the sample was taken (when the response buffer was built). CPU reports the CPU in which the process is running, or -1 if the process is not running. Invalid-msgs is the number of undecodable messages received by MRP from adjacent MTAs or gateways. Probes-received is the number of probes received by MRP from adjacent MTAs or gateways. Probes-sent is the number of probes sent by MRP to adjacent MTAs or gateways.
STATS Command Displays OSI/MHS SCF Commands User-submitted is the number of messages submitted by APPL objects. An example of the display for the STATS PROCESS MRP command is: MHS stats PROCESS MRP \HAP.$M41 Reset-time........ Sample-time....... CPU............... Probes-received... Reports-received.. User-msgs-received User-cancel....... User-probes....... User-submitted.... 31 Jul 1992, 14:04:45.893 31 Jul 1992, 15:07:30.111 1 Invalid-msgs...... 0 Probes-sent....... 1 Reports-sent......
STATS Command Displays OSI/MHS SCF Commands Msgs-received is the number of APDUs received by the ROS. Msg-bytes-received is the number of message bytes received by the ROS in kilobytes. Inc-assocs-open is the number of incoming associations opened. Inc-assocs-closed number of incoming associations closed. Inc-assocs-rej is the number of incoming associations rejected. An example of the display for the STATS PROCESS RS command is: MHS stats PROCESS RS \HAP.$OF43 Reset-time........ Sample-time.......
STATS Command Displays OSI/MHS SCF Commands Sample-time reports when the sample was taken (when the response buffer was built). CPU reports the CPU in which the process is running, or -1 if the process is not running. Protocol-errors is the number of protocol errors that have been detected. Msgs-sent is the number of messages sent by the RTS. Msg-bytes-sent is the number of message bytes sent by the RTS in units of 1K bytes. Msgs-received is the number of messages received by the RTS.
STATS Command Displays OSI/MHS SCF Commands Inc-assocs-fail is the number of incoming associations that have failed (and could not be recovered). Out-assocs-fail is the number of failed outgoing associations that have failed (and could not be recovered). Inc-assoc-recovs is the number of successful incoming association recoveries. Out-assoc-recovs is the number of successful outgoing association recoveries. Inc-trans-fail is the number of incoming message transfers that have failed.
STATS Command Displays OSI/MHS SCF Commands An example of the display for the STATS PROCESS RTS command is: MHS stats PROCESS RTS \HAP.$R41 Reset-time........ Sample-time....... CPU............... Msgs-sent......... Msgs-received..... Inc-assocs-open... Inc-assocs-closed. Inc-assocs-rej.... Inc-assocs-fail... Inc-assoc-recovs.. Inc-trans-fail.... Transfer-timeouts. U-ABORT........... U-EXCEPT.......... 31 Jul 1992, 14:05:35.956 31 Jul 1992, 15:07:47.640 1 Protocol errors... 0 Msg-bytes-sent....
STATS Command Displays OSI/MHS SCF Commands Largest-sweep records the largest number of PDUs in the PDU store during any sweep. Length-last-sweep records the elapsed time, in seconds, of the last sweep. Longest-sweep records the elapsed time, in seconds, of the longest sweep. Number-of-sweeps records the number of sweeps performed by the SC. An example of the display for the STATS PROCESS SC command is: MHS stats PROCESS SC \POPI.$SP11: Reset-time........ Sample-time....... CPU...............
STATUS Command OSI/MHS SCF Commands STATUS Command The STATUS command displays status information, such as the dynamic state, the last error, and modifiable values, of the specified object. You can display status information about the APPL, CLASS, ENTRY, GROUP, MON, PROCESS, and SUBSYS objects. This is a nonsensitive command.
STATUS Command Displays OSI/MHS SCF Commands STOPPING, STOPPED, and SUSPENDED. States are described in Section 1, Introduction. DETAIL causes the command to produce a detailed display. If you omit this parameter, a summary display is provided. Considerations • • A PROCESS object must be in a group that is in the STARTED state. The STATUS command displays contain timestamp fields. The time shown in these fields reflects local system time.
STATUS Command Displays OSI/MHS SCF Commands STATUS APPL Display The format of the display for the STATUS APPL command without the DETAIL option is: MHS status APPL Appl appl-id State sumstate Logged-on logstate Appl is the identifier of the APPL object. State is the current state of the APPL object. Logged-on reports whether an APPL object is logged on or logged off. This field can have the following values: LOGGED ON means the APPL object is logged on.
STATUS Command Displays OSI/MHS SCF Commands Logged-on The display is always LOGGED OFF for GW APPL objects. An example of the display for the STATUS APPL command (where the access type is GW) with the DETAIL option is: MHS Detailed status APPL UAGW11 State............. STARTED Logged-on.........
STATUS Command Displays OSI/MHS SCF Commands State is the current state of the APPL object. Logged-on reports whether an APPL object is logged on or logged off. For MS APPL objects this field can have the following values: LOGGED ON means the APPL object is logged on. LOGGED OFF means the APPL object is logged off. DEFAULT ATTRIBUTES For both default general attributes and default IPM attributes, the variable fields are blank, or show LIST, FETCH, or both LIST and FETCH.
STATUS Command Displays OSI/MHS SCF Commands • Child messages of returned content messages. These are included under the heading Child messages. Delivered messages is the number of delivered messages currently in the MS APPL mailbox. This count includes only the X400 main entries. It does not include any child messages that were returned with reports; these are counted under the heading Child messages.
STATUS Command Displays OSI/MHS SCF Commands • Unread returned content messages in which these unread child messages were delivered. These are counted under the heading Unread ret content. Size of messages is the size of messages in bytes currently in the MS APPL mailbox. This includes the envelope and content size of main entries and returned content message types. Disc space used is the size of disc space in bytes being used by this MS APPL.
STATUS Command Displays OSI/MHS SCF Commands STATUS CLASS Display The format of the display for the STATUS CLASS command without the DETAIL option is: MHS status CLASS Class class-name State sumstate integer Groups started integer Groups defined Class is the CLASS object name. State is the current state of the CLASS object. Groups started is the number of groups in the STARTED summary state. Groups defined is the number of groups that are defined.
STATUS Command Displays OSI/MHS SCF Commands Groups-starting is the number of groups in STARTING state. Groups-stopped is the number of groups in STOPPED state. Groups-stopping is the number of groups in STOPPED state. Groups-recov is the number of groups that have failed and are currently being recovered by the MHSMGR. Groups-defined is the number of groups that are defined. An example of the display for the STATUS CLASS command with the DETAIL option is: MHS Detailed status CLASS MR: State.........
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS ENTRY command without the DETAIL option is: MHS status ENTRY Entry LINKRETRY PDU-ID 576460778073255841 The format of the display for the STATUS ENTRY command with the DETAIL option is: MHS Detailed status ENTRY entry-name: Total-items....... int32 ITEM: PDU-ID............ Next-Action Time.. Start Time........ Current-delay-time Number-of-attempts MPDU-type Priority.......... MPDUID-Country.... MPDUID-ADMD.......
STATUS Command Displays OSI/MHS SCF Commands Current-delay-time indicates the current delay timer value between rerouting attempts for the message (used with the ROUTERETRY entry only). This value is expressed in seconds. Number-of-attempts indicates the number of attempts made by OSI/MHS to reroute a message (used with ROUTERETRY only). MPDU-type indicates the type of message by indicating “MESSAGE”, “PROBE”, or “REPORT” (used with ROUTERETRY only). Priority indicates the priority of the message.
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS ENTRY command with the DETAIL option is: MHS Detailed status ENTRY LINKRETRY: Total-items....... 1 ITEM: PDU-ID............ Next-Action Time.. Start-time........ Priority.......... MPDUID-Country.... MPDUID-ADMD....... MPDUID-PRMD....... MPDUID-Local-ID... Last-MTA-tried.... Group-Name........ 576460778073255841 31 Jul 1992, 16:02:59.137 29 Jul 1992, 15:01:25.
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS GROUP command without the DETAIL option is: MHS status GROUP Group MR.\LONE.MRGRP1 State STARTED The format of the display for the STATUS GROUP command with the DETAIL option is: MHS Detailed status GROUP group-name: State............. sumstate group-name is the name of the GROUP object. State is the summary state for the GROUP object.
STATUS Command Displays OSI/MHS SCF Commands Takeover is the number of times an unplanned takeover has occurred. An example of the display for the STATUS MON command without the DETAIL option is: MHS status MON Mon $ZB1 State STARTED STARTED Bkup-State 0 Takeover The format of the display for the STATUS MON command with the DETAIL option is: MHS Detailed status MON process-name State............. sumstate Backup-state...... sumstate Takeover-count.... integer TRACE: Trace-status......
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS MON command with the DETAIL option is: MHS Detailed status MON $ZB1 State............. STARTED Backup-state...... STARTED Takeover-count.... 0 TRACE: Trace-status...... OFF Trace-sel-options. Trace-file........
STATUS Command Displays OSI/MHS SCF Commands Start time is the time at which the process was last started. Fail time is the time at which the process last failed. The format of the display for the STATUS PROCESS command with the DETAIL option is: MHS Detailed status PROCESS process-name CPU............... integer Start-time........ timestamp Fail-time......... timestamp TRACE: Trace-status...... { ON | OFF } Trace-sel-options. trace-sel-list Trace-file........ filename Inc-sessions......
STATUS Command Displays OSI/MHS SCF Commands process-id is the identifier of the PROCESS GI object. CPU indicates the CPU in which the process is running. Start-time indicates the time at which the process was last started. Fail-time indicates the time at which the process last failed. Trace-status indicates whether tracing is enabled (ON) or disabled (OFF). Trace-sel-options indicates the trace options currently selected.
STATUS Command Displays OSI/MHS SCF Commands The format of the display for the STATUS PROCESS GI command without the DETAIL option is: MHS status PROCESS Process process-id CPU cpu-no. Start time timestamp Fail time timestamp Process is the identifier of the PROCESS object. CPU is the CPU in which the process is running. Start time is the time at which the process was last started. Fail time is the time at which the process last failed.
STATUS Command Displays OSI/MHS SCF Commands CPU indicates the CPU in which the process is running. Start-time indicates the time at which the process was last started. Fail-time indicates the time at which the process last failed. Trace-status indicates whether tracing is enabled (ON) or disabled (OFF). Trace-sel-options indicates the trace options currently selected. The trace options are displayed in the same form used as input to the SELECT option for the TRACE command.
STATUS Command Displays OSI/MHS SCF Commands Process is the identifier of the PROCESS object. CPU is the CPU in which the process is running. Start time is the time at which the process was last started. Fail time is the time at which the process last failed. An example of the display for the STATUS PROCESS LO command without the DETAIL option is: MHS status PROCESS Process \POPI.$LP11 CPU 6 Start time 31 Jul 1992, 14:51:42.814 Fail time 00 ??? 0000, 0:00:00.
STATUS Command Displays OSI/MHS SCF Commands process-id is the identifier of the PROCESS MRP object. CPU is the CPU in which the process is running. Start-time is the time at which the process was last started. Fail-time is the time at which the process last failed. Trace-status indicates whether tracing is enabled (ON) or disabled (OFF). Trace-sel-options indicates the trace options currently selected.
STATUS Command Displays OSI/MHS SCF Commands D-item-count is the number of items on the MTA dispatch queues for the adjacent MTA. ID-item-count is the number of items on the Imminent Dispatch queues for the adjacent MTA. AC-item-count is the number of items on the Awaiting Confirmation queue for the adjacent MTA. APPL-Name is the object identifier of the APPL object. APPL-msg-count is the number of messages on the queue for the APPL object.
STATUS Command Displays OSI/MHS SCF Commands CPU is the CPU in which the process is running. Start time is the time at which the process was last started. Fail time is the time at which the process last failed. An example of the display for the STATUS PROCESS MRP command without the DETAIL option is: MHS status PROCESS Process \POPI.$MP11 CPU 6 Start time 29 Jul 1992, 16:03:03.402 Fail time 00 ??? 0000, 0:00:00.
STATUS Command Displays OSI/MHS SCF Commands Trace-status indicates whether tracing is enabled (ON) or disabled (OFF). Trace-sel-options indicates the trace options currently selected. The trace options are displayed in the same form used as input to the SELECT option for the TRACE command. This field is blank if tracing is not enabled. Trace-file indicates the name of the file to which the trace data is being written. This field is blank if tracing is not enabled.
STATUS Command Displays OSI/MHS SCF Commands Start time is the time at which the process was last started. Fail time is the time at which the process last failed. An example of the display for the STATUS PROCESS MS command without the DETAIL option is: MHS status PROCESS Process \POPI.$IP11 CPU 14 Start time 31 Jul 1992, 15:02:11.084 Fail time 00 ??? 0000, 0:00:00.
STATUS Command Displays OSI/MHS SCF Commands Trace-sel-options indicates the trace options currently selected. The trace options are displayed in the same form used as input to the SELECT option for the TRACE command. This field is blank if tracing is not enabled. Trace-file indicates the name of the file to which the trace data is being written. This field is blank if tracing is not enabled. Inc-assocs is the number of incoming associations the RS is supporting.
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS PROCESS RS command without the DETAIL option is: MHS status PROCESS Process \POPI.$OP11 CPU 13 Start time 31 Jul 1992, 14:59:04.245 Fail time 00 ??? 0000, 0:00:00.0 STATUS PROCESS RTS Display The format of the display for the STATUS PROCESS RTS command with the DETAIL option is: MHS Detailed status PROCESS RTS process-id: GENERAL: CPU............... cpu-no Start-time........ timestamp Fail-time.........
STATUS Command Displays OSI/MHS SCF Commands Trace-status indicates whether tracing is enabled (ON) or disabled (OFF). Trace-sel-options indicates the trace options currently selected. The trace options are displayed in the same form used as input to the SELECT option for the TRACE command. This field is blank if tracing is not enabled. Trace-file indicates the name of the file to which the trace data is being written. This field is blank if tracing is not enabled.
STATUS Command Displays OSI/MHS SCF Commands Loc-T-Selector is the T-Selector part of the Compaq OSI/MHS OSI address. This identifies a Session Layer entity. Loc-NSAP is the NSAP part of the Compaq OSI/MHS OSI address. This identifies a Transport Layer entity. Direction is the direction of the association. State is the state of the association. These are defined in recommendation X.228.
STATUS Command Displays OSI/MHS SCF Commands Fail time is the time at which the process last failed. An example of the display for the STATUS PROCESS RTS command without the DETAIL option is: MHS status PROCESS Process \POPI.$RP11 CPU 6 Start time 29 Jul 1992, 16:03:03.402 Fail time 00 ??? 0000, 0:00:00.0 STATUS PROCESS SC Display The format of the display for the STATUS PROCESS SC command with the DETAIL option is: MHS Detailed status PROCESS SC process-id GENERAL: CPU...............
STATUS Command Displays OSI/MHS SCF Commands Trace-file indicates the name of the file to which the trace data is being written. This field is blank if tracing is not enabled. Next-sweep is the time at which the SC process performs its next sweep for the MR group PDU store. If the store cleaner is configured not to run (CLEANER-INTERVAL attribute is set to 0) and no CLEANER-TIMES attributes are specified, the Next-sweep timestamp field shows the value Never.
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS PROCESS SC command without the DETAIL option is: MHS status PROCESS Process \POPI.$SP11 CPU 6 Start time 29 Jul 1992, 16:03:03.402 Fail time 00 ??? 0000, 0:00:00.0 STATUS SUBSYS Display The format of the display for the STATUS SUBSYS command without the DETAIL option is: MHS status SUBSYS Subsys subsys-id State sumstate Subsys is the identifier of the SUBSYS object.
STATUS Command Displays OSI/MHS SCF Commands An example of the display for the STATUS SUBSYS command with the DETAIL option is: MHS Detailed status SUBSYS ZB1 State.............
STOP APPL Command OSI/MHS SCF Commands STOP APPL Command The STOP APPL command terminates the activity of the APPL object. Upon successful completion of the STOP command, configured objects are left in the STOPPED state. This is a sensitive command. STOP [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , SEL [ NOT ] state ] [ , { NORMAL | FORCED } ] OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.
STOP CLASS Command OSI/MHS SCF Commands STOP CLASS Command The STOP CLASS command terminates the activity of the CLASS object. Upon successful completion of the STOP command, configured objects are left in the STOPPED state. This is a sensitive command. STOP [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , SUB [ ALL | NONE | ONLY ] [ , SEL [ NOT ] state ] [ , { FORCED | MAX } ] ] OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.
STOP CLASS Command OSI/MHS SCF Commands Example This command terminates the activity of CLASS object $ZMHS.#MR: STOP CLASS $ZMHS.
STOP GROUP Command OSI/MHS SCF Commands STOP GROUP Command The STOP GROUP command terminates the activity of the GROUP object. Upon successful completion of the STOP command, configured objects are left in the STOPPED state and process objects are deleted. This is a sensitive command. STOP [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , SEL [ NOT ] state ] [ , { FORCED | MAX } ] OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.
STOP MON Command OSI/MHS SCF Commands STOP MON Command The STOP MON command terminates the activity of the MON object. Upon successful completion of the STOP command, configured objects are left in the STOPPED state, and nonconfigured objects are deleted. This is a sensitive command. STOP [ / OUT file-spec / ] MON [\psystem.]$proc OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc is the name of the MON object you want to stop.
STOP SUBSYS Command OSI/MHS SCF Commands STOP SUBSYS Command The STOP SUBSYS command terminates the activity of the SUBSYS object. Upon successful completion of the STOP command, configured objects are left in the STOPPED state, and nonconfigured objects are deleted. This is a sensitive command. STOP [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.#subsys [ , SEL [ NOT ] state ] OUT file-spec directs any SCF output generated for this command to the specified file. [\psystem.]$proc.
SUSPEND APPL Command OSI/MHS SCF Commands SUSPEND APPL Command The SUSPEND APPL command causes the APPL object to enter the SUSPENDED state. In the suspended state, the application is prevented from submitting messages and probes, and the OSI/MHS subsystem treats messages arriving for the application as being nondeliverable. Pre-existing messages can be read or deleted, however. To issue this command, the object must be in the STARTED state. This is a sensitive command.
TRACE MON Command OSI/MHS SCF Commands TRACE MON Command The TRACE MON command initiates, modifies, or stops a trace of the MHS manager. To issue this command, the object must be in the STARTED state. This is a sensitive command. An SCF trace produces a trace file that can be displayed using the commands available in the PTrace program. The trace file is created by SCP. You can find general information about the PTrace program in the PTrace Reference Manual.
TRACE MON Command OSI/MHS SCF Commands SELECT traces function calls, function parameters, and other information to record the execution path of the OSI/MHS processes. Each select-spec records data about different parts of the OSI/MHS subsystem. The syntax for the keywords and numbers is as follows: { { { { keyword } ( keyword [ , keyword ] ... ) } number } ( number [ , number ] ...
TRACE MON Command OSI/MHS SCF Commands COUNT specifies the number of trace records to be captured. It has a range of -1 through 32767. If COUNT is omitted or if COUNT equals -1, records are accumulated until the trace is stopped. When the count limit has been reached, tracing will stop.
TRACE PROCESS Command OSI/MHS SCF Commands TRACE PROCESS Command The TRACE PROCESS command initiates, modifies, or stops a trace of the process. To issue this command, the object must be in the STARTED state. This is a sensitive command. An SCF trace produces a trace file that can be displayed using the commands available in the PTrace program. The trace file is created by SCP. You can find general information about the PTrace program in the PTrace Reference Manual.
TRACE PROCESS Command OSI/MHS SCF Commands which is 8 bytes, is not included in integer. If RECSIZE is omitted or equals 0, the default value of 128 is assumed. The recommended value for RECSIZE is 4050. SELECT select-spec traces function calls, function parameters, and other information to record the execution path of the OSI/MHS processes. Each select-spec records data about different parts of the OSI/MHS subsystem.
TRACE PROCESS Command OSI/MHS SCF Commands TO file-spec specifies the file to which trace information is to be written. WRAP specifies that when the trace disk file end-of-file (EOF) is reached, trace data will wrap around to the beginning of the file and overwrite any data that is there. The default value is no wrap. COUNT specifies the number of trace records to be captured. It has a range of -1 through 32767.
VERSION Command OSI/MHS SCF Commands VERSION Command The VERSION command displays the version banner of the PROCESS and null objects. This is a nonsensitive command. VERSION [ / OUT file-spec / ] object-spec [ , DETAIL ] OUT file-spec directs any SCF output generated for this command to the specified file. object-spec The object-spec for the VERSION command is one of the following: Object Type Name Format PROCESS [\psystem.]$proc.#[\gsystem.]pname null [\psystem.
VERSION Command Displays OSI/MHS SCF Commands An example of the display for the VERSION command with the DETAIL option and for which the object type is null is: Detailed VERSION \LONE.$ZMHS SYSTEM \LONE MHS - T6990D20 - (01JUN93) - (v01) Guardian - T9050 - (N20) SCF KERNEL - T9082D20 - (01JUN93) (04MAY93) MHS PM - T6946D20 - (01JUN93) - (01JUN93) VERSION PROCESS Display An example of the display for the VERSION PROCESS command without the DETAIL option is: VERSION PROCESS \LONE.
VERSION Command Displays OSI/MHS SCF Commands OSI /MHS SCF Reference Manual—424828-001 2 -214
3 Formatting Trace Files With PTrace The PTrace (print trace) program formats data that is stored in unstructured trace files for output to terminals, printers, and disk files. Trace files contain a record of the communications between processes. You use PTrace to display and examine trace files to analyze problems. You can generate a trace file interactively or programmatically. To start the trace and capture data interactively, you use the Subsystem Control Facility (SCF) TRACE command.
Formatting Trace Files With PTrace Starting an Interactive Session OUT [ file-name ] designates the initial destination for PTrace display output for the session. This is the formatted file that you will be able to use for your problem diagnosis. If the OUT option is omitted, the output destination defaults to the output file of the TACL or SCF process through which PTrace is being initiated (usually a terminal). If the OUT option is specified and file-name is omitted, PTrace output is discarded.
PTrace Commands Formatting Trace Files With PTrace PTrace Commands There are three kinds of support for PTrace commands by the OSI/MHS subsystem: • • The OSI/MHS subsystem supports the following PTrace commands as documented in the PTrace Reference Manual: ALLOW FROM OUT TO COUNT HELP OUT STOP ENV LOG TO PAGESIZE EXIT LOG STOP RECORD FC NEXT RESET FIND OBEY SELECT The following PTrace commands have no effect on the way OSI/MHS formats trace files: DETAIL OCTAL EBCDIC SELMASK • TEST
SELECT Command Formatting Trace Files With PTrace CURRENT selects the currently defined trace-selection options. If CURRENT is specified, the previous selections are maintained and any new settings that you select are added. If CURRENT is not specified, the previous selections are discarded and a new selection will be created (based on what values you enter for the number and keyword options. number is the numeric value that a keyword represents.
SELECT Command Formatting Trace Files With PTrace Table 3-1.
DESELECT Command Formatting Trace Files With PTrace • • The SELECT command accepts all valid keywords including those that translate into bit masks; however, the confirmation text displays the 32-bit mask value only if that value is nonzero. The enumerated list of keywords (or the numeric values, if no trace file is currently open) is always displayed. DESELECT Command The DESELECT command deletes specified criteria previously selected by the SELECT command.
Getting Help Formatting Trace Files With PTrace ON enables the formatted display of trace records. When On all the content of the trace record can be displayed. OFF disables the formatted display trace records. When Off, only the first line of the trace record is displayed. Considerations • • • If the LABEL command is not used, ON is assumed. If LABEL is specified without ON or OFF, ON is assumed. The RESET and FROM commands set LABEL to ON.
Trace Record Formats Formatting Trace Files With PTrace Process Device Type Subtype MRP 55 11 MS 55 11 ROS 55 11 RTS 55 11 SC 55 11 Trace Record Formats Trace records are produced for two object types: PROCESS and MON. The trace records for these object types are shown on the following pages. MON Trace Records All of the trace records in this section are produced by OSI/MHS manager type processes.
Formatting Trace Files With PTrace MON Trace Records MHSSTATE Trace Records These record an event associated with a state change of a specified object controlled by the OSI/MHS manager process. 05/24/91 12:41:39.288000 > 001.014000 #24 MHSSTATE APPL Summary State Change. \USRSYS.$ZMHS.#APPL1 has changed from STOPPED to STARTED OPERATOR REQUEST Thread: 1 Object types can be SUBSYS, CLASS, GROUP, or APPL. State change reasons can be OPERATOR REQUEST, PROGRAM BUG, or UNKNOWN.
Formatting Trace Files With PTrace MON Trace Records ROUTEDB Trace Records These record I/O to the routing database. File names are configurable by altering the SUBSYS object. 05/24/91 11:23:47.438000 > 020.314000 #3363 ROUTEDB MHS manager I/O. File name: \USRSYS.$VOLUME.SUBVOL.RDBFILE Command: ALTER I/O type: WRITEX Error code: 0 Thread: 11 I/O type: other possible I/O types are: READX, READUPDATEX, and WRITEUPDATEX. MTADB Trace Records These record I/O to the MTA Association database.
Formatting Trace Files With PTrace MON Trace Records I/O type: other possible I/O types are: READX, READUPDATEX, and WRITEUPDATEX. DLISTDB Trace Records These record I/O to the distribution list database. File names are configurable by means of the SUBSYS object. 05/24/91 11:23:47.438000 > 020.314000 #3363 DLISTDB MHS manager I/O. File name: \USRSYS.$VOLUME.SUBVOL.
Formatting Trace Files With PTrace PROCESS Trace Records CUGSCHDB Trace Records These record I/O to the closed user group search database. File names are configurable by means of the SUBSYS object. 05/24/91 11:23:47.438000 > 020.314000 #3363 CUGSCHDB MHS manager I/O. File name: \USRSYS.$VOLUME.SUBVOL.CSFILE I/O type: WRITEX Error code: 0 Command: ADD Thread: 53 I/O type: other possible I/O types are: READX, READUPDATEX, and WRITEUPDATEX.
PROCESS Trace Records Formatting Trace Files With PTrace MHSENCODE Trace Records These record ASN.1 encoding operations performed by a process. 05/24/91 01:25:47.438000 > 023.314000 #444 MHSENCODE ENCODE OF PDUID: 0-0-12345-1-15 PDUSIZE : 1234 PROTOCOL : P1 MHSDECODE Trace Records These record ASN.1 decode operations performed by a process. 05/24/91 01:25:47.438000 > 023.
PROCESS Trace Records Formatting Trace Files With PTrace The maximum trace record size used is 4050 bytes. If necessary, the trace is split over multiple trace records. A maximum of 200 trace records is generated for a single decode. Truncation of the trace occurs if this limit is exceeded. MHSDPDUMAN Trace Records These record the decoded form of a message whenever an operation (encode or decode) is performed on that message. The maximum trace record size used is 4050 bytes.
Formatting Trace Files With PTrace PROCESS Trace Records 2 domainDefinedAttributes (SEQUENCE OF) 3 extensionAttributes (SET OF) 4 directoryName (ANY) 3 originalEncodedInformationTypes (SET) 1 builtInEncodedInformationTypes (BIT STRING) [0010]00100000 00000000 2 g3Facsimile (BIT STRING) 3 teletex (SET) 4 g4Class1AndMixedMode (ANY) 5 externalEncodedInformationTypes (SET OF) 4 contentType (CHOICE) 1 builtIn (INTEGER) 0 5 contentIdentifier (OCTET STRING) UAContentIdentif 6 priority (INTEGER) 0 7 perMessageInd
PROCESS Trace Records Formatting Trace Files With PTrace MHSEPDUMAN Trace Records These record the encoded form of a message whenever an operation (encode or decode) is performed on that message. The maximum trace record size used is 4050 bytes. If necessary, the trace is split over multiple trace records. A maximum of 200 trace records is generated for a single message. Truncation of the trace occurs if this limit is exceeded. This trace has significant performance impact on the processes being traced.
Formatting Trace Files With PTrace PROCESS Trace Records MHSIUC Trace Records These record the flow of messages between functional units within a process. INTER UNIT COMMUNICATIONS : IDUId=iduId From FU : layer layer-entity FU-Type Destination FU Type : FU-Type Destination SU : sunit Priority : priority iduId is a 32-bit number identifying the IDU in octal. layer is a number in the range 0 through 6. layer-entity is a number in the range 0 through 32767. FU-Type is a number in the range 0 through 600.
Formatting Trace Files With PTrace PROCESS Trace Records MHSILC Trace Records These record the flow of records between OSI/MHS processes. INTER LAYER COMMUNICATIONS : Function=function IDUId=iduId From FU : layer layer-entity FU-Type OPTIONAL Connection LSAP : type layer-entity mbox OPTIONAL Connection Unique Id : time uniq OPTIONAL function is either “Receive” or “Send.” iduId is a 32-bit number identifying the IDU in octal. layer is a number in the range 0 through 6.
Formatting Trace Files With PTrace PROCESS Trace Records This is another example of an MHSILC trace record: 05/24/91 01:25:47.438000 > 023.314000 #374 MHSILC INTER LAYER COMMUNICATIONS : Function=Send IDUId=2000370 From FU : 5-0-401 Connection LSAP : 3-0-0 Connection Unique Id : 619737732-1 MHSRTS Trace Records These traces record RTS and ROS events. The following RTS events are traced. These are primitives sent from the MTA to the RTS, APDUs sent between peer RTSs, and from TAPS to the RTS.
Formatting Trace Files With PTrace Event Description P-ARind Indicates resumption of activity P-ADind Indicates discard of activity P-ADcnf Confirms discard of activity P-AIind Indicates interruption of activity P-AIcnf Confirms interruption of activity P-MSind Indicates minor synchronization point P-MScnf Confirms minor synchronization point P-UEind Indicates user exception report P-PEind Indicates provider exception report PROCESS Trace Records The following ROS events are traced.
Formatting Trace Files With PTrace PROCESS Trace Records The following record traces a request to open an association. 05/24/91 01:28:93.438000 > 023.
Formatting Trace Files With PTrace PROCESS Trace Records where pdu-id components consists of the following fields: where: layer is a number from 0 through 15 entity is a number from 0-4095 identifier is a number from 0-65535 part is a number from 0-15 seq is a number from 0-134317727 Reason one of the following reasons caused the failure: RT_OPEN Timeout RT_OPEN Rejected (Busy) RT_ABORT Received RT_TRANSFER Timeout RT_TRANSFER Rejected TOTAL-ASSOCS Limit Reached Fail T
Formatting Trace Files With PTrace GIP Trace Records Local address contains the following local address components: PSEL: is the P-selector, a number between 2 and 32 hexadecimal characters SSEL: is the S-selector, a number between 2 and 32 hexadecimal characters TSEL: is the T-selector, a number between 2 and 64 hexadecimal characters NSAP: is the T-selector, a number between 2 and 40 hexadecimal characters Remote address contains the following remote address components: PSEL: is the P-selector, a
GIP Trace Records Formatting Trace Files With PTrace GWYMSG Trace Records These trace records are generated when a message is received by the GIP that the GIP supports. The possible types of GWYMSG trace records are system messages, SPI messages, and GPI messages (requests from the client process). 10/29/92 15:51:18.383218 >000.000000 #1 System Msg Received, Request = -31 GWYMSG Request the request type is documented in the Guardian Procedure Errors and Messages Manual. 10/29/92 15:52:03.622206 >011.
Formatting Trace Files With PTrace GIP Trace Records Request GPI request types are: Number Request 10 HZL-RT-EM-OPEN 21 HZL-RT-MT-START-XFER-IN 22 HZL-RT-MT-START-XFER-IN-ACK 23 HZL-RT-MT-START-XFER-IN-NAK 24 HZL-RT-MT-RECEIVE-OT 25 HZL-RT-MT-FINISH-XFER-IN 32 HZL-RT-MT-SEND-OT 33 HZL-RT-MT-XFER-OUT-ACK 34 HZL-RT-MT-XFER-OUT-NAK 40 HZL-RT-MT-WAIT 100 HZL-RT-MT-GIP-OTT GWYTROUT Trace Records These trace records are entrypoint records for specific outbound processes in the GIP.
Formatting Trace Files With PTrace GIP Trace Records Type the request type is documented in the Guardian Procedure Errors and Messages Manual. 10/29/92 15:59:10.149939 >038.682018 #1 GWYERR Unknown GPI Request Received, Type = 540 The GIP received a GPI message that it does not support. You may need to contact your Compaq representative. Type the request type is indicated. 10/29/92 15:30:36.889369 >000.000000 #1 GWYERR Awaitiox Error 1313 Occurred Awaitiox errors indicate an internal error.
A OSI/MHS SCF Command Syntax Summary ABORT APPL Command ABORT [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , SEL [ NOT ] state ] ABORT CLASS Command ABORT [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , SUB [ ALL | NONE | ONLY ] ] [ , SEL [ NOT ] state ] ABORT GROUP Command ABORT [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , SUB [ ALL | NONE | ONLY ] ] [ , SEL [ NOT ] state ] ABORT MON Command ABORT [ / OUT file-spec / ] MON [\psystem.
OSI/MHS SCF Command Syntax Summary ADD APPL Command ADD APPL Command ADD [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , attribute-spec ]... where attribute-spec is: FOR ALL APPLs: ACCESS-NAME { [\gsystem.]group-name } { [\gsystem.
ADD APPL Command OSI/MHS SCF Command Syntax Summary [ TERMINAL-TYPE { G3FACSIMILE } { G4FACSIMILE } { IA5TERMINAL } { TELEX } { TELETEX } { VIDEOTEX } [ X121-ADDR numeric-string partial-numeric-string ] ] ] Encoded information type attributes: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ DEL-CONTENT-TYPE-CHECK { ON | OFF } DEL-EDI { ON | OFF } DEL-EXTERNAL { ON | OFF } DEL-IPM84 { ON | OFF } DEL-IPM88 { ON | OFF } DEL-UNIDENTIFIED { ON | OFF } EIT-CHECK { ON | OFF } EIT-EDI-ANSIX12-EBCDIC
OSI/MHS SCF Command Syntax Summary MS group attributes: [ SUB-MAX-MSG-LEN integer ] USER-PASSWORD IA5-string [ SUB-LOWEST-PRI integer ] [ SUB-MSG-ALLOWED { ON | OFF } ] [ SUB-PROBE-ALLOWED { ON | OFF } ] [ SUB-RELIABLE-TRANSFER { ON | OFF } ] [ DEL-LOWEST-PRI integer ] [ DEL-MSG-ALLOWED { ON | OFF } ] [ DEL-REPORT-ALLOWED { ON | OFF } ] [ SET-RTVL-DEFAULTS { ON | OFF } ] Message validation attributes: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ AUTHORIZING-USERS { ON | OFF } ] AUTO-FORWARD {
ADD APPL Command OSI/MHS SCF Command Syntax Summary [ [ [ [ [ [ [ [ [ [ [ REP-DEL-ENVELOPE { ON | OFF } REPLIED-TO-IPMS { ON | OFF } REPLY-RECIPS { ON | OFF } REPLY-TIME { ON | OFF } SENSITIVITY { ON | OFF } SEQ-NO { ON | OFF } SUBJ-SUBMISSION-ID { ON | OFF } SUBJECT { ON | OFF } SUBJECT-IPM { ON | OFF } THIS-IPM { ON | OFF } THIS-RECIP-NAME { ON | OFF } ] ] ] ] ] ] ] ] ] ] ] Remote APPL OSI address attributes: [ [ [ [ APPL-NSAP hex-character-string APPL-PSELECTOR hex-character-string APPL-SSELECTOR h
ADD CLASS Command OSI/MHS SCF Command Syntax Summary ADD CLASS Command ADD [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ADD CUG Command GI class attribute: [ NUMBER-OF-SESSIONS integer ] MS class attribute: [ NUMBER-OF-MAILBOXES integer ] LO or RS class attribute: [ NUMBER-OF-ASSOCIATIONS integer ] ADD CUG Command ADD [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ADD CUGMEMBER Command ADD CUGMEMBER Command ADD [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.cugmember [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ADD DLIST Command ADD DLIST Command ADD [ / OUT file-spec / ] DLIST [\psystem.]$proc.#dlist [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ADD DLISTMEMBER Command ADD DLISTMEMBER Command ADD [ / OUT file-spec / ] DLISTMEMBER [\psystem.]$proc.#dlist.dlistmember [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ADD GATEWAY Command ADD GATEWAY Command ADD [ / OUT file-spec / ] GATEWAY [\psystem.]$proc.#gateway [ , attribute-spec ]... where attribute-spec is: [ GW-AUX-PNAME process-name ] GW-PNAME process-name...
OSI/MHS SCF Command Syntax Summary ADD GROUP Command ADD GROUP Command ADD [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , attribute-spec ]...
ADD GROUP Command OSI/MHS SCF Command Syntax Summary [ RTS-PRI integer [ SC-BACKUP cpu-number [ SC-CPU cpu-number SC-PNAME mhs-proc-name [ SC-PRI integer ] ] ] ] MS class attributes: [ MR-COUNT { integer | SYS } ] [ MR-NAME [\gsystem.]group ]...
OSI/MHS SCF Command Syntax Summary ADD MTA Command ADD MTA Command ADD [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , attribute-spec ]...
ADD MTA Command OSI/MHS SCF Command Syntax Summary [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ REM-LOGON-VALIDATION { ON | OFF } REM-MAX-MSG-LEN integer REM-MSG-OVERHEAD integer REM-MSG-THRUPUT integer REM-MTA-NAME IA5-string REM-NSAP-1 hex-character-string REM-NSAP-2 hex-character-string REM-NSAP-3 hex-character-string REM-NSAP-4 hex-character-string REM-NSAP-5 hex-character-string REM-NSAP-6 hex-character-string REM-NSAP-7 hex-character-string REM-OUR-PASSW { IA5-str
OSI/MHS SCF Command Syntax Summary ADD ROUTE Command ADD ROUTE Command ADD [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route [ , attribute-spec ]...
ADD SUBSYS Command OSI/MHS SCF Command Syntax Summary ADD SUBSYS Command ADD [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.#subsys [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary [ [ [ [ [ ACCT-UMPDU-DELIVER { ON | OFF } ] ACCT-UMPDU-RELAY { ON | OFF } ] ACCT-UMPDU-SUBMIT { ON | OFF } ] ACCT-UNROUTE-RECIP-INFO { ON | OFF } ] ACCT-UNROUTEABLE { ON | OFF } ] OSI /MHS SCF Reference Manual—424828-001 A -18 ADD SUBSYS Command
ALTER APPL Command OSI/MHS SCF Command Syntax Summary ALTER APPL Command ALTER [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , attribute-spec ]...
ALTER APPL Command OSI/MHS SCF Command Syntax Summary [ [ [ [ [ [ [ [ [ [ [ [ [ DEL-IPM88 { ON | OFF } DEL-UNIDENTIFIED { ON | OFF } EIT-CHECK { ON | OFF } ENCODED-INFO-TYPE-G3FAX { ON | OFF } ENCODED-INFO-TYPE-IA5TEXT { ON | OFF } ENCODED-INFO-TYPE-SFD { ON | OFF } ENCODED-INFO-TYPE-TIF0 { ON | OFF } ENCODED-INFO-TYPE-TIF1 { ON | OFF } ENCODED-INFO-TYPE-TLX { ON | OFF } ENCODED-INFO-TYPE-TTX { ON | OFF } ENCODED-INFO-TYPE-UNSPEC { ON | OFF } ENCODED-INFO-TYPE-VIDEOTEX { ON | OFF } ENCODED-INFO-TYPE-VOIC
ALTER APPL Command OSI/MHS SCF Command Syntax Summary [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ HEADING { ON | OFF } ] IMPORTANCE { ON | OFF } ] IPM-ENTRY-TYPE { ON | OFF } ] MSG-DEL-ENVELOPE { ON | OFF } ] MSG-DEL-ID { ON | OFF } ] MSG-DEL-TIME { ON | OFF } ] MSG-SUBMIT-TIME { ON | OFF } ] OBSOLETED-IPMS { ON | OFF } ] ORIGINATOR { ON | OFF } ] ORIGINATOR-NAME { ON | OFF } ] PARENT-SEQ-NO { ON | OFF } ] PRIMARY-RECIPS { ON | OFF } ] RECIP-REP-DEL-FIELDS { ON | OFF } ] RELATED-IPMS { ON | OFF } ]
ALTER CLASS Command OSI/MHS SCF Command Syntax Summary ALTER CLASS Command ALTER [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ALTER CUG Command ALTER CUG Command ALTER [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ALTER CUGMEMBER Command ALTER CUGMEMBER Command ALTER [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.cugmember [ , attribute-spec ]...
ALTER DLIST Command OSI/MHS SCF Command Syntax Summary ALTER DLIST Command ALTER [ / OUT file-spec / ] DLIST [\psystem.]$proc.#dlist [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary ALTER DLISTMEMBER Command ALTER DLISTMEMBER Command ALTER [ / OUT file-spec / ] DLISTMEMBER [\psystem.]$proc.#dlist.dlistmember [ , attribute-spec ]...
ALTER GATEWAY Command OSI/MHS SCF Command Syntax Summary ALTER GATEWAY Command ALTER [ / OUT file-spec / ] GATEWAY [\psystem.]$proc.#gateway [ , attribute-spec ]... where attribute-spec is: [ [ [ [ [ [ GW-AUX-PNAME process-name GW-PNAME process-name...
ALTER GROUP Command OSI/MHS SCF Command Syntax Summary ALTER GROUP Command ALTER [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , attribute-spec ]...
ALTER MON Command OSI/MHS SCF Command Syntax Summary [ [ [ [ [ RTS-PRI integer SC-BACKUP cpu-number SC-CPU cpu-number SC-PNAME mhs-proc-name SC-PRI integer ] ] ] ] ] MS class attributes: [ [ [ [ [ [ [ [ MR-COUNT { integer | SYS } ] MR-NAME [\gsystem.]group ]...
OSI/MHS SCF Command Syntax Summary ALTER MTA Command ALTER MTA Command ALTER [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , attribute-spec ]...
ALTER MTA Command OSI/MHS SCF Command Syntax Summary [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ * REM-NSAP-1 hex-character-string REM-NSAP-2 hex-character-string REM-NSAP-3 hex-character-string REM-NSAP-4 hex-character-string REM-NSAP-5 hex-character-string REM-NSAP-6 hex-character-string REM-NSAP-7 hex-character-string REM-OUR-PASSW { IA5-string | * } REM-OUR-PASSW-RSP { IA5-string | * } REM-PSELECTOR-1 [ hex-character-string REM-PSELECTOR-2 [ hex-character-string REM-PSELECTOR-
OSI/MHS SCF Command Syntax Summary ALTER ROUTE Command ALTER ROUTE Command ALTER [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route [ , attribute-spec ]...
ALTER SUBSYS Command OSI/MHS SCF Command Syntax Summary ALTER SUBSYS Command ALTER [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.#subsys [ , attribute-spec ]...
OSI/MHS SCF Command Syntax Summary DELETE APPL Command DELETE APPL Command DELETE [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , { NORMAL | MAX } ] DELETE CLASS Command DELETE [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , SUB [ ALL | NONE | ONLY ] ] DELETE CUG Command DELETE [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , SUB [ ALL | NONE | ONLY ] ] DELETE CUGMEMBER Command DELETE [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.
OSI/MHS SCF Command Syntax Summary DELETE GROUP Command DELETE GROUP Command DELETE [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , SUB [ ALL | NONE | ONLY ] ] DELETE MTA Command DELETE [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , SUB [ ALL | NONE | ONLY ] ] DELETE ROUTE Command DELETE [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route DELETE SUBSYS Command DELETE [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.
OSI/MHS SCF Command Syntax Summary INFO CUG Command INFO CUG Command INFO [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , SUB [ ALL | NONE | ONLY ] ] [ , DETAIL ] INFO CUGMEMBER Command INFO [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.cugmember [ , DETAIL ] INFO DLIST Command INFO [ / OUT file-spec / ] DLIST [\psystem.]$proc.#dlist [ , SUB [ ALL | NONE | ONLY ] ] [ , DETAIL ] INFO DLISTMEMBER Command INFO [ / OUT file-spec / ] DLISTMEMBER [\psystem.]$proc.#dlist.
OSI/MHS SCF Command Syntax Summary INFO MON Command INFO MON Command INFO [ / OUT file-spec / ] MON [\psystem.]$proc [ , DETAIL ] INFO MTA Command INFO [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , SUB [ ALL | NONE | ONLY ] ] [ , DETAIL ] INFO ROUTE Command INFO [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route [ , DETAIL ] INFO SUBSYS Command INFO [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.
OSI/MHS SCF Command Syntax Summary NAMES CUG Command NAMES CUG Command NAMES [ / OUT file-spec / ] CUG [\psystem.]$proc.#cug [ , SUB [ ALL | NONE | ONLY ] ] NAMES CUGMEMBER Command NAMES [ / OUT file-spec / ] CUGMEMBER [\psystem.]$proc.#cug.cugmember NAMES DLIST Command NAMES [ / OUT file-spec / ] DLIST [\psystem.]$proc.#dlist [ , SUB [ ALL | NONE | ONLY ] ] NAMES DLISTMEMBER Command NAMES [ / OUT file-spec / ] DLISTMEMBER [\psystem.]$proc.#dlist.
OSI/MHS SCF Command Syntax Summary NAMES MON Command NAMES MON Command NAMES [ / OUT file-spec / ] MON [\psystem.]$proc [ SEL [ NOT ] state ] NAMES MTA Command NAMES [ / OUT file-spec / ] MTA [\psystem.]$proc.#mta [ , SUB [ ONLY | ALL ] ] NAMES PROCESS Command NAMES [ / OUT file-spec / ] PROCESS [\psystem.]$proc.#[\gsystem.]pname [ SEL [ NOT ] state ] NAMES ROUTE Command NAMES [ / OUT file-spec / ] ROUTE [\psystem.]$proc.#mta.route NAMES SUBSYS Command NAMES [ / OUT file-spec / ] SUBSYS [\psystem.
OSI/MHS SCF Command Syntax Summary START APPL Command START APPL Command START [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname START CLASS Command START [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , SUB [ ALL | NONE | ONLY ] ] START GROUP Command START [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.]group [ , SUB [ ALL | NONE | ONLY ] ] START SUBSYS Command START [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.
OSI/MHS SCF Command Syntax Summary STATUS APPL Command STATUS APPL Command STATUS [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ SEL [ NOT ] state ] [ , DETAIL ] STATUS CLASS Command STATUS [ / OUT file-spec / ] CLASS [\psystem.]$proc.#class [ , SUB [ ALL | NONE | ONLY ] ] [ SEL [ NOT ] state ] [ , DETAIL ] STATUS ENTRY Command STATUS [ / OUT file-spec / ] ENTRY [\psystem.]$proc.#entry [ , DETAIL ] STATUS GROUP Command STATUS [ / OUT file-spec / ] GROUP [\psystem.]$proc.#class.[\gsystem.
OSI/MHS SCF Command Syntax Summary STATUS SUBSYS Command STATUS SUBSYS Command STATUS [ / OUT file-spec / ] SUBSYS [\psystem.]$proc.#subsys [ SEL [ NOT ] state ] [ , DETAIL ] STOP APPL Command STOP [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , SEL [ NOT ] state ] [ , { NORMAL | FORCED } ] STOP CLASS Command STOP [ / OUT file-spec / ] CLASS [\psystem.]$proc.
SUSPEND APPL Command OSI/MHS SCF Command Syntax Summary SUSPEND APPL Command SUSPEND [ / OUT file-spec / ] APPL [\psystem.]$proc.#applname [ , { NORMAL | FORCED } ] TRACE MON Command TRACE [ / OUT file-spec / ] MON [\psystem.]$proc { , STOP { [ , PAGES integer [ , NOCOLL [ , RECSIZE integer [ , SELECT select-spec [ , TO file-spec [ , WRAP [ , COUNT integer } ] ] ] ] ] ] ] } where select-spec is: { keyword { keyword [ , keyword ]... { number { number [ , number ]...
TRACE PROCESS Command OSI/MHS SCF Command Syntax Summary TRACE PROCESS Command TRACE [ / OUT file-spec / ] PROCESS [\psystem.]$proc.#[\gsystem.]pname { , STOP { [ , PAGES integer [ , NOCOLL [ , RECSIZE integer [ , SELECT select-spec [ , TO file-spec [ , WRAP [ , COUNT integer } ] ] ] ] ] ] ] } where select-spec is: { keyword { keyword [ , keyword ]... { number { number [ , number ]...
OSI/MHS SCF Command Syntax Summary OSI /MHS SCF Reference Manual—424828-001 A -45 VERSION null PROCESS
OSI/MHS SCF Command Syntax Summary OSI /MHS SCF Reference Manual—424828-001 A -46 VERSION null PROCESS
B OSI/MHS SCF Error Messages This appendix lists and describes the OSI/MHS SCF error messages. MHS E00001 MHS E00001 Command cannot be completed because of network state Cause. The network is not available for the implementation of this command. This error can occur when a group is started on a remote node that is unavailable. Recovery. Determine and correct the network problem before retrying the command. MHS E00002 MHS E00002 Cannot delete object-name APPL - messages in mailbox Cause.
OSI/MHS SCF Error Messages Recovery. Use another process name, or delete the group that is using the process name. MHS E00006 MHS E00006 Cannot delete object-name - APPLs attached Cause. When deleting a gateway or a group, an attempt was made to delete an object for which APPL objects are attached. That is, APPL objects are defined as using that gateway or group object for message submission and delivery. Recovery. Delete the APPL objects. APPL objects cannot be reassigned to a new group or gateway.
OSI/MHS SCF Error Messages MHS E00010 MHS E00010 Duplicate OSI address: OSI-address Cause. The following situations can cause this error: • • In a command used to add or alter an MTA, an OSI address was specified that is used by another MTA. In a command used to add or alter a group, an OSI address was specified that is used by a group of a different type. Recovery. Retry the command, using a different OSI address. MHS E00011 MHS E00011 System name must be same as OSI/MHS manager's Cause.
OSI/MHS SCF Error Messages MHS E00014 MHS E00014 Invalid O/R name specified for object-name Cause. An attempt was made to specify an O/R name for a DLIST or DLISTMEMBER object which does not conform to a valid Mnemonic, Numeric, or Terminal O/R name form defined in X.402 (1988). Recovery. Retry the command, using a valid O/R name. MHS E00015 MHS E00015 APPL OSI address specified but no MS Bind PW SVR configured Cause.
OSI/MHS SCF Error Messages MHS E00018 MHS E00018 Cannot specify MS APPL attributes when altering a GW APPL Cause. An ALTER APPL command for the GW access type contains some attributes that apply only to an MS APPL. Recovery. Make sure that the APPL object being altered is the correct one. If so, omit any MS APPL object attributes from the ALTER command, and retry the command. MHS E00019 MHS E00019 Duplicate gateway process names Cause.
OSI/MHS SCF Error Messages Recovery. Ask the user agent to remove the appropriate attribute from its list-and-fetchattribute default set (using the X.400 P7 operation “register-ms”), or set the SET-RTVLDEFAULTS attribute to ON using the ALTER command. MHS E00023 MHS E00023 Command cannot be performed on process whose group is in summary-state state for object-name Cause. An attempt was made to use the TRACE PROCESS command when the GROUP object to which the process belongs was in a STARTING state.
OSI/MHS SCF Error Messages MHS E00027 MHS E00027 Invalid wildcarded O/R name attribute entered Cause. When adding or altering an APPL or ROUTE object, either the X.121 address or the numeric user identifier contained invalid characters. Check for one of the following conditions: • • • Characters other than 0 through 9 and asterisk (*) in the string An asterisk that is not at the end of the string More than one asterisk in the string Recovery. Retry the command, specifying valid characters.
OSI/MHS SCF Error Messages Recovery. Write down the command sequence executed and the specific error message received, or send the commands and responses to a log. Provide this information to your Compaq representative. MHS E00202 MHS E00202 Missing attribute Cause. This error occurs when a required attribute is omitted from the command. Recovery. Retry the command making sure all required attributes are specified. MHS E00203 MHS E00203 Duplicate attribute: attribute-name Cause.
OSI/MHS SCF Error Messages Recovery. Provide a valid class type (GI, LO, MS, MR, or RS) and reissue the command. MHS E00208 MHS E00208 Attribute ACCESS-TYPE or ACCESS-NAME cannot be altered Cause. This error occurs when the attribute ACCESS-TYPE or ACCESS-NAME is altered. Recovery. Reissue the command without the attributes ACCESS-TYPE or ACCESSNAME. MHS E00209 MHS E00209 Attribute-spec cannot be altered: attribute-name Cause. This error occurs when a nonalterable attribute specification is altered.
OSI/MHS SCF Error Messages Recovery. Provide a valid number of GW-PNAME attributes and reissue the command. MHS E00215 MHS E00215 Unrecognized return code: integer Cause. This error occurs when an unrecognized return code value exists in a datalist. Recovery. Check the value for validity. Check to see if the current version supports the error. MHS E00216 MHS E00216 Invalid value entered for token: token-number Cause. A token had an invalid value in it. Recovery.
OSI/MHS SCF Error Messages • When specifying the ACCESS-TYPE attribute as GW, the ACCESS-NAME must be specified as [\gsystem.]gateway-name. MHS E00220 MHS E00220 Invalid node name Cause. An invalid node name has been specified. Recovery. Retry the command specifying the MHS manager’s node name. MHS E00221 MHS E00221 Cannot enter REM-THEIR-PASSW or REM-THEIR-PASSW-RSP unless REM-LOGON-VALIDATION is specified as ON Cause.
OSI/MHS SCF Error Messages • • • With the PASSW-SERVER attribute set to ON, an attempt was made to set REMLOGON-VALIDATION to ON. With the PASSW-SERVER attribute set to ON, an attempt was made to specify REM-OUR-PASSW, REM-OUR-PASSW-RSP, REM-THEIR-PASSW, or REMTHEIR-PASSW-RSP. An attempt was made to enter an ALTER MTA command using the REM-OURPASSW, REM-OUR-PASSW-RSP, REM-THEIR-PASSW, or REM-THEIRPASSW-RSP attribute, and the PASSW-SERVER attribute was not specified. Recovery.
OSI/MHS SCF Error Messages reason can be one of the following: Reason Meaning -32757 the file specified in COLLECTOR-x could not be used (where x is a value from 1 through 4) -32762 the file specified in MSG-FNAME could not be used -32763 the file specified in EMS-PNAME could not be used -32764 the file specified in LOG-FNAME could not be used FS-error is the file system error returned. Recovery. Provide a valid file or process name and retry the command.
OSI/MHS SCF Error Messages OSI /MHS SCF Reference Manual—424828-001 B -14
Glossary The following glossary defines terms used in this manual and in other Compaq OSI/MHS manuals. Both industry-standard terms and Compaq terms are included. This list covers Compaq OSI/MHS as a whole; therefore, not all terms given here are used in this particular manual. abstract syntax. A representation of the way in which components of information are to be specified in a communication.
archive queue Glossary archive queue. A queue to which you can move an object from the input queue during a finish-transfer-in operation requested of the GPI. Typically, undecodable communications are placed on the archive queue for future examination using diagnostic procedures. See also communication. ASE (application service element).
attribute value Glossary attribute value. The data for specific instance of an attribute. For example, “US” is a possible value of an MH-T-COUNTRY-NAME attribute. BER (Basic Encoding Rules). The standard for an associated transfer syntax (CCITT Recommendation X.209). These rules were defined to provide a transfer syntax for use by ASN.1 compilers. bind. The act of establishing a connection.
command message Glossary command message. An SPI message, containing a command, sent from an application program to a subsystem. See also response message or event message. command/response interface. In DSM, a management interface that performs operations on subsystem-defined objects. common definition. In DSM programmatic interfaces, a definition (data declaration) used in several commands, responses, or event messages in an SPI interface to a subsystem. common name. In X.
context token Glossary context token. In DSM programmatic interfaces, a token in an SPI response message that indicates (by its presence or absence) whether or not the response is continued in the following message. control and inquiry. In DSM, those operations that affect or request information about the state or configuration of an object. See also event management. core services.
definition Glossary definition. A declaration provided by Compaq for use in applications that use a specific procedural interface, such as the APS or SPI procedures. Definitions are commonly provided in definition files. definition files. A set of files containing declarations for use in applications that use a specific procedural interface.
element Glossary element. See string element. element of service. In OSI, a feature or function defined as part of a service. empty response record. In DSM programmatic interfaces, a response record containing only a return token with a value that means “no more response records.” EMS (Event Management Service). A part of DSM used to provide event collection, event logging, and event distribution facilities.
event Glossary information about the error. A response record must contain a return token and can also contain error lists to explain the error further. event. In DSM, a significant change in some condition in the system or network. Events can be operational errors, notifications of limits exceeded, requests for action needed, and so on. event log. A file or set of files maintained by EMS to store event messages generated by subsystems. event management.
external tracing Glossary external tracing. The recording of actions taken by a management domain with respect to a message, probe, or report. See also internal tracing. extensible structured token. In DSM programmatic interfaces, a token consisting of a token code and a value that is an extensible structure. Extensible structures can be extended by adding new fields at the end.
GPI (Gateway Programmatic Interface) Glossary GPI (Gateway Programmatic Interface). A service that provides X.400 access to proprietary messaging systems through Compaq OSI/MHS. GPI library. The GPI procedural interface. GPI service. The combined function of the GPI library and the GIP. group. A collection of one or more processes and databases that provide a defined set of services. GROUP object.
installation procedure Glossary installation procedure. The OSI/MHS procedure that creates a default edit file and prompts you to modify that file to fit your configuration requirements. installation subvolume. See ISV. interactive command. In DSM, a command given by a human operator rather than by a program. See also programmatic command. interface. In general, a set of rules by which a person, a program, or a device interacts with a hardware or software product.
layer Glossary layer. A grouping of related functions in the OSI Reference Model. See Application Layer, Data Link Layer, Network Layer, Physical Layer, Presentation Layer, Session Layer, or Transport Layer. link. A physical and logical path between two adjacent computers or other devices. In OSI/MHS, a pair of OSI addresses that are configured for each MTA. A pair of OSI addresses is a set of local and remote address definitions in the MTA object representing an adjacent MTA. link retry.
mailbox count Glossary mailbox count. A “snapshot” of the recent activity in your mailbox: number of messages read, number of messages deleted, and so on. mailbox statistics. A historical report of the activity in your mailbox, starting with the previous RESET and continuing until the next RESET. management application. In DSM, an application process that opens a management or subsystem process to control a subsystem.
Glossary MIB (management information base) MIB (management information base). A database used by the OSI manager to store and retrieve configuration information and information about applications. mnemonic O/R address. An O/R address that identifies a user by terms that are easily remembered. See also numeric O/R address. MON object. An object type, used in OSI/MHS management interfaces, that enables you to address commands to the MHS manager. The MON object name identifies the MHS manager.
MTA object Glossary MTA object. An object type, used in OSI/MHS management interfaces, that defines adjacent MTAs and their attributes to the OSI/MHS subsystem. MTA process. See MRP. MTS (message transfer system). The part of a message handling system that contains the MTAs and that permits communication between user agents. MTS identifier. A unique identifier that distinguishes a communication from all other communications ever conveyed by the MTS within the MHS. multithreaded process.
nonsensitive command Glossary nonsensitive command. A DSM command that can be issued by any user or program having access to the target subsystem—that is, a command on which the subsystem imposes no further security restrictions. For Compaq data communications subsystems, the nonsensitive commands are usually information commands (commands that cannot change the state or configuration of objects). See also sensitive command. NonStop Kernel.
object management Glossary In the GPI, a unique identifier of a particular object generated by the GPI service when the client program creates a new object, copies an object, or reserves an object. The client program passes the object identifier to any GPI procedure operating on the object. A GPI object identifier is not related to an ASN.1 object identifier. object management. A means to operate on messages and their elements as objects. object-name template.
Glossary OSI/MHS (Open Systems Interconnection/Message Handling System) OSI/MHS (Open Systems Interconnection/Message Handling System). The Compaq implementation of an X.400 message handling system for Compaq NonStop systems. OSI/MHS database. The database that consists of the registration database and OSI/MHS configuration database. OSI/MHS ISV. The installation subvolume for the OSI/MHS release. The Install process creates this subvolume as ZOSIMHS. OSI/MHS subsystem.
P2 message Glossary P2 message. An X.400 message that consists of a heading followed by a series of data blocks, called body parts. The heading contains the message originator, recipients, and other service information. Each body part can contain a different form of data, and messages can be nested within body parts. P3 protocol. The X.400 message submission and delivery protocol, which defines a standard for the submission and delivery of messages and the interaction of UAs and MTAs. P7 protocol. The X.
Physical Layer Glossary Physical Layer. Layer 1 in the OSI Reference Model. This layer establishes the actual physical connection between the network and the computer equipment. Protocols at the Physical Layer include rules for the transmission of bits across the physical medium and rules for connectors and wiring. port address. For X25AM lines, the logical port number used to specify the address of the connection to the X.25 network.
programmatic command Glossary programmatic command. In DSM, a command issued by a program rather than by a human operator. See also interactive command. programmatic interface. A mechanism by which a program can interact with other software. programmed operator. In DSM, a management application that performs functions that might otherwise be performed by a human operator. protocol.
remote MTA Glossary remote MTA. An adjacent or nonadjacent MTA. Any MTA other than your local OSI/MHS subsystem. Remote Operations Service. See ROSE. remote system. In Compaq terms, any system within an Expand network that is not the local system. remote user agent. See RUA. report. A notification generated by the OSI/MHS subsystem that tells the user whether the message has been sent. request primitive. In OSI, a primitive issued when a service user wants the service to do some work.
ROSE (remote operations service element) Glossary ROSE (remote operations service element). An Application Layer service definition and protocol supporting interactive applications, implemented by the RS process in OSI/MHS. Examples of ROSE PDUs are: ROIV-APDU Invoke application protocol data unit RORJ-PDU Reject application protocol data unit ROER-APDU Error application protocol data unit RORS-APDU Response application protocol data unit route. A path through an X.
RTS (reliable transfer service) process Glossary RTS (reliable transfer service) process. A process in the MR group that implements the RTSE protocol and accesses the PDU store to read and write messages. RUA (remote user agent). A user agent that submits and retrieves messages through a message store and resides on a system or device other than the system that provides the message store. See also LUA. SAP (service access point).
service Glossary service. A set of primitives (operations) that an OSI layer provides to the layer above it. The service defines what operations the layer can perform on behalf of its users, but not how these operations are implemented. A service relates to an interface between two layers, with the lower layer being the service provider and the upper layer being the service user. See also protocol. The GPI and P7 API are examples of services available to applications.
softdoc Glossary softdoc. A text file in EDIT-file (code 101) format that is part of a software product version or an interim product modification (IPM) in the same subvolume. A softdoc provides information about new product features and sometimes contains information not included in product manuals. SPI (Subsystem Programmatic Interface).
string segment Glossary string segment. A portion of a string value consisting of zero or more contiguous octets of its representation. subject. In event management, a device, process, or other named entity about which a given event message has information. subnetwork. In general, a network that participates in a larger network, possibly through the use of gateways or bridges. In OSI, one or more intermediate systems that provide relaying and through which end systems may establish network connections.
symbolic name Glossary names of which appear on the last part of the packing list. The SUT contains the DSVs for OSI/MHS and other products. symbolic name. In DSM programmatic interfaces, a name used in programs to refer to commonly used values, token codes, token maps, extensible structures, and other related variables for use in management programs. syntax. See attribute syntax. SYSGEN.
token code Glossary the SSGET procedure. A token has two parts: an identifying code, or token code, and a token value. In command and response messages, a token normally represents a parameter to a command, an item of information in a response, or control information for the subsystem. In event messages, a token normally represents an item of information about an event or about the event message itself. See also header token. token code.
TSAP (transport service access point) Glossary TSAP (transport service access point). A logical location between the Transport and Session Layers, through which transport services are made available to local users, and through which session services are made available to remote systems. TSEL (transport selector). An address between the Transport and Session Layers, through which connections are established and maintained.
working subvolume Glossary characters can appear: ? for a single character and * for zero, one, or more consecutive characters. In O/R name attributes, a single asterisk in place of the attribute indicates “not used.” In the X121-ADDR and NUMERIC-USER-ID attributes of the ADD APPL, ALTER APPL, ADD ROUTE, and ALTER ROUTE commands, a single asterisk (*) can substitute for the trailing characters of the attribute value, and the double asterisk (**) can substitute for the entire value.
$RECEIVE Glossary OSI /MHS SCF Reference Manual—424828-001 Glossary -32
Index A A non-existent…OSI address (error E00223) B-11 A required token is present… (error E00217) B-10 Abbreviations Abbreviations-1 ABORT command examples 2-7 syntax and considerations 2-6/2-7 Abstract syntax identifiers See REM-ABS-SYNTAX-ID attribute ACCESS-NAME attribute 2-9 ACCESS-NAME attribute error (error E00208) B-9 Access-name field 2-105 ACCESS-NAME invalid error E00013 B-3 error E00219 B-10 ACCESS-TYPE attribute 2-10 ACCESS-TYPE attribute error (error E00208) B-9 Access-type field 2-104 ACCESS-
A Index ADD CLASS command (continued) MR class 2-28/2-35 MS class 2-35 considerations and examples 2-35 general syntax 2-28 ADD command See also individual command-object combinations ADD CUG command 2-37/2-38 ADD CUGMEMBER command attributes 2-39/2-41 considerations and examples 2-41/2-42 syntax 2-39 ADD DLIST command attributes 2-43/2-48 considerations and example 2-48 syntax 2-43 ADD DLISTMEMBER command attributes 2-49/2-51 considerations and example 2-51/2-52 syntax 2-49 ADD GATEWAY command 2-53/2-55
B Index APPL field 2-137 Appl field 2-104, 2-127, 2-168 APPL objects commands for ABORT 2-6/2-7 ACTIVATE 2-8 ADD 2-9/2-27 ALTER 2-85/2-86 DELETE 2-100/2-102 INFO 2-103/2-104, 2-104/2-108 NAMES 2-126/2-127, 2-127 START 2-142/2-143 STATUS 2-166/2-167, 2-168/2-172 STOP 2-199 SUSPEND 2-205 general description 1-5 hierarchy of objects 1-4/1-5 messages for cannot alter message retrieval (error E00022) B-5 cannot delete APPL object… (error E00002) B-1 cannot enter MS attributes… (error E00218) B-10 cannot specif
C Index BACKUP-DEBUG attribute 2-95 Backup-File-num field 2-125 Backup-PIN field 2-125 Backup-state field 2-179 Bad-received-msgs field 2-155 Bad-transfer-in field 2-155 Bad-transfer-out field 2-155 BIL-DEF-BODY-PART attribute 2-21 Bkup-State field 2-178 BLIND-COPY-RECIPS attribute 2-21 BODY attribute 2-21 BUFFER MEMORY fields 2-151 C Canceling See ABORT command, DELETE command, STOP command Cannot alter APPL message… (error E00022) B-5 Cannot assign file-name as…(error E32765) B-12 Cannot delete APPL ob
C Index Common names See COMMON-NAME attribute, DLCOMMON-NAME attribute, OWCOMMON-NAME attribute COMMON-NAME attribute 2-11, 2-40, 2-50, 2-76 Configuration and control components 1-1 Config-bytes field 2-150, 2-151 Config-max-openers field 2-152 Config-max-reqs field 2-152 CONFIRM option, SCF 1-13 Connections See DELAY-TIME attribute CONTENT attribute 2-21 Content types See DEL-xxx attributes CONTENT-ID attribute 2-21 CONTENT-LENGTH attribute 2-21 CONTENT-TYPE attribute 2-21 CONTENT-TYPE-CHECK attribute 2
D Index D Data packets size of See CHECK-POINT-SIZE attribute to be sent See SAFE-STORE-WINDOW attribute, WINDOW-SIZE attribute DEBUG-ON-ERR attribute 2-96 DEFAULT ATTRIBUTES fields 2-170 DEFERRED ENTRY type 1-6 DEFINED object state 1-15 DELAY-TIME attribute 2-30 DELETE command 2-100/2-102 DELETED MESSAGES fields 2-147 Delivered messages field 2-171 Delivered reports field 2-170 Delivery-control attributes 2-18 DEL-CONTENT-TYPE-CHECK attribute 2-12 DEL-EDI attribute 2-13 DEL-EXTERNAL attribute 2-13 DEL-IP
E Index DL-INITIALS attribute 2-44 DL-ISO-COUNTRY-NAME attribute 2-44 DL-MEMBER-FNAME attribute 2-80 DL-NUMERIC-USER-IDENTIFIER attribute 2-45 DL-ORG-NAME attribute 2-45 DL-ORG-UNIT-(1-4) attribute 2-45 DL-PRMD attribute 2-45 DL-SUR-NAME attribute 2-45 DL-TERMINAL-ID attribute 2-45 DL-TERMINAL-TYPE attribute 2-45 DL-X121-ADDR attribute 2-45 Domain defined attributes See DOM-TYPE-(1-4) attribute, DOMVALUE-(1-4) attribute, DL-DOMTYPE-(1-4) attribute, DL-DOMVALUE-(1-4) attribute Domain names See ADMD attribu
F Index Establishing See ACTIVATE command, START command Event messages, SCF CONFIRM option 1-13 EXPIRY-TIME attribute 2-21 EXTENDED MEMORY fields 2-150 EXTERNAL content type See DEL-EXTERNAL attribute F Fail time field 2-180 Fail Time trace field 3-22 Fail-last-mem-req field 2-150, 2-151 file-name syntax variable 2-3 First names See GIVEN-NAME attribute, DLGIVEN-NAME attribute, OW-GIVENNAME attribute function trace field 3-18 FU-item-count field 2-186 FU-Name field 2-186 FU-Type trace field 3-17, 3-18
H Index GROUP objects (continued) START 2-142/2-143 STATUS 2-166/2-167, 2-177/2-178 STOP 2-202 general description 1-7 hierarchy of objects 1-4/1-5 messages for cannot delete (error E00006) B-2 non-unique primary/backup CPU… (error E00021) B-5 priority must be lower than… (error E00017) B-4 name format 1-2/1-4 Groups, defining See CLASS objects Groups-defined field 2-173, 2-174 Groups-recov field 2-174 Groups-starting field 2-174 Groups-stopped field 2-174 Groups-stopping field 2-174 Group-Name field 2-17
K Index Inc-assocs field 2-184, 2-191, 2-193 Inc-assocs-closed field 2-156, 2-161, 2-162 Inc-assocs-fail field 2-163 Inc-assocs-open field 2-156, 2-161, 2-162 Inc-assocs-rej field 2-156, 2-161, 2-162 Inc-assoc-recovs field 2-163 Inc-sessions field 2-182 Inc-trans-fail field 2-163 INFO command INFO APPL considerations 2-108 INFO CLASS MR considerations 2-110 INFO MTA considerations 2-121 syntax and example 2-103/2-104 INFO command displays display notation 2-104 INFO APPL 2-104/2-108 INFO CLASS 2-109/2-111
M Index LINKRETRY ENTRY type 1-6 LINK-RETRY-DELAY attribute 2-30 LINK-RETRY-TIME attribute 2-30 LINK/ROUTE RETRY trace field 3-21 LISTOPENS MON command 2-124/2-125 List-and-fetch-attribute defaults 2-19 LO access-type attributes 2-35 LO (local operations) class type 1-5 Local address trace field 3-23 Local distribution lists, defining See DLIST objects Local operations (LO) class type 1-5 Loc-NSAP field 2-194 LOC-NSAP-(1-7) attribute 2-69 LOC-PSELECTOR-(1-7) attribute 2-69 Loc-P-Selector field 2-193 LOC-S
M Index MHSDPDUMAN PTrace SELECT command 3-5 TRACE keyword 2-210 trace records 3-14/3-15 MHSENCODE PTrace SELECT keyword 3-5 TRACE keyword 2-210 trace records 3-13 MHSEPDUMAN PTrace SELECT keyword 3-5 TRACE keyword 2-210 trace records 3-16 MHSIDU PTrace SELECT keyword 3-4 TRACE keyword 2-210 trace records 3-12 MHSILC PTrace SELECT keyword 3-5 TRACE keyword 2-210 trace records 3-18/3-19 MHSIUC TRACE keyword 2-210 trace records 3-17 MHSRETRY PTrace SELECT keyword 3-5 TRACE keyword 2-210 trace records 3-21/3
N Index MR-NAME attribute description 2-62 invalid match (error E00212) B-9 MR-NSAP attribute 2-59 MR-P-SELECTOR attribute 2-59 MR-S-SELECTOR attribute 2-59 MR-TRANSMIT-MODE attribute 2-60 MR-T-SELECTOR attribute 2-59 MS access-type attributes 2-17/2-25, 2-35 MS Bind password server error (error E00016) B-4 MS (message store) access type 1-5 MS (message store) class type 1-6 Msgs-received field 2-156, 2-161, 2-162 Msgs-sent field 2-156, 2-160, 2-162 Msg-bytes-received field 2-156, 2-161, 2-162 Msg-bytes-s
O Index Next-Action Time field 2-175 Next-sweep field 2-196 No parent configured… (error E00007) B-2 NOCOLL modifier, TRACE command 2-206 Node name invalid (error E00220) B-11 Node-name field 2-124 Nonsensitive commands 2-3 NONURGENT-COUNT attribute 2-30 NONURGENT-ROUTE-RETRY-DELAY attribute 2-31 NONURGENT-ROUTE-RETRY-GROW attribute 2-31 NONURGENT-ROUTE-RETRY-TIME attribute 2-31 NONURGENT-TIME attribute 2-31 Non-unique primary/backup CPU… (error E00021) B-5 NORMAL-COUNT attribute 2-31 NORMAL-ROUTE-RETRY-D
P Index Opening See ACTIVATE command, START command OPEN-RETRY-TIME attribute 2-32 Organizational names See ORG-NAME attribute, ORG-UNIT(1-4) attribute, DL-ORG-NAME attribute, DL-ORG-UNIT-(1-4) attribute, OW-ORG-UNIT-(1-4) attribute Organizational unit name 2-41 ORG-NAME attribute 2-11, 2-41, 2-51, 2-77 ORG-UNIT-(1-4) attribute 2-12, 2-41, 2-51, 2-77 ORIGINATOR attribute 2-22 ORIGINATOR-NAME attribute 2-22 OSI address duplicate (error E00010) B-3 non-existent (error E00223) B-11 OSI address attribute erro
P Index PDU-LOG-FILE attribute 2-57 PDU-STORE attribute 2-57 Personal name set See DL-SUR-NAME attribute, OWGIVEN-NAME attribute, OWINITIALS attribute, OW-SUR-NAME attribute See GIVEN-NAME attribute, INITIALS attribute, SUR-NAME attribute, DLGIVEN-NAME attribute, DL-INITIALS attribute pname object name format 1-4 Pname-qualifs field 2-124 Power modifiers DELETE command 2-101 STOP APPL command 2-199 STOP CLASS command 2-200 STOP GROUP command 2-202 SUSPEND command 2-205 PRI attribute 2-57, 2-77 PRIMARY MON
Q Index PROCESS objects (continued) VERSION command displays 2-213 Processes running at low/high PIN 1-16 process-id field 2-182 process-name duplicate (error E00005) B-1 Process-name field 2-124 process-name field 2-179 process-name syntax variable 2-4 PROCIO PTrace SELECT keyword 3-4 TRACE keyword 2-207 trace records 3-9 Protocol-errors field 2-156, 2-160, 2-162 psystem object name format 1-2 PTrace utility commands DESELECT 3-6 LABEL 3-6/3-7 SELECT 3-3/3-6 table of 3-3 device types 3-7 example product
S Index REM-THEIR-PASSW attribute cannot enter (error E00221) B-11 description 2-72 must enter (error E00222) B-11 REM-THEIR-PASSW-RSP attribute cannot enter (error E00221) B-11 description 2-72 Rem-T-Selector field 2-193 Renaming See ALTER command REPLIED-TO-IPMS attribute 2-23 REPLY-RECIPS attribute 2-23 REPLY-TIME attribute 2-23 Reports-received field 2-159 Reports-sent field 2-159 REPORT-ROUTE-RETRY-DELAY attribute 2-33 REPORT-ROUTE-RETRY-GROW attribute 2-33 REPORT-ROUTE-RETRY-TIME attribute 2-33 REP-
S Index SCF (Subsystem Control Facility) CONFIRM option 1-13 error messages See Messages, error MHS control components 1-1 wild-card notation 1-9 SCP (Subsystem Control Point) 1-1 SCPMSG PTrace SELECT keyword 3-4 TRACE keyword 2-207 trace records 3-9 SC-BACKUP attribute 2-61 SC-CPU attribute 2-61 SC-PNAME attribute 2-62 SC-PRI attribute 2-62 SEL modifier ABORT command 2-7 INFO command 2-104 NAMES command 2-127 STATUS command 2-166 STOP CLASS command 2-200 STOP command 2-199 STOP GROUP command 2-202 STOP S
S Index STATUS command displays (continued) STATUS PROCESS RTS 2-192/2-195 STATUS PROCESS SC 2-195/2-197 STATUS SUBSYS 2-197/2-198 STOP APPL command 2-199 STOP CLASS command 2-200/2-201 STOP GROUP command 2-202 STOP modifier, TRACE command 2-206 STOP MON command 2-203 STOP SUBSYS command 2-204 STOPPED object state 1-15 STOPPING object state 1-15 Store cleaner attributes illegal (error E00225) B-12 Store cleaner (SC) process types 1-7 Store cleaning activity See CLEANER-INTERVAL attribute, CLEANER-TIME att
T Index System name must be… (error E00011) B-3 S-selector specifiers See APPL-SSELECTOR attribute, LOC-SSELECTOR-(1-7) attribute, MRS-SELECTOR attribute, REMSSELECTOR-(1-7) attribute T Takeover field 2-179 Takeover-count field 2-179 Teletex messages See ENCODED-INFO-TYPE-TTX attribute Telex messages See ENCODED-INFO-TYPE-TLX attribute Terminal identifiers See OW-TERMINAL-ID attribute, OWTERMINAL-TYPE attribute See TERMINAL-ID attribute, TERMINAL-TYPE attribute, DLTERMINAL-ID attribute, DLTERMINAL-TYPE a
V Index UAs-logged-on field 2-157 UA-cancel field 2-157 UA-delete field 2-157 UA-fetch field 2-158 UA-list field 2-158 UA-probes field 2-158 UA-submitted field 2-158 UA-summary field 2-158 uniq trace field 3-18 Unrecognized return code (error E00215) B-10 URGENT-ROUTE-RETRY-DELAY attribute 2-34 URGENT-ROUTE-RETRY-GROW attribute 2-34 URGENT-ROUTE-RETRY-TIME attribute 2-34 URGENT-TIME attribute 2-34 User message protocol data unit See UMPDU (user message protocol data unit) USERDB PTrace SELECT keyword 3-4
