OSI/TS SCF Reference Manual Abstract This manual describes the Subsystem Control Facility (SCF) commands specific to the Compaq OSI/TS data communications subsystem. These commands configure and control the OSI/TS subsystem. This manual also describes the SCF commands that display OSI/TS configuration and status information, and the OSI/TS subsystem-specific PTrace commands that format and display trace records.
Document History Part Number Product Version Published 18108 OSI/TS C20 March 1989 30445 OSI/TS C21 March 1990 056784 OSI/TS C30 July 1992 421961-001 OSI/TS D43 and G06 June 1999 424832-001 OSI/TS D43 December 1999 Ordering Information For manual ordering information: domestic U.S. customers, call 1-800-243-6886; international customers, contact your local sales representative. Document Disclaimer Information contained in a manual is subject to change without notice.
OSI/TS 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 Manual Contents xiii Related Manuals xiv Your Comments Invited xvi Notation Conventions xvi Abbreviations xx 1. Introduction General Description of SCF Interface Object Types 1-1 1-2 G-Series Compatability 1-2 Communication between D-Series and G-Series Systems 2.
2. OSI/TS SCF Commands (continued) Contents 2.
2. OSI/TS SCF Commands (continued) Contents 2.
2. OSI/TS SCF Commands (continued) Contents 2.
3. OSI/TS Trace Facility (continued) Contents 3.
3. OSI/TS Trace Facility (continued) Contents 3. OSI/TS Trace Facility (continued) L3 Pool 3-41 NETIO Trace Records 3-41 NetIO DSM 3-42 NetIO DSM 3-43 NetIO DSM 3-43 NetIO DSM 3-45 NetIO IO 3-47 NetIO IO 3-48 NetIO IO 3-49 NETIO Pool 3-49 A.
A. OSI/TS SCF Command Syntax Summary (continued) Contents A. OSI/TS SCF Command Syntax Summary (continued) STOP Command A-9 STOPOPENS Command SUSPEND Command A-10 A-10 TRACE Command A-11 A-11 VERSION Command B. OSI/TS SCF Error Messages Error Messages With Positive Numbers Error Messages Without Numbers B-1 B-4 C. Examples of Command Files OSI/TS on an X.25 Network C-2 OSI/TS on X.
Glossary Contents Glossary Index Figures Figure i. Figure 1-1. Related Manuals xiv OSI/TS Subsystem Object Hierarchy 1-2 Figure 1-2. D to G Communication 1-3 Figure 1-3. G to D Communication 1-4 Figure C-1. Example X.25 Loopback Configuration Figure C-2. Example LAN Loopback Configuration C-6 Figure C-3. Large Application Configuration: Single TSP for Multiple X25AM Lines C-12 Figure C-4. Large Application Configuration: Single TSP for Each X25AM Line C-15 C-2 Tables Table i.
What’s New in This Manual Manual Information OSI/TS SCF Reference Manual Abstract This manual describes the Subsystem Control Facility (SCF) commands specific to the Compaq OSI/TS data communications subsystem. These commands configure and control the OSI/TS subsystem. This manual also describes the SCF commands that display OSI/TS configuration and status information, and the OSI/TS subsystem-specific PTrace commands that format and display trace records.
New and Changed Information What’s New in This Manual OSI/TS SCF Reference Manual—424832-001 x
About This Manual This manual describes the Subsystem Control Facility (SCF) commands that are specific to the Compaq OSI/TS data communications subsystem. These commands are used to configure and control the OSI/TS subsystem. This manual also describes the SCF commands used to display OSI/TS configuration and status information, and the OSI/TS subsystem-specific PTrace commands used to format and display trace records.
About This Manual Notes: How - How To Information Ref - Reference Information AS PR - OSI/AS Programming Manual AS CM - OSI/AS Configuration and Management Manual AS SCF - OSI/AS SCF Reference Manual AS MPM - OSI/AS Management Programming Manual TS CM - OSI/TS Configuration and Management Manual TS SCF - OSI/TS SCF Reference Manual TS MPM - OSI/TS Management Programming Manual OSI/TS SCF Reference Manual—424832-001 xii
Manual Contents About This Manual Manual Contents Table ii, Manual Contents lists the contents of each section and appendix in this manual. Table ii.
Related Manuals About This Manual Related Manuals Figure i, Related Manuals shows some other manuals that contain helpful information on OSI/TS and related products. The manuals closest to the center of the figure are most closely related to this manual. Figure i. Related Manuals Introduction to Networking and Data Comm.
Related Manuals About This Manual The following list describes each of the manuals shown in Figure i, Related Manuals: • • • Introduction to Networking and Data Communications for Himalaya S-Series Servers. This manual provides an overview of Compaq networking and data communications products. Introduction to Distributed Systems Management (DSM). This manual introduces the products and components collectively known as Distributed Systems Management.
Your Comments Invited About This Manual • SCF reference manuals for OSI/AS, TLAM, PAM, and X25AM describe how to install, configure, and manage the underlying subsystems upon which Compaq OSI/TS depends. 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 User Documentation disc.
General Syntax Notation About This Manual [ ] Brackets. Brackets enclose optional syntax items. For example: TERM [\system-name.]$terminal-name INT[ERRUPTS] A group of items enclosed in brackets is a list from which you can choose one item or none. The items in the list may be arranged either vertically, with aligned brackets on each side of the list, or horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: FC [ num ] [ -num] [ text] K [ X | D ] address-1 { } Braces.
Notation for Messages About This Manual Item Spacing. Spaces shown between items are required unless one of the items is a punctuation symbol such as a parenthesis or a comma. For example: CALL STEPMOM ( process-id ) ; If there is no space between two items, spaces are not permitted. In the following example, there are no spaces permitted between the period and any other items: $process-name.#su-name Line Spacing.
Notation for Messages About This Manual Bold Text. Bold text in an example indicates user input entered at the terminal. For example: ENTER RUN CODE ?123 CODE RECEIVED: 123.00 The user must press the Return key after typing the input. Nonitalic text. Nonitalic letters, numbers, and punctuation indicate text that is displayed or returned exactly as shown. For example: Backup Up. lowercase italic letters. Lowercase italic letters indicate variable items whose values are displayed or returned.
Abbreviations About This Manual % Percent Sign. A percent sign precedes a number that is not in decimal notation. The %þ notation precedes an octal number. The %Bþ notation precedes a binary number. The %Hþ notation precedes a hexadecimal number. For example: %005400 P=%p-register E=%e-register Abbreviations The following list defines abbreviations and acronyms used in this manual and in the other Tandem OSI/AS and Tandem OSI/TS manuals. Not all terms listed here are used in this particular manual.
Abbreviations About This Manual CC-TPDU Connect confirm TPDU CEPI Connection endpoint identifier CLNS Connectionless-mode network service CN-SPDU Connect SPDU CONS Connection-mode network service COUP Configuration Utility Program CP-PPDU Connect presentation PPDU CPA-PPDU Connect presentation accept PPDU CPR-PPDU Connect presentation reject PPDU CR-PPDU Connect request PPDU CSMA Carrier sense multiple access CSMA/CD CSMA with collision detection CUG Closed user group DC-TPDU Di
Abbreviations About This Manual ES End system ES-IS End system to intermediate system FN-SPDU Finish SPDU FSAP File service access point FU Functional unit IDI Initial domain identifier (part of an NSAP address) IDP Initial domain part (part of an NSAP address) IEEE Institute of Electrical and Electronics Engineers IID Invocation identifier IP OSI internet protocol IPPDU IP protocol data unit IS Intermediate system ISO International Organization for Standardization LAN Local are
Abbreviations About This Manual NPDU Network protocol data unit NSAP Network service access point NSP Network service provider OCB Open control block OSI Open Systems Interconnection OSI/AS OSI/Application Services OSI/TS OSI/Transport Services PCI Protocol control information PCID Presentation context identifier PDU Protocol data unit PIN Process identification number PLP Packet-level protocol PPDU Presentation protocol data unit PSAP Presentation service access point PSEL Pr
Abbreviations About This Manual SNPA Subnetwork point of attachment SPDU Session protocol data unit SPI Subsystem Programmatic Interface SPM Session protocol machine SSAP Session service access point SSEL Session selector SSID Subsystem identifier SU Subdevice SYSGEN System generation program TACL Tandem Advanced Command Language TAL Transaction Application Language TAPS Tandem application, presentation, and session service provider TC-PPDU Capability data PPDU TCB Transport con
Abbreviations About This Manual TWR Time-to-wait-for resynchronize timer WAN Wide area network X25AM X25 Access Method OSI/TS SCF Reference Manual—424832-001 xxv
Abbreviations About This Manual OSI/TS SCF Reference Manual—424832-001 xxvi
1 Introduction This section contains the following information: • • A general description of the SCF interface G-series Compatability Information General Description of SCF Interface This manual describes the subsystem-specific details for using SCF to configure, control, and inquire about the Compaq OSI/TS subsystem. SCF can be used as an interactive interface to the OSI/TS subsystem. The Subsystem Control Point (SCP) is required as the interface between SCF and the OSI/TS subsystem.
Object Types Introduction Object Types Figure 1-1, OSI/TS Subsystem Object Hierarchy, on page 1-2 shows the OSI/TS object types supported by SCF and their hierarchical order. Figure 1-1. OSI/TS Subsystem Object Hierarchy PROCESS or null SERVICE SU ROUTE 010 As shown, the PROCESS object is at the highest point of the hierarchy, with all other objects subordinate to it. (The null object is not an actual object type but is used in commands that do not require specification of an object type.
G-Series Compatability Introduction can be X25AM, TCP/IP or TLAM (but, TLAM can be used only if OSI/AS running on G-series is a D40 release , that is, T9570D4x). Figure 1-2. D to G Communication D-Series G-Series OSI/AS OSI/AS OSI/TS OSI/TS NSP NSP CDT 700.
Communication between D-Series and G-Series Systems Introduction Communication between D-Series and G-Series Systems Figure 1-3 shows a OSI stack running on a G-series system communicating with another OSI stack running on a D-series system. The NSP on G-series can be X25AM, TCP/IP, or PAM; and the NSP on the D-series can be X25AM, TCP/IP, or TLAM. Figure 1-3. G to D Communication G-Series D-Series OSI/AS OSI/AS OSI/TS OSI/TS NSP NSP CDT 701.
2 OSI/TS SCF Commands This section contains the following information: • • • A table describing the Subsystem Control Facility (SCF) commands supported by the OSI/TS subsystem and the object types supported for each command Detailed information about object specification syntax The following detailed information about each SCF command: • • • • • • A description of the command function The command syntax The object specification, which shows the supported object types and object names Descriptions, by
Sensitive and Nonsensitive Commands OSI/TS SCF Commands Table 2-1.
Object Specification OSI/TS SCF Commands Table 2-2. Sensitive and Nonsensitive OSI/TS SCF Commands Sensitive Commands Nonsensitive Commands ABORT AGGREGATE ACTIVATE CHECK ADD INFO ALLOWOPENS LISTOPENS ALTER NAMES DELETE STATS (without the RESET option) PRIMARY STATUS START VERSION STATS (with the RESET option) STOP STOPOPENS SUSPEND TRACE Object Specification This section describes the syntax rules for object specification (object-spec).
Wild card Support OSI/TS SCF Commands Table 2-3. OSI/TS object-specs Object Type Object Name Object Name Format null tsp-process-name $process-name PROCESS tsp-process-name $process-name ROUTE nsap-entry $processname.#NSAP.nsapaddress SERVICE service-name $processname.#service-name SU su-name $process-name.#suname Wild card Support Along with the object-name syntax, the following pages also describe wild card support.
null Object OSI/TS SCF Commands unique. For example, the following three local TSP processes share the same X25AM line: $TSP10 $TSP20 $TSP30 Wild card Support Wild cards are not supported for the null object.
PROCESS Object OSI/TS SCF Commands PROCESS Object The PROCESS object identifies a specific TSP process within an OSI/TS subsystem. The object-name for the PROCESS object is tsp-process-name, and it has the following format: $process-name $process-name is the name of the TSP process as follows: Local TSP process names can be up to 6 characters (the $ sign followed by 5 characters).
PROCESS Object OSI/TS SCF Commands ABORTING The process is in transition to the STOPPED state because the ABORT command was issued. The process is running but does not accept new transport service requests. Once the abort has been accomplished, the process no longer exists. STARTED The process is running and accepts new transport service requests. STARTING The process is in transition to the STARTED state.
ROUTE Object OSI/TS SCF Commands ROUTE Object The ROUTE object, used only with the INFO command, provides information about how internet protocol PDUs (IPPDUs) are routed. Routes are automatically added, altered, and deleted by the end system to intermediate system (ES-IS) protocol and by connections and disconnections controlled by subdevices (SUs) with explicitly provided media access control (MAC) addresses.
ROUTE Object OSI/TS SCF Commands Examples The following are valid object-names for the ROUTE object: $TSP4.#NSAP.49000308008E000010FE01 $TSP4.#NSAP.
SERVICE Object OSI/TS SCF Commands SERVICE Object The SERVICE object defines attributes associated with a specific communication service element or protocol layer. The object-name for the SERVICE object is service-name, and it has the following format: $process-name.#service-name $process-name is the name of the TSP process as follows: Local TSP process names can be up to 6 characters (the $ sign followed by 5 characters).
SERVICE Object OSI/TS SCF Commands Examples The following are valid object-names for the SERVICE object: $TSP4.#L3 $TSP4.#L4 $TSP4.#L? $TP4.
SU Object OSI/TS SCF Commands SU Object Use the SU (subdevice) object to define a data communications subdevice to a process. There are two types of SUs: static and dynamic. A dynamic SU object is temporary, it is added dynamically by a TSP or NSP process and lasts only as long as the connection exists.
ABORT Command OSI/TS SCF Commands Examples The following are valid object-names for the SU object: $TP4.#S10 TP4.* ABORT Command Use the ABORT command to terminate the operation of objects as quickly as possible— only enough processing is done to ensure the security of the OSI/TS subsystem. Upon successful completion of the ABORT SU command, SU objects are left in the STOPPED state. Upon successful completion of the ABORT PROCESS command, PROCESS objects are deleted. This is a sensitive command.
ACTIVATE Command OSI/TS SCF Commands ACTIVATE Command Use the ACTIVATE command to return a suspended TSP process to the STARTED state. Once the process is in the STARTED state, new transport connections can be established. This is a sensitive command.
ADD SU Command OSI/TS SCF Commands The object-spec is: object-type object-name SU su-name ADD SU Command An attribute-spec for the ADD SU command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ { [ [ [ [ [ ALTCLASS { 0 | 1 | 2 | 3 | 4 } ] CHECKSUM { ON | OFF } ] CLASS { 0 | 1 | 2 | 3 | 4 } ] CONNECTTIMEOUT time ] DELETETIME { -1 | 0 } ] DISCONNECTTIMEOUT time ] EXPEDITED { ON | OFF } ] EXTENDEDFORMAT { ON | OFF } ] INACTIVETIMEOUT time ] IPNULLLAYE
ADD SU Command OSI/TS SCF Commands [ SENDSECURITY “text” ] [ TCONPRI integer ] [ TPDUSIZE { 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 } ] [ TTRTIMEOUT time ] [ TWRTIMEOUT time ] [ WINDOWTIMEOUT time ] [ X25ACCEPTCHG { ON | OFF } ] [ X25BCUG integer ] [ X25CUG integer ] [ X25CUGTYPE { BASIC | EXT | BASICOA | EXTOA } ] [ X25DESTADDR “address” ] [ X25NEGOTIATE { value | “(” value [ , value ] ...“)” } ] [ X25NONEGOTIATE { value | “(” value [ , value ] ...
ADD SU Command OSI/TS SCF Commands CLASS specifies the preferred transport protocol class. See the considerations for the ADD command for a discussion of the relationship between the ALTCLASS, CLASS, MULTIPLEX, and NETTYPE attributes. For LAN networks, the transport protocol class must be 4. For X.25 networks, when IPX25SNDCF is OFF, the transport protocol class can be 0, 1, 2, 3, or 4. For X.25 networks, when IPX25SNDCF is ON, the transport protocol class must be 4.
ADD SU Command OSI/TS SCF Commands EXTENDEDFORMAT specifies whether the credit and sequence numbers of TPDUs should be in extended format (ON) or normal format (OFF). This attribute is valid only when the transport protocol class is 2, 3, or 4. Value: ON | OFF Default: OFF INACTIVETIMEOUT specifies that if no TPDU is received within the specified time, the transport connection is aborted. This attribute is valid only when the transport protocol class is 4. Value: 1.000 through 500.
ADD SU Command OSI/TS SCF Commands LANLOCALSNPA is the local area network (LAN) subnetwork address. This value is automatically obtained by the TSP process during the first transport connection attempt over the specified device. LANLOCALSNPA is made up of two components. The first two hexadecimal digits are the link-level service access point selector (LSAP selector or LSEL); for OSI/TS, this value must be “FE.” The remaining 12 digits are the media access control (MAC) address.
ADD SU Command OSI/TS SCF Commands SNPA format (“FE+MACaddress”) See the LANLOCALSNPA attribute description for a full explanation of the SNPA value. Default: No default value is provided. LOCALTSEL defines the local transport service access point selector (TSAP selector or TSEL). TSP uses this field to build the calling TSAP-ID field of the CR-TPDU. If a value is not provided, the CR-TPDU does not contain the calling TSAP-ID. Value: A hexadecimal string (0-9 and A-F) up to 64 digits long.
ADD SU Command OSI/TS SCF Commands Type Quality of Network Service A Acceptable rates of unsignaled and signaled errors B Acceptable rate of unsignaled errors but unacceptable rate of signaled errors C Unacceptable rate of unsignaled errors Default: Defaults to the value of the NETTYPE attribute in the ALTER #L4 SERVICE command. If the CLASS attribute is specified, its value overrides the value of NETTYPE.
ADD SU Command OSI/TS SCF Commands Value: 3.000 through 180.000 (3 through 180 seconds) Default: 30.000 (30 seconds) REMOTENSAP defines the remote NSAP address. NSAP values are administered by a central addressing authority. Refer to the OSI/TS Configuration and Management Manual for a detailed description of NSAP addressing. See the considerations for the ADD command (concerning protocol selection) for information on when to use this attribute.
ADD SU Command OSI/TS SCF Commands TCONPRI specifies the priority of the transport connection. This attribute is used to reassign transport connections after errors have occurred. Because an agreement has not yet been reached among the implementors concerning this attribute, Compaq OSI does not currently process this field. Value: 0 through 32767 (0 being the highest priority) Default: 0 TPDUSIZE specifies, in bytes, the maximum length of a TPDU.
ADD SU Command OSI/TS SCF Commands Default: 10.000 (10 seconds) X25ACCEPTCHG specifies whether an incoming call request that contains a request for the recipient to pay the charge are accepted. ON means that collect calls are accepted. OFF means that collect calls are not accepted. This attribute is used only for X.25 networks. Value: ON | OFF Default: OFF X25BCUG specifies the bilateral closed user group ID sent in every call-request packet. This attribute is used only for X.25 networks.
ADD SU Command OSI/TS SCF Commands X25DESTADDR specifies the network address that is used as the called address in an outgoing callrequest packet. This attribute is used only for X.25 networks. Value: A decimal string (0-9) up to 15 digits long. Default: No default value is provided. X25NEGOTIATE specifies the network interface characteristics that are negotiable when a connection is offered with unacceptable values for those characteristics.
ADD SU Command OSI/TS SCF Commands Value: ON | OFF Default: OFF X25PVC specifies the channel number of the permanent virtual circuit (PVC) with which the X25AM subdevice to be created is bound. This attribute is used only for X.25 networks. If a TSP subdevice is configured to use X25PVC, all other subdevices with the same X25PVC must use transport class 2, 3 or 4. They will be multiplexed to use the same X25PVC and no additional X25AM subdevices are created for either connect or attach requests.
Considerations for the ADD Command OSI/TS SCF Commands Value: 0 through 9999 An RPOA transit network is indicated by the Data Network Identification Code (DNIC), which is an integer with the range 0 through 9999. There can be 0 through 7 DNIC's in the X25RPOA integer list. If 2 through 7 integers are included in the list, they must be enclosed in “()” and separated by blanks or commas. Default: Defaults to the #L3 SERVICE X25RPOA value.
Considerations for the ADD Command OSI/TS SCF Commands SU Object • • • • TSP checks the ranges of the attribute values but does not check the value of one attribute against another. The values that are actually used are determined at connection-establishment time. Use the STATUS command to see the attribute values used during a connection. SU objects are placed in the STOPPED state by the ADD command. They are placed in the STARTED state by issuing a START command.
Considerations for the ADD Command OSI/TS SCF Commands Table 2-4. OSI/TS Protocol Selection for X.25 Wide Area Network Attribute X.25 Network X.25 Network with SNDCF and Full IP NSPDEVICE Specifies an X.25 line Specifies an X.25 line CLASS 0-4 4 X25DESTADDR 1) Ignored for incoming calls 2) Required for outgoing calls 1) Ignored for incoming calls 2) Required for outgoing calls IPX25SNDCF OFF ON IPNULLLAYER Ignored Ignored ESISENABLE Ignored Ignored LOCALNSAP 1) Optional for 1984 X.
Considerations for the ADD Command OSI/TS SCF Commands Table 2-5. OSI/TS Protocol Selection for Local Area Networks Full IP with ES-IS Full IP, no ES-IS Null IP NSPDEVICE Specifies a TLAM line. (Use PAM for G06 and above releases). Specifies a TLAM line. (Use PAM for G06 and above releases) Specifies a TLAM line.
Examples of the ADD Command OSI/TS SCF Commands Examples of the ADD Command The examples are designed to show correct ways of specifying command syntax. SU Object ADD SU $TP4.#SU10, NSPDEVICE $LAN1, LOCALTSEL "3132" & , REMOTETSEL "3536", CLASS 4, , LANREMOTESNPA "FE08008E0002E3" & , LOCALNSAP "4912008A", REMOTENSAP "49431041" ADD SU $TP4.#SU11, NSPDEVICE $X251, LOCALTSEL "4142" & , REMOTETSEL "4546", CLASS 2, MULTIPLEX ON & , X25DESTADDR "31104153176", X25PORT 00 ADD SU $TP4.
Examples of the AGGREGATE Command OSI/TS SCF Commands Examples of the AGGREGATE Command The examples are designed to show correct ways of specifying command syntax. PROCESS Object AGGREGATE PROCESS $TP4 ALLOWOPENS Command Use the ALLOWOPENS command to permit file-system opens to be issued to a subdevice. This command reverses the effect of the STOPOPENS command. This is a sensitive command.
ALTER PROCESS Command OSI/TS SCF Commands This is a sensitive command. The LIKE option is supported only for SU objects. ALTER [ /OUT file-spec/ ] [ object-spec ] { , attribute-spec [ , attribute-spec ] ...
ALTER PROCESS Command OSI/TS SCF Commands Default: 4000 LANIOSIZE specifies the size of the I/O buffer sent to TLAM (for D-series, or PAM subsystems for G06 and above releases). Value: 4000 through 32000 Default: 10000 LANREADS specifies the maximum number of nowait reads allowed to be outstanding to TLAM at any one time (for D-series, or PAM subsystems for G06 and above releases).
ALTER PROCESS Command OSI/TS SCF Commands Default: 1024 RECEIVESIZE specifies the maximum size (in bytes) of the user request.
ALTER SERVICE #L3 Command OSI/TS SCF Commands ALTER SERVICE #L3 Command An attribute-spec for the ALTER SERVICE #L3 command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ESISCHECKSUM { ON | OFF } ] ESISENABLE { ON | OFF } ] ESISESCONFTIME time ] ESISESGROUPMACADDR { “address” | RESET } ] ESISHOLDTIME time ] ESISISGROUPMACADDR { “address” | RESET } ] ESISNOTIFYIS { ON | OFF } ] ESISQUERYRETRY integer ] ESISQUERYTIM
ALTER SERVICE #L3 Command OSI/TS SCF Commands Default: OFF ESISENABLE enables and disables the ES-IS protocol. Value: ON | OFF Default: ON ESISESCONFTIME specifies the interval at which the protocol reports its configuration to the subnetwork. This attribute is valid only when ESISENABLE is ON. Value: 1.000 through 655.000 (1 through 655 seconds) Default: 60.000 (60 seconds) ESISESGROUPMACADDR specifies the station group MAC address that all OSI end systems listen to.
ALTER SERVICE #L3 Command OSI/TS SCF Commands Default: 09002B000005 ESISNOTIFYIS specifies whether the ES-IS protocol entity reports its configuration when it determines that a new intermediate system is first available. This attribute is valid only when ESISENABLE is ON. Value: ON | OFF Default: OFF ESISQUERYRETRY specifies the number of times the ES-IS protocol entity retries to obtain the NSAPSNPA before giving up. This attribute is valid only when ESISENABLE is ON.
ALTER SERVICE #L3 Command OSI/TS SCF Commands IPDISCARDCONGTHLD is the threshold value that the IP entity compares to the counter IPDISCARDCONG. IPDISCARDCONG is the number of times the IP discarded an IPPDU because of internal congestion. This attribute is valid only when IPNULLLAYER is OFF. Value: 0 through 65535 If the threshold is 0, threshold events are never generated for this counter. Default: 0 IPDISCARDGENTHLD is the threshold value that the IP entity compares to the counter IPDISCARDGEN.
ALTER SERVICE #L3 Command OSI/TS SCF Commands IPDISCARDUNSUPTHLD is the threshold value that the IP entity compares to the counter IPDISCARDUNSUP. IPDISCARDUNSUP is the number of times the IP discarded an IPPDU because of an unsupported version or unsupported option. Unsupported versions are any version other than IP version 1 (ISO 8473: 1988).
ALTER SERVICE #L3 Command OSI/TS SCF Commands Default: ON X25ACCEPTCHG specifies whether an incoming call request that contains a request for the recipient to pay the charge is accepted. ON means that collect calls are accepted. OFF means that collect calls are not accepted. This attribute is used only for X.25 networks. Value: ON | OFF Default: OFF X25BCUG specifies the bilateral closed user group ID sent in every call-request packet. This attribute is used only for X.25 networks.
ALTER SERVICE #L3 Command OSI/TS SCF Commands X25DESTADDR specifies the network address that is used as the called address in an outgoing callrequest packet. This attribute is used only for X.25 networks. RESET returns this attribute to the default value (no address specified). Value: A decimal string (0-9) up to 15 digits long. Default: No default value is provided. X25DISCONNECTDELAY specifies the amount of time to wait before issuing a network disconnect request on an idle (unused) X.
ALTER SERVICE #L3 Command OSI/TS SCF Commands X25NONEGOTIATE specifies the network interface characteristics that are not negotiable when a connection is offered with unacceptable values for those characteristics. This attribute is used only for X.25 networks. Use X25NONEGOTIATE to set any value(s) to a nonnegotiable state. Value: L3WINDOW, PKTSIZE, THRUPUT Specify one, two, or all three values. Default: Defaults to the value of the NONEGOTIATE attribute in X25AM.
ALTER SERVICE #L3 Command OSI/TS SCF Commands Default: Defaults to the value of the PVC attribute in X25AM. X25REMOTENET specifies the addressing conventions to be used when building the called address in a call-request packet. This attribute is used only for X.25 networks. Value: DATANET | DATAPAC | DATEXP | DDXP | PSS | TELENET | TRANSPAC | TYMNET | UNINET | X25NP | X25SA | X25UD | X25XA Default: Defaults to the value of the NETID attribute in X25AM.
ALTER SERVICE #L3 Command OSI/TS SCF Commands Value Bits per Second 3 75 4 150 5 300 6 600 7 1200 8 2400 9 4800 10 9600 11 19200 Default: Defaults to the sysgen value of the X25AM line. The sysgen default value of X25AM is 4 (for both integer1 and integer2). Note that these values are based on the CCITT X.25 recommendations for 1980 and 1984. X25TRANSITDELAY specifies the transit delay in the facility field of a call-request packet. This attribute is used only for X.25 networks.
ALTER SERVICE #L4 Command OSI/TS SCF Commands ALTER SERVICE #L4 Command An attribute-spec for the ALTER SERVICE #L4 command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ALTCLASS { 0 | 1 | 2 | 3 | 4 } ] CHECKSUM { ON | OFF } ] CHECKTSEL { ON | OFF } ] CLASS { 0 | 1 | 2 | 3 | 4 } ] CONNECTTIMEOUT time ] DISCONNECTTIMEOUT time ] EXPEDITED { ON | OFF } ] EXTENDEDFORMAT { ON | OFF } ] INACTIVETIMEOUT time ] INBOUNDCRCONFERRTHLD number
ALTER SERVICE #L4 Command OSI/TS SCF Commands Value: ON | OFF Default: OFF CHECKTSEL specifies whether to check the responding transport address in the Connect Confirm TPDU (CC-TPDU). Value: ON | OFF Default: OFF CLASS specifies the preferred transport protocol class. See the considerations for the ALTER command for a discussion of the relationship between the ALTCLASS, CLASS, MULTIPLEX, and NETTYPE attributes. For LAN networks, the transport protocol class must be 4. For X.
ALTER SERVICE #L4 Command OSI/TS SCF Commands EXTENDEDFORMAT specifies whether the credit and sequence numbers of TPDUs should be in extended format (ON) or normal format (OFF). This attribute is valid only when the transport protocol class is 2, 3, or 4. Value: ON | OFF Default: OFF INACTIVETIMEOUT specifies that if no TPDU is received within the specified time, the transport connection is aborted. This attribute is valid only when the transport protocol class is 4. Value: 1.000 through 500.
ALTER SERVICE #L4 Command OSI/TS SCF Commands Default: 0 INBOUNDTPDUPROTOERRTHLD is the threshold value that the Transport Layer compares to the counter INBOUNDTPDUPROTOERR. INBOUNDTPDUPROTOERR is the number of times the subsystem receives a TPDU (other than a CR-TPDU) that can be associated with a transport connection and is invalid or constitutes a protocol error. Value: 0 through 65535 If the threshold is 0, threshold events are never generated for this counter.
ALTER SERVICE #L4 Command OSI/TS SCF Commands MAXREXMIT specifies the number of times unacknowledged TPDUs are retransmitted. This attribute is valid only when the transport protocol class is 4. Value: 1 through 8 Default: 3 MULTIPLEX specifies whether more than one outgoing transport connection is mapped to one network connection (ON) or not (OFF). To be able to multiplex, two or more subdevices must have MULTIPLEX ON and have the same local NSAP and remote NSAP (for outgoing connection requests).
ALTER SERVICE #L4 Command OSI/TS SCF Commands OUTBOUNDCRCONFERRTHLD is the threshold value that the Transport Layer compares to the counter OUTBOUNDCRCONFERR. OUTBOUNDCRCONFERR is the number of times the subsystem receives a DR-TPDU refusing a connection request due to negotiation failure, duplicate source reference, mismatched references, reference overflow, refused on the network connection, session entity not attached to TSAP, or address unknown.
ALTER SERVICE #L4 Command OSI/TS SCF Commands Default: OFF RECVSECURITY specifies whether security checking is performed on incoming CR-TPDUs. If security checking is specified, only incoming CR-TPDUs that have matching characters in the protection field are accepted. If a value is not provided, no security checking is performed. This attribute is valid only when the transport protocol class is 1, 2, 3, or 4. Note that not all transport protocol implementations support this attribute.
ALTER SERVICE #L4 Command OSI/TS SCF Commands Because an agreement has not yet been reached among the implementors concerning this attribute, Compaq OSI does not currently process this field. Value: 0 through 32767 (0 being the highest priority) Default: 0 TPDUSIZE specifies, in bytes, the maximum length of a TPDU. Value: 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 The values 4096 and 8192 are valid only when the transport protocol class is 1, 2, 3, or 4. For X.
ALTER SU Command OSI/TS SCF Commands ALTER SU Command An attribute-spec for the ALTER SU command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ALTCLASS { 0 | 1 | 2 | 3 | 4 } ] CHECKSUM { ON | OFF } ] CLASS { 0 | 1 | 2 | 3 | 4 } ] CONNECTTIMEOUT time ] DELETETIME { -1 | 0 } ] DISCONNECTTIMEOUT time ] EXPEDITED { ON | OFF } ] EXTENDEDFORMAT { ON | OFF } ] INACTIVETIMEOUT time ] IPNULLLAYER { ON | OFF } ] IPX25SNDCF { ON | OFF } ] L4W
ALTER SU Command OSI/TS SCF Commands [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ X25ACCEPTCHG { ON | OFF } ] X25BCUG integer | RESET ] X25CUG { integer | RESET } ] X25CUGTYPE { BASIC | EXT | BASICOA | EXTOA } ] X25DESTADDR { "address" | RESET } ] X25NEGOTIATE { value | "(" value [, value ] ...")" } ] X25NONEGOTIATE { value | "(" value [, value ] ...
ALTER SU Command OSI/TS SCF Commands CONNECTTIMEOUT specifies the amount of time to wait for responses to CR-TPDUs. Value: 3.000 through 180.000 (3 through 180 seconds) DELETETIME specifies whether to delete a subdevice after the last opener closes it. A value of 0 indicates that the subdevice is deleted immediately after the last opener closes it. (static) A value of -1 indicates that the subdevice is not deleted (dynamic).
ALTER SU Command OSI/TS SCF Commands Value: ON | OFF L4WINDOW specifies the maximum credit allocation to the remote transport entity. This is the number of TPDUs that can be sent by the remote transport entity without acknowledgment. This attribute is valid only when the transport protocol class is 1, 2, 3, or 4, but see below, because this attribute performs differently when the transport protocol class is 1.
ALTER SU Command OSI/TS SCF Commands LOCALNSAP defines the local network service access point (NSAP) address. NSAP values are administered by a central addressing authority. Refer to the OSI/TS Configuration and Management Manual for a detailed description of NSAP addressing. See the considerations for the ADD command (concerning protocol selection) for information on when to use this attribute. RESET returns this attribute to the default value (no address specified).
ALTER SU Command OSI/TS SCF Commands NETTYPE specifies the quality of the network services. See the considerations for the ALTER command for a discussion of the relationship between the ALTCLASS, CLASS, MULTIPLEX, and NETTYPE attributes.
ALTER SU Command OSI/TS SCF Commands REMOTENSAP defines the remote NSAP address. NSAP values are administered by a central addressing authority. Refer to the OSI/TS Configuration and Management Manual for a detailed description of NSAP addressing. See the considerations for the ADD command (concerning protocol selection) for information on when to use this attribute. RESET returns this attribute to the default value (no address specified). Value: A hexadecimal string (0-9 and A-F) up to 40 digits long.
ALTER SU Command OSI/TS SCF Commands TPDUSIZE specifies, in bytes, the maximum length of a TPDU. Value: 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 The values 4096 and 8192 are valid only when the transport protocol class is 1, 2, 3, or 4. For X.25 subnetworks: OSI/TS will adjust the value of TPDUSIZE to not exceed the value of the X25AM SYSGEN attribute MAXIOSIZE. Use the STATUS SU command to see the actual TPDUSIZE used when the connection was established.
ALTER SU Command OSI/TS SCF Commands X25CUG specifies the closed user group ID (CUG ID) that is sent in every call-request packet. This attribute is used only for X.25 networks. RESET returns this attribute to the #L3 SERVICE X25CUG value Value: 0 through 9999 X25CUGTYPE specifies the type of closed user group (CUG) facility. This attribute is used only for X.25 networks.
ALTER SU Command OSI/TS SCF Commands Specify one, two, or all three values. X25NONEGOTIATE specifies the network interface characteristics that are not negotiable when a connection is offered with unacceptable values for those characteristics. This attribute is used only for X.25 networks. Use X25NONEGOTIATE to set any value(s) to a nonnegotiable state. Value: L3WINDOW, PKTSIZE, THRUPUT Specify one, two, or all three values. X25PORT specifies the logical port number to be used by the subdevice.
ALTER SU Command OSI/TS SCF Commands X25REMOTENET specifies the addressing conventions to be used when building the called address in a call-request packet. This attribute is used only for X.25 networks. Value: DATANET | DATAPAC | DATEXP | DDXP | PSS | TELENET | TRANSPAC | TYMNET | UNINET | X25NP | X25SA | X25UD | X25XA X25REVERSECHG specifies whether an outgoing call request asks the recipient to pay the charges. ON indicates that the recipient is requested to pay the charges.
Considerations for the ALTER Command OSI/TS SCF Commands Value Bits per Second 9 4800 10 9600 11 19200 Note that these values are based on the CCITT X.25 recommendations for 1980 and 1984. X25TRANSITDELAY specifies the transit delay in the facility field of a call-request packet. This attribute is used only for X.25 networks. RESET returns this attribute to the #L3 SERVICE X25TRANSITDELAY value. Value: 0.000 through 65.530 (0 through 65.
Examples of the ALTER Command OSI/TS SCF Commands PROCESS Object • A PROCESS object must be in the SUSPENDED state before its attributes can be altered. SERVICE Object • For the ALTER SERVICE #L4 (and ALTER SU) commands, the transport protocol class and alternate transport protocol class are determined by the ALTCLASS, CLASS, MULTIPLEX, and NETTYPE attributes.
CHECK Command OSI/TS SCF Commands SERVICE Object ALTER ALTER ALTER ALTER SERVICE SERVICE SERVICE SERVICE $TSP4.#L3, ESISENABLE OFF, IPNULLLAYER ON $TSP4.#L4, RECVSECURITY RESET $TSP4.#L4, TPDUSIZE 8192 $TP4.#L3, X25RPOA (3,5,6) & , X25TRANSITDELAY 04.00 ALTER SERVICE $TP4.#L3, X25CUG 199, X25CUGTYPE EXTOA & , X25NEGOTIATE (L3WINDOW, THRUPUT) ALTER SERVICE $TP4.#L3, ESISHOLDTIME 55 ALTER SERVICE $TP4.#L4, PASSIVEMUX ON, CHECKTSEL ON SU Object ALTER ALTER ALTER ALTER SU SU SU SU $TP4.
CHECK SU Command OSI/TS SCF Commands CHECK SU Command An attribute-spec for the CHECK SU command is one of the following select name and value combinations: [ [ [ [ [ [ DISPLAY { UP | DOWN | ALL | ONE } ] ERRORONLY ] LOCALNSAP string ] LOCALTSEL string ] OPENER process-name ] USER group-id , user-id ] DISPLAY displays the information for the value specified. This option is useful in limiting the response time delay of this command.
CHECK SU Command OSI/TS SCF Commands To see all errors for TSP and NSP SUs, enter the following command: CHECK SU $TSP1.*, ERRORONLY, DISPLAY DOWN LOCALNSAP display only those SUs that are using this NSAP address on the local end of the connection. Value: A hexadecimal string (0-9 and A-F) up to 40 digits long. This string must be enclosed in quotes ("..."). For LAN networks only: This string should contain an even number of hexadecimal digits.
CHECK SU Command OSI/TS SCF Commands Value: a valid Guardian group-id and user-id in the following format: nn,nn Default: No default values are provided. The format of the display for the CHECK SU command without the detail option is: OSI/TS Check SU Level SU/Process Name Last Error Error Source State TSU: TSP: NSP: $myap $tsp1.#z000001 $x25a.#tsp1345 0 0 TCon established Started/Ready TSU: TSP: NSP: \comm.$myap \comm.$tsp1.#z000002 \comm.$lam1.
CHECK SU Command OSI/TS SCF Commands TAP: State shows the state that the Session Layer of the TAPS process is in. This is the current session protocol state as defined by the session standard. Refer to ISO 8327 for the possible values. (It’s the same value displayed in the L5 Protocol State attribute in the OSI/AS STATUS SU command.) TSP: SU Name shows the TSP SU that meets the specified selection criteria.
CHECK SU Command OSI/TS SCF Commands Value Meaning TLAM An error originating in TLAM has occurred. (PAM is used in place of TLAM for G06 and above releases of OSI/TS). X25AM An error originating in X25AM has occurred (blank) A blank indicates that no error has occurred NSP: State shows the state at the NSP level. For X25AM, the possible values are: Started/Ready Started/Not Ready Stopped/Ready Stopped/Not Ready The first column shows the summary state of the X25AM line object.
CHECK SU Command OSI/TS SCF Commands LocalTSel..... RemoteTSel.... LocalNSAP..... RemoteNSAP.... LANRemoteSNPA. X25DestAddr... AAAB BBBC A998 B887 3445 X25Port 0 ----------------------------------------------------------NSP: X25AM Line Info State...... STARTED LinkState..
CHECK SU Command OSI/TS SCF Commands The format of the display for the CHECK SU command with the detail option when NSP is PAM, for G-series systems with G06 or later releases is: OSITS Detailed Check SU $MTS0.#z123123 -------------------------------------------------------------------ASU: \COMM.$MYAPPL -------------------------------------------------------------------TAP: OSIAS Detailed Status SU $MAS0.#Z123123 State............... STARTED Opens............... 1 Opener..............
CHECK SU Command OSI/TS SCF Commands Duplex TypedData MinorSynchronize Resynchronize ActivityManagement CapabilityData L6 Protocol State... STAt0 Connected - data transfer L6 Normal Mode...... True ACSE Protocol State. STA5 Associated ACSE Normal Mode.... True Calling Address: (LOCAL) Application Name.. L1 AETitle: AETitle format. 2 AEQualifier.... 0000 AE01 APTitle........ { 2 6 6 6 1 } PSel............. A665 5443 SSel............. A001 TSel............. AAAB NSAP.............
CHECK SU Command OSI/TS SCF Commands Application-Name.. AE-Title: AE-Title format. 0 AE-Qual......... AP-Title........ P-Sel............. S-Sel............. B112 T-Sel............. BBBC NSAP.............. B887 -------------------------------------------------------------------TSP: OSITS Detailed Status SU $MTS0.#Z123123 State........ STARTED StopOpens.... OFF TC-State..... TCon established Opens........ 1 TC-SubState.. local initiated Opener Id.... 255,017 Opener....... \COMM.$MAS0 NSP SU......
CHECK SU Command OSI/TS SCF Commands RemoteTSel.... BBBC LocalNSAP..... A998 RemoteNSAP.... B887 LANRemoteSNPA. 3445 X25DestAddr... X25Port 0 -------------------------------------------------------------------NSP: X25AM Line Info State...... STARTED LinkState..
CHECK SU Command OSI/TS SCF Commands Opener shows which process has opened this SU. In OSI/AS there is only one opener per SU. Opener Id shows the user id of the process that opened the SU being displayed. That is the user id of the Opener. LoopBack shows whether the SU is in loopback mode or normal connection mode. DeleteTime shows whether the SU is dynamic (0), or static (-1).
CHECK SU Command OSI/TS SCF Commands Last TSP SubState shows the Transport-connection substate. This field is only displayed when the Last TSP Error field is non-zero. Refer to ISO 8073 for the possible values. L5 Protocol Version shows the session protocol version in use on this SU. Defined values are “1,” “2,” or “1 or 2.” The last value is displayed only if the connection is being established and the version has not yet been negotiated.
CHECK SU Command OSI/TS SCF Commands TypedDataNegotiatedReleaseMajorSynchronize ExceptionsActivityManagementMinorSynchronize CapabilityDataResynchronizeExpeditedData DuplexHalfDuplex L6 Protocol State shows the current presentation protocol state. For a list of possible values, see the presentation protocol standard. This field is only displayed for L6 or ASCE connections. L6 Normal Mode shows, if True, that normal mode is being used or if False, that X.410-1984 mode is used.
CHECK SU Command OSI/TS SCF Commands AEQualifier shows the application entity qualifier for the application entry name. APTitle shows the AP title for the application entry name. PSEL shows the presentation service selector for the application entry name. SSEL shows the session service selector for the application entry name. TSEL shows the transport service selector for the application entry name. NSAP shows the NSAP address for the application entry name.
Considerations for the CHECK Command OSI/TS SCF Commands If the SU being queried supports an ACSE association and therefore also a presentation connection and session connection, all information documented above is displayed. If the SU being queried supports a presentation connection and therefore also a session connection but is not using ACSE, all information documented above except the ACSE portion is displayed.
Examples of the CHECK Command OSI/TS SCF Commands SU command is used with a TAPS process from the C21 product version and a TSP process from this release (C30), then the TAPS displays will contain C21 product values and will ignore C30 product values. In this case, the ASU information will be unavailable and "ASU: unavailable" will be displayed. • • • • TLAM (for D-series, or PAM subsystems for G06 and above releases) returns very different, and far fewer, errors than X25AM returns.
DELETE Command OSI/TS SCF Commands DELETE Command Use the DELETE command to remove subdevices controlled by TSP. Only objects that were added with the ADD command can be deleted. This is a sensitive command. DELETE [ /OUT file-spec/ ] [ object-spec ] The object-spec is: object-type object-name SU su-name Considerations for the DELETE Command The considerations contain information about command use that should be read before studying the command syntax in too much detail.
INFO PROCESS Command OSI/TS SCF Commands In all the displays for the INFO command, an asterisk (*) indicates that the value of the attribute can be changed with the ALTER command. INFO PROCESS Command The format of the display for the INFO PROCESS command without the DETAIL option is: OSITS Info PROCESS Name $MTS0 *Priority 139 *MaxConnections 1024 Name shows the name of the PROCESS object. Priority shows the priority level under which this process is running.
INFO PROCESS Command OSI/TS SCF Commands DataSwapVol shows the name of the volume where TSP allocated its extended segment. LANDFC shows the maximum number of Layer 2 frames allowed per I/O. LANDFT shows the maximum number of seconds Layer 2 frames are blocked. LANDExpandIOSize shows the size of the I/O buffer sent to TLAM/PAM when TLAM/PAM resides in another node. (PAM, for G06 and above releases) LANDIOSize shows the size of the I/O buffer sent to TLAM/PAM.
INFO ROUTE Command OSI/TS SCF Commands INFO ROUTE Command The format of the display for the INFO ROUTE command without the DETAIL option is: OSI/TS Tsp Info ROUTE NSAPAddress $TP4.#NSAP.49000308008E000010FE01 08008E000010 *MACAddress NSAPAddress shows the NSAP address that is used as the key to the table. MACAddress shows the MAC address that an IPPDU sent to the associated NSAP address is sent to.
INFO ROUTE Command OSI/TS SCF Commands Type shows the type of route entry. Some of the entries in this table are deleted after a period of time. In the following descriptions, this is referred to as “aging out.” The other entries do not age out, this is referred to as a static entry. Valid types are: LOCAL specifies a local NSAP entry, obtained from the configuration of the SU through which a connection attempt (incoming or outgoing) has been made. This is a static entry.
INFO SERVICE #L3 Command OSI/TS SCF Commands INFO SERVICE #L3 Command The format of the display for the INFO SERVICE #L3 command without the DETAIL option is: OSITS Info SERVICE Name $MTS0.#L3 *IPX25SNDCF OFF *IPNullLayer OFF *ESISEnable ON Name shows the name of the SERVICE object. IPX25SNDCF shows whether the subnetwork dependent convergence facility is used. IPNullLayer shows whether null-IP is used. ESISEnable shows whether the ES-IS protocol is used.
INFO SERVICE #L3 Command OSI/TS SCF Commands ESISEnable shows whether the ES-IS protocol is used. ESISChecksum shows whether the end system to intermediate system (ES-IS) protocol entity performs checksum on the outgoing ES-IS protocol data units (ES-IS PDUs). ESISESConfTime shows the interval at which the protocol reports its configuration to the subnetwork. ESISESGroupMACADDR shows the station group MAC address that all OSI end systems listen to.
INFO SERVICE #L3 Command OSI/TS SCF Commands IPDiscardGenThld shows the threshold value that the IP entity compares to the counter IPDISCARDGEN. IPDiscardLifeThld shows the threshold value that the IP entity compares to the counter IPDISCARDLIFE. IPDiscardReasmThld shows the threshold value that the IP entity compares to the counter IPDISCARDREASM. IPDiscardUnsupThld shows the threshold value that the IP entity compares to the counter IPDISCARDUNSUP.
INFO SERVICE #L3 Command OSI/TS SCF Commands X25DestAddr shows the called address for outgoing call-request packets. X25DisconnectDelay shows the amount of time to wait before issuing a network disconnect request on an idle (unused) X.25 network connection. X25NConMultiplex shows the maximum number of outgoing transport connections that are multiplexed on a single network connection. X25Negotiate shows the names of the negotiable network interface characteristics.
INFO SERVICE #L4 Command OSI/TS SCF Commands INFO SERVICE #L4 Command The format of the display for the INFO SERVICE #L4 command without the DETAIL option is: OSITS Info SERVICE Name $MTS0.#L4 *Class 2 *TPDUSize 512 *Expedited OFF Name shows the name of the SERVICE object. Class shows the preferred protocol class. TPDUSize shows the maximum length of a TPDU. Expedited shows whether the transport expedited data transfer service is supported.
Detailed Display OSI/TS SCF Commands Detailed Display The format of the display for the INFO SERVICE #L4 command with the DETAIL option is: OSITS Detailed Info SERVICE $MTS0.#L4 *AltClass................ *Checksum................ *CheckTSel............... *Class................... *ConnectTimeout.......... *DisconnectTimeout....... *Expedited............... *ExtendedFormat.......... *InactiveTimeout......... *InboundCRConfErrThld.... *InboundCRCongestionThld. *InboundCRProtoErrThld...
Detailed Display OSI/TS SCF Commands Class shows the preferred protocol class. ConnectTimeout shows the amount of time to wait for responses to CR-TPDUs. DisconnectTimeout shows the amount of time to wait for responses to DR-TPDUs. Expedited shows whether the transport expedited data transfer service is supported. ExtendedFormat shows whether the credit and sequence numbers of TPDUs should be in extended format (ON) or normal format (OFF).
Detailed Display OSI/TS SCF Commands L4Window shows the maximum credit allocation to the remote transport entity. This is the number of TPDUs that can be sent by the remote transport entity without acknowledgment. MaxRexmit shows the number of times unacknowledged TPDUs are retransmitted. Multiplex shows whether (ON) or not (OFF) more than one transport connection is mapped to one network connection. NetType shows the quality of the network services.
INFO SU Command OSI/TS SCF Commands SendSecurity shows the security code for outgoing CR-TPDUs and CC-TPDUs. TConPri shows the priority of the transport connection. This value is used for reassignment of transport connections after errors. TPDUSize shows the maximum length of a TPDU. TTRTimeout shows the maximum amount of time to try reassignment after network connection failures. TWRTimeout shows the amount of time to wait for reassignment after network connection failures.
Detailed Display OSI/TS SCF Commands Detailed Display The format of the display for the INFO SU command with the DETAIL option is: OSITS Detailed Info SU $MTS0.#Z123123 *AltClass......... *Class............ *DeleteTime....... *Expedited........ *InactiveTimeout.. *IPX25SNDCF....... *LANLocalSNPA..... *LocalNSAP........ *LocalTSel........ *MaxRexmit........ *NetType.......... *RecvSecurity..... *RemoteNSAP....... *RemoteTSel....... *RexmitTimeout.... *TConPri.......... *TTRTimeout....... *WindowTimeout....
Detailed Display OSI/TS SCF Commands Expedited shows whether the transport expedited data transfer service is supported. ExtendedFormat shows whether the credit and sequence numbers of TPDUs should be in extended format (ON) or normal format (OFF). InactiveTimeout shows the amount of time after which a transport connection is aborted if no TPDU is received. IPNullLayer shows whether null-IP is used. IPX25SNDCF shows whether the subnetwork dependent convergence facility is used.
Detailed Display OSI/TS SCF Commands NetType shows the quality of the network services. NSPDevice shows the name of the I/O process that controls access to the subnetwork. RecvSecurity shows the security code for incoming connect requests. This code must match the characters contained in the protection field of the incoming connect request. RefTimeout shows the amount of time before which no reference or sequence numbers are reused. RemoteNSAP shows the remote NSAP address.
Detailed Display OSI/TS SCF Commands WindowTimeout shows the amount of time to wait before retransmitting up-to-date window information. X25AcceptChg shows whether incoming collect calls are accepted. X25BCUG shows the bilateral closed user group ID that is sent in every call-request packet. X25CUG shows the closed user group ID that is sent in every call-request packet. X25CUGType shows the type of closed user group (CUG) facility.
Considerations for the INFO Command OSI/TS SCF Commands X25Thruput shows the throughput class limit for calls received and initiated. X25TransitDelay shows the transit delay in the facility field of a call-request packet. Considerations for the INFO Command The considerations contain information about command use that should be read before studying the command syntax in too much detail.
LISTOPENS Command OSI/TS SCF Commands SERVICE Object INFO INFO INFO INFO INFO SERVICE SERVICE SERVICE SERVICE SERVICE $TP4.#L3 $TP4.* $TP4.#L4 $TP4.#L4, DETAIL $TP4.*, DETAIL SU Object INFO SU $TP4.#S10 INFO SU $TP4.* LISTOPENS Command Use the LISTOPENS command to display information about file-system opens that apply to the specified object.
Examples of the LISTOPENS Command OSI/TS SCF Commands Fnum shows the file number associated with the opener. OpenFlags shows the value of the flags in the OPEN procedure. SyncDepth shows the value of the synch depth in the OPEN procedure. UserID shows the user that started the application process that opened the TSP subdevice. Examples of the LISTOPENS Command The examples are designed to show correct ways of specifying command syntax. SU Object LISTOPENS SU $TP4.#S10 LISTOPENS SU $TP4.
NAMES null Command OSI/TS SCF Commands NAMES null Command The format of the display for the NAMES null command is: OSITS Names \COMM.$MTS0 PROCESS $MTS0 SERVICE $MTS0.#L3 $MTS0.#L4 SU $MTS0.#Z123123 $MTS0.#ZMF0002 $MTS0.#Z123124 $MTS0.#ZMF0001 PROCESS shows the name of the TSP process. SERVICE shows a list of the SERVICE objects. SU shows a list of the SU objects.
NAMES SERVICE Command OSI/TS SCF Commands The format of the display for the NAMES PROCESS command with the SUB modifier is: OSITS Names PROCESS \COMM.$MTS0 PROCESS $MTS0 SERVICE $MTS0.#L3 $MTS0.#L4 SU $MTS0.#Z123123 $MTS0.#ZMF0002 $MTS0.#Z123124 $MTS0.#ZMF0001 PROCESS shows the name of the TSP process. SERVICE shows a list of the SERVICE objects. SU shows a list of the SU objects. NAMES SERVICE Command The format of the display for the NAMES SERVICE command is: OSITS Names SERVICE \COMM.$MTS0.
Considerations for the NAMES Command OSI/TS SCF Commands SU shows a list of the SU objects. Considerations for the NAMES Command The considerations contain information about command use that should be read before studying the command syntax in too much detail. SERVICE Object • Wild cards are supported for the NAMES SERVICE command. Examples of the NAMES Command The examples are designed to show correct ways of specifying command syntax.
Considerations for the PRIMARY Command OSI/TS SCF Commands Considerations for the PRIMARY Command The considerations contain information about command use that should be read before studying the command syntax in too much detail. PROCESS Object • • The PRIMARY command should not be used if any transport connections are active because this will result in the termination of all connections controlled by the old primary process.
Examples of the START Command OSI/TS SCF Commands • • The START command applies only to processes that already exist. Therefore, issuing a START command to a TSP process is useful only to reverse a STOP or ABORT command while the process is still in the STOPPING or ABORTING state. The START command can be used to change the state of a TSP process from SUSPENDED to STARTED (refer also to the ACTIVATE command).
STATS PROCESS Command OSI/TS SCF Commands STATS PROCESS Command The format of the display for the STATS PROCESS command is: OSITS Stats PROCESS $MTS1 Reset Time.. 16 Apr 1991, 10:04:05.708 Sample Time. 16 Apr 1991, 12:24:21.075 Transport Control Block Table: Total....... 2000 InUse..... 0 MinEverFree. 1999 Fails..... 0 Free...... 2000 Size...... 386 Requester Control Block Table: Total....... 1024 InUse..... 2 MinEverFree. 1021 Fails..... 0 Free...... 1022 Size......
STATS PROCESS Command OSI/TS SCF Commands Free shows the number of entries of a table free for allocation. MinEverFree shows the minimum number of table entries ever free. Fails shows the number of allocation attempts that failed. Size shows the number of entries (in octets) in each table entry. The size of the buffer pool is indicated in pages (2Kb). CurAlloc shows the amount of pool space currently allocated. MaxAlloc shows the maximum amount of pool space ever allocated.
STATS PROCESS Command OSI/TS SCF Commands Time List Element Table is used to manage the time list elements (TLES). Buffer Pool is used to store the dynamic I/O control blocks like Request I/O CBS, Network I/O CBS, Transport I/O CBS, and Transport PDU CBS. Request I/O Control Blocks are used to process system and user requests and responses. Network I/O Control Blocks are used for I/O to the NSP device. Transport I/O Control Blocks are used to represent transport primitives within the TSP process.
STATS SERVICE #L3 Command OSI/TS SCF Commands STATS SERVICE #L3 Command The format of the display for the STATS SERVICE #L3 command is: OSITS Stats SERVICE $MTS0.#L3 Reset Time.. 16 Apr 1991, 10:04:02.899 Sample Time. 16 Apr 1991, 12:31:35.540 IPPDUs-sent....................... IPPDUs-received................... IPOctets-sent..................... IPOctets-received................. 0 0 0 0 IPDiscardAddr..................... IPDiscardAddrThld................. IPDiscardCong.....................
STATS SERVICE #L3 Command OSI/TS SCF Commands IPDiscardCong is the number of times the IP has discarded an IPPDU because of internal congestion. IPDiscardCongThld is the threshold number against which the counter IPDiscardCong is compared.
STATS SERVICE #L4 Command OSI/TS SCF Commands STATS SERVICE #L4 Command The format of the display for the STATS SERVICE #L4 command is: OSITS Stats SERVICE $MTS0.#L4 Reset Time.. 16 Apr 1991, 10:04:02.899 Sample Time. 16 Apr 1991, 12:31:42.524 TPDUs-sent................................... 0 TPDUs-received............................... 0 TPDUs-resent................................. 0 UserBytes-sent............................... UserBytes-received........................... ExpBytes-sent.................
STATS SERVICE #L4 Command OSI/TS SCF Commands TPDUs-resent shows the number of TPDUs that were retransmitted. UserBytes-sent shows the number of octets of user data that have been sent and acknowledged. UserBytes-received shows the number of octets of nonduplicate data received and returned to the user application. ExpBytes-sent shows the number of octets of user data that have been sent in expedited TPDUs and acknowledged.
STATS SERVICE #L4 Command OSI/TS SCF Commands InboundCRProtoErrThld shows the threshold number against which the counter InboundCRProtoErr is compared. InboundTPDUProtoErr is the number of times OSI/TS receives a TPDU (other than CR-TPDU) that can be associated with a transport connection and is invalid or constitutes a protocol error. InboundTPDUProtoErrThld shows the threshold number against which the counter InboundTPDUProtoErr is compared.
STATS SU Command OSI/TS SCF Commands OutboundCRErrThld shows the threshold number against which the counter OutboundCRErr is compared. OutboundTPDUProtoErr is the number of times OSI/TS receives a DR-TPDU or ER-TPDU as the response to any TPDU it initiated other than the CR-TPDU. OutboundTPDUProtoErrThld shows the threshold number against which the counter OutboundTPDUProtoErr is compared.
Considerations for the STATS Command OSI/TS SCF Commands TPDUsResent shows the number of TPDUs that were retransmitted. UserBytesSt shows the number of octets of user data that have been sent and acknowledged. UserBytesRc shows the number of octets of nonduplicate data received and returned to the user application. ExpBytesSt shows the number of octets of user data that have been sent in expedited TPDUs and acknowledged.
STATUS Command OSI/TS SCF Commands SU Object STATS SU $TP4.#S10 STATS SU $TP4.* STATUS Command Use the STATUS command to display current status information about an object such as the dynamic state and the last error.
Detailed Display OSI/TS SCF Commands StopOpens shows whether a STOPOPENS command is in effect for this process. Opens shows the total number of opens for this process. Trace shows whether a TRACE command is in effect for this process. Detailed Display The format of the display for the STATUS PROCESS command with the DETAIL option is: OSITS Detailed Status PROCESS $MTS1 Creation Time...... State.............. Primary PID........ OwnerId............ StopOpens.......... Trace.............. TraceMask.....
STATUS SU Command OSI/TS SCF Commands shows the number of opens for this process. Trace Indicates whether or not a TRACE command is in effect for this process. TraceMask shows the current trace mask. This field is displayed only when the Trace is ON. TraceFile shows the name of the trace file. This field is displayed only when the Trace is ON. Trace Collector PID shows the CPU number and process identification number (PIN) for the trace collector process (not displayed when TRACE is OFF).
Detailed Display OSI/TS SCF Commands TC-State shows the transport connection state. Detailed Display The format of the display for the STATUS SU command with the DETAIL option is: OSITS Detailed Status SU $MTS0.#Z123123 State........ TC-State..... TC-SubState.. Opener....... NSP SU....... STARTED TCon in progress waiting for CR-TPDU \COMM.$MAS0 \COMM.$X25A.#MTS0001 NSP Subsys....... X25AM FileError........ 0 NSPDSMRetCode.... 0 NSPDSMSubCode1... 0 NSPDSMSubCode2... 0 NSPFSErrorCode... 0 X25ClearCause.
Detailed Display OSI/TS SCF Commands Opens shows the number of opens for this object. TC Substate shows the Transport-connection substate. Opener ID shows the user id of the process that opened the SU being displayed. That is the user id of the "Opener". Opener shows one of the processes that have opened this SU. Only one opener is listed and no guarantee is made that this is actually the first one that opened this SU. In most cases there will only be one opener per SU.
Detailed Display OSI/TS SCF Commands NSPDSMSubCode2 shows the NSP DSM subcode 2 value, which indicates the offset to the token in error. LastAlterTime shows the time that this SU was last altered. If the SU has not yet been altered, the display will be blank. NSPFSErrorCode shows the NSP Guardian 90 file-system error code if an error has occurred. LastCloseTime shows the time that this SU was last closed. If the SU has not yet been closed, the display will be blank.
Detailed Display OSI/TS SCF Commands DeleteTime shows whether the SU is dynamic (0), or static (-1). T-Expedited shows whether the transport expedited data transfer service is supported. TPDU Format shows whether the credit and sequence numbers of TPDUs should be in EXTENDED format (on) or NORMAL format (off). TPDU Size shows, in octets, the maximum length of a TPDU.
Examples of the STATUS Command OSI/TS SCF Commands LocalTSEL shows either the configured local transport selector used in the outgoing transport connect request or the actual transport selector used by a remote transport entity in the received transport connect request. RemoteTSEL shows the transport selector of the remote transport entity with which a transport connection has been established.
STOP Command OSI/TS SCF Commands STOP Command Use the STOP command to terminate the activity of an object and its subordinate objects in a normal manner. The STOP command prevents the object from accepting further service requests. Upon successful completion of the STOP command, configured objects (SU objects) are left in the STOPPED state if the value of the DELETETIME attribute is -1; if the value of DELETETIME is 0, the SU is deleted. PROCESS objects are deleted. This is a sensitive command.
STOPOPENS Command OSI/TS SCF Commands STOPOPENS Command Use the STOPOPENS command to prevent further file-system opens from being issued to an object without disrupting any of the current activity. This is a sensitive command. STOPOPENS [ /OUT file-spec/ ] [ object-spec ] The object-spec is: object-type object-name SU su-name Considerations for the STOPOPENS Command The considerations contain information about command use that should be read before studying the command syntax in too much detail.
Examples of the SUSPEND Command OSI/TS SCF Commands The object-spec is: object-type object-name PROCESS tsp-process-name Examples of the SUSPEND Command The examples are designed to show correct ways of specifying command syntax. PROCESS Object SUSPEND PROCESS $TP4 TRACE Command Use the TRACE command to collect trace information between a TSP process and its environment (user applications, network service provider processes).
TRACE Command OSI/TS SCF Commands file-spec causes any SCF output generated for this command to be directed to the specified file. object-spec designates the objects to be traced. If object-spec is omitted, the assumed object is traced (see the SCF ASSUME command). STOP discontinues the trace currently in progress. BACKUP specifies that the backup process should receive the trace request. If BACKUP is specified, the object must be running as a NonStop process pair.
TRACE Command OSI/TS SCF Commands { keyword } { ( keyword [ , keyword ]... ) } where keyword is one or more of the following values: [ ALL ] [ MSG ] [ L4 ] [ L3 ] [ NETIO ] ALL [or blank] (or blank) specifies that all trace options are selected. This is the default value. The trace file can get very large very quickly. It will wrap, if requested, or will simply stop tracing when the TO file gets full. MSG specifies tracing of messages from and to $RECEIVE.
Considerations for the TRACE Command OSI/TS SCF Commands Considerations for the TRACE Command The considerations contain information about command use that should be read before studying the command syntax in too much detail. • The default value of RECSIZE may not be enough to allow complete formatting of trace records using PTrace. Formatting of DSM commands and responses (this is the formatted or LABEL facility in PTrace) requires a large RECSIZE to accommodate the entire command and response buffer.
VERSION PROCESS Command OSI/TS SCF Commands VERSION PROCESS Command The format of the display for the VERSION PROCESS command without the DETAIL option is: VERSION \COMM.$MTS0 : OSI/TS TSP - T9083C30 - (128NOV91) - (31OCT91) The format of the display for the VERSION PROCESS command with the DETAIL option is: Detailed VERSION \COMM.$MTS0 SYSTEM \COMM OSI/TS TSP - T9083C30 - (15JUL91) - (31OCT91) - 3.0.
3 OSI/TS Trace Facility This section contains the following information: • • • An introduction to the OSI/TS trace facility A description of the subsystem-specific PTrace commands A sample of each type of trace record display The OSI/TS trace facility helps you diagnose different problems that can occur in the operation of Compaq OSI/TS processes.
PTrace Commands OSI/TS Trace Facility PTrace Commands This section describes the following PTrace commands that are interpreted specifically for the OSI/TS subsystem: • • • • • DETAIL FILTER HEX SELECT STATETABLES Other commands that are generally supported by PTrace, such as the FROM and LOG commands, are not documented in this manual.
Running PTrace OSI/TS Trace Facility 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/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.
DETAIL Command OSI/TS Trace Facility DETAIL Command The DETAIL command controls the level of detail of the information displayed. The following table shows the additional information you will get with DETAIL ON and the appropriate filter option(s) selected.
FILTER Command OSI/TS Trace Facility The filter-option is one or more of the following keywords: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ HELP ] ? ] RESET ] [NO]MSGSYS ] [NO]MSGDSM ] [NO]MSGINTERNALS ] MSGSU [ su-name ] ] [NO]L4INTERNALS ] [NO]L4SERVICES ] [NO]L4SM ] L4SU [ su-name ] ] TPDU [ tpdu-type ] [, tpdu-type ] ...
FILTER Command OSI/TS Trace Facility MSG SYS—CONTROL MSG SYS—CONTROLBUF MSG SYS—CPU DOWN MSG SYS—CPU UP MSG SYS—DEVICEINFO MSG SYS—NETSTATUS CHANGED MSG SYS—NODEDOWN MSG SYS—OPEN MSG SYS—POWER ON MSG SYS—PROCESS ABENDED MSG SYS—PROCESS STOPPED MSG SYS—PROCDEATH MSG SYS—RMTCPUDOWN MSG SYS—RESETSYNC MSG SYS—SETMODE MSG SYS—SETPARAM MSG SYS—SETTIME MSG SYS—TIME SIGNAL [NO]MSGDSM displays DSM commands and responses for OSI/TS objects. NOMSGDSM suppresses the display of this information.
FILTER Command OSI/TS Trace Facility MSG DSM—LISTOP MSG DSM—RESETSTATS MSG DSM—START MSG DSM—STATS MSG DSM—STATUS MSG DSM—STOP MSG DSM—STOPOP MSG DSM—SUSPEND MSG DSM—SWITCH MSG DSM—TRACE MSG DSM—VERSION [NO]MSGINTERNALS displays traces of internal activities related to user messages. This includes the following trace records: MSG Pool—Allocate MSG Pool—Deallocate MSG Timer—Start Timer MSG Timer—Stop Timer NOMSGINTERNALS suppresses the display of this information. The default is NOMSGINTERNALS.
FILTER Command OSI/TS Trace Facility L4 Queue—NCB Inactive L4 Queue—Queue TCB NOL4INTERNALS suppresses display of this information. The default is NOL4INTERNALS. This information is primarily for use by Compaq analysts in troubleshooting the Compaq OSI/TS software. [NO]L4SERVICES displays transport layer service primitives.
FILTER Command OSI/TS Trace Facility [ DC ] (Disconnect Confirm) [ DR ] (Disconnect Request) [ DT ] (Data) [ EA ] (Expedited Acknowledge) [ ED ] (Expedited Data) [ ER ] (Error Report) [ RJ ] (Reject) The default is TPDU (select all TPDUs). [NO]RTPDU displays ES-IS (PDUs). This includes the following trace records: L3 ESIS PDU—ESH (End System Hello) L4 ESIS PDU—ISH (Intermediate System Hello) L4 ESIS PDU—RD (Redirect) NORTPDU suppresses display of this information. The default is RTPDU.
FILTER Command OSI/TS Trace Facility L3 IP—PDU REASSEMBLED L3 IP—SEG ADDED TO QUEUE L3 IP—SEGMENT CREATED NOL3INTERNALS suppresses the display of this information. value is one of the following: [ IP ] Displays OSI internet protocol (CLNP) related events and actions. [ RT ] Displays ES-IS related events and actions The default is NOL3INTERNALS. If you select L3INTERNALS with no values specified, both IP and RT are enabled.
Considerations for the FILTER Command OSI/TS Trace Facility [NO]NETIOINTERNALS displays internal operation traces of the subnetwork interface. This includes the following trace records: NETIO Pool—Allocate NETIO Pool—Deallocate NONETIOINTERNALS suppresses the display of this information. The default is NONETIOINTERNALS. This information is primarily for use by Compaq analysts in troubleshooting the Compaq OSI/TS software.
Examples of the FILTER Command OSI/TS Trace Facility Examples of the FILTER Command The examples are designed to show you correct ways of specifying command syntax. FILTER L4SU #S1 is used to limit the display to those for TSP SU #S1. FILTER L4SERVICES is used to display L4 service primitives. FILTER L3SERVICES is used to display all Layer 3 service primitives. FILTER MSGSYS is used to display all system messages (for example, OPEN, CONTROL, or SETPARAM) received by the TSP process.
SELECT Command OSI/TS Trace Facility a NEXT, FIND, or RECORD command, it checks its selection mask to determine whether or not the record is of a type that you want to display. SELECT [ [ [ [ [ ALL] CURRENT ] number ] keyword ] ( keyword [ , keyword ] ... ) ] ALL selects all trace-selection options. 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.
Considerations for the SELECT Command OSI/TS Trace Facility MSG IO MSG Pool MSG SYS MSG Timer L4 specifies relevant events and actions in the transport layer. This includes all the trace records for: L4 Pool L4 Queue L4 SM L4 TPDU L4 T-Primitive L3 specifies relevant events and actions in the network layer.
Examples of the SELECT Command OSI/TS Trace Facility • • • • • • If no SELECT command is entered, the default is ALL. If SELECT is specified with no mask or keywords, ALL is assumed. The RESET and FROM commands reset the mask to ALL. The "Ptrace Select key" in the ENV command display shows the selected enumerated values from the SELECT command.
Trace Record Displays OSI/TS Trace Facility • L4 State Machine STATETABLES file-name file-name is the name of the statetable file: $volume.subvolume.ZOS4SMT When you use the PTrace FROM command, PTrace automatically invokes the STATETABLES command. The state-machine file name that PTrace looks for is $SYSTEM.SYSnnn.ZOS4SMT. If you decide to use a state-machine file name in a different form, you can use the STATETABLES command to identify it.
Getting Help OSI/TS Trace Facility Additionally, the formats of individual trace records are subject to change with product IPMs or with new software releases. Records (or fields within records) may be added or deleted as necessary. PTrace might not be able to display all data, for example, a complete DSM command buffer, if the data is longer than the trace record size specified by the SCF TRACE START command. The trace record size is shown in the trace header record.
File Header Record OSI/TS Trace Facility File Header Record The file header record displays identification information specific to the trace file. Trace of: Ptrace Data File: Trace started: First trace entry: Last trace entry: Trace entry size limit: \NET.$FTI1, Type (55,4). $SYSTEM.SYS00.SCFTRACE 02/20/91 10:38:29.900858 02/20/91 10:38:30.107204 02/20/91 10:40:18.223401 2000 Trace of shows the device type and subtype of the process that is traced.
Header Format OSI/TS Trace Facility DateStamp shows the date at which the trace record was captured. TimeStamp shows the time at which the trace record was captured. DeltaTime shows the amount of time (in seconds) that has passed since the previous trace record was captured. If the time reaches 999.999 or greater, then 999.999 is displayed. The deltatime is zero for the first record and for any record having a timestamp earlier than the previous record displayed.
MSG Trace Records OSI/TS Trace Facility MSG Trace Records These are the types, subtypes, and operations of MSG trace records: Type Subtype Operation MSG DSM MSG IO ABORT ACTIVATE ADD AGGREGATE ALLOWOPENS ALTER DELETE STOPOP VERSION INFO LISTOBJ LISTOP RESETSTATS START STOP STATUS STATS SUSPEND READ WRITE WRITEREAD MSG Pool Allocate Deallocate MSG Sys MSG Timer CANCELLED CLOSE CONTROL CONTROLBUF CPU DOWN CPU UP DEVICEINFO NETSTATUS CHANGED NODEDOWN OPEN POWER ON PROCESS ABENDED PROCDEATH PRO
Msg DSM OSI/TS Trace Facility Msg DSM This trace record shows an ADD SU request. This record is generated whenever a DSM application, TSP, or SCF send an ADD SU command to the TSP process. 17:05:08.070 >000.000 #6 Add SU Req Obj: $ZTI1.#za File: 5 Cnt: 556 Tag: 1 FE: 0 Msg DSM SU: #ZSPI Operation shows the operation performed, in this example, an Add SU request. Obj shows the object name, in this example, the name of the SU to be added. FE shows the file system error returned against this SU.
Msg DSM OSI/TS Trace Facility Msg DSM This trace record shows the previous display of an ADD SU request but with DETAIL ON, providing display and analysis of the DSM command. This record is generated whenever a DSM application or SCF send an ADD SU command to the TSP process. 17:05:08.070 >000.000 #6 Add SU Req Obj: $ZTI1.
Msg DSM OSI/TS Trace Facility ZRMT-TSEL Z-C " " ZTCON-PRI -1 " " ZL4-WIN -1 ZNETTYPE -1 ZCLASS -1 ZALT-CLASS -1 ZTPDU-SIZE 0 ZXSUM T ZEXTENDED-FRMT T ZMULTIPLEX T ZEXPEDITED T ZREXMIT-TIME -16843010 ZREF-TIME -16843010 ZMAX-REXMIT 0 ZINACTV-TIME -16843010 ZWIN-TIME -16843010 ZREASSIGN-SYNC-TRY-TIME -16843010 ZREASSIGN-SYNC-WAIT-TIME -16843010 ZCONN-WAIT-TIME -16843010 ZDISCONN-WAIT-TIME -16843010 ZX25PVC -1 ZIP-NULL-LAYER T ZIP-X25-SNDCF T ZX25CUG-TYPE -1 ZX25BCUG -1 ZX25RPOA -1 -1 -1 -1 -1 -1 -1 ZX25RP
Msg DSM OSI/TS Trace Facility 000: FFE4 0F3C .d.<.&TANDEM .? 008: 4400 0000 D...C.....~!.... 010: FFFF 0000 ......~F.x..~A.. 018: 021C 8001 ..........'...$Z 020: 5449 312E TI1.#za.. ..\ 028: 2020 2020 $ZTI1 030: 2020 2020 .... 038: 0007 1708 .....@.......... 040: FF07 0003 .......!..$X25A 048: 2020 FEFE 050: 2020 2020 058: 2020 2020 060: 2020 2020 068: 2020 2020 070: 2020 2020 078: 2020 2020 080: 2020 2020 088: 2020 2020 090: 2020 0000 098: 2020 2020 .......... 0A0: 0000 FFFF ........
Msg DSM OSI/TS Trace Facility SU shows the SU name. #ZSPI is the internal TSP SU name used to support the DSM interface. File shows the file number of the opener. The opener of the #ZSPI SU is usually the SCP process, $ZNET. The file number identifies the file number of the SCP process used to communicate with the TSP process. Cnt shows the message length. Tag shows the receive tag. <..detail..> shows DSM command information.
Msg DSM OSI/TS Trace Facility File shows the file number of the opener. The opener of the #ZSPI SU is usually the SCP process, $ZNET. The file number identifies the file number of the SCP process used to communicate with the TSP process. Cnt shows the message length. Tag shows the receive tag. Msg DSM This trace record shows the previous display of an ADD SU response but with DETAIL ON, providing display and analysis of the DSM command.
MSG IO OSI/TS Trace Facility Obj shows the object name, in this example, the name of the SU to be added. FE shows the file system error returned against this SU. For possible values, see the System Procedure Errors and Messages Manual. SU shows the SU name. #ZSPI is the internal TSP SU name used to support the DSM interface. File shows the file number of the opener. The opener of the #ZSPI SU is usually the SCP process, $ZNET.
Msg IO OSI/TS Trace Facility File shows the file number of the application opening the TSP SU. Syncid shows the sync id. Wrlen shows the length of the write buffer. Rdlen shows the length of the read buffer. SU shows the TSP SU name. <..P1:, P2:, P3:..> shows the content of first three words of the application buffer in decimal. If DETAIL ON was specified, the entire content of the request buffer is displayed.
MSG Pool OSI/TS Trace Facility SU shows the TSP SU name. If DETAIL ON was specified, the entire content of the request buffer is displayed. For the display to be complete, the trace record size must be large enough to contain the entire request buffer. MSG Pool The following trace record is for Compaq internal use and shows the allocation of a Request I/O Control Block (RIOCB). This record is for Compaq internal use only. 04/20/91 20:20:36.528325 >000.
MSG Sys OSI/TS Trace Facility File shows the file number. Syncid shows the sync id. Wrlen shows the message length. Rdlen shows the expected reply length. SU shows the TSP SU name. <..P1:, P2:, P3:..> shows the first three words of the system message buffer. If DETAIL ON was specified, the entire content of the system message buffer is displayed. For the display to be complete, the trace record size must be large enough to contain the entire system message buffer.
MSG Timer OSI/TS Trace Facility SU shows the TSP SU name. If DETAIL ON was specified, the entire content of the system message buffer is displayed. For the display to be complete, the trace record size must be large enough to contain the entire system message buffer. MSG Timer The following trace record is for Compaq internal use only and shows the starting of a timer. 04/20/91 20:20:37.798782 >000.
L4 Trace Records OSI/TS Trace Facility L4 Trace Records These are the types, subtypes, and operations of L4 trace records: Type Subtype Operation L4 Pool Allocate Deallocate L4 Queue Dequeue TCB NCB Active NCB Inactive Queue TCB L4 SM State Machine L4 TPDU AK (Acknowledge) CC (Connect Confirm) CR (Disconnect Request) DC (Disconnect Confirm) DR (Disconnect Request) DT (Data) EA (Expedited Acknowledge) ED (Expedited Data) ER (Error Report) RJ (Reject) L4 T-Primitive T-Abort T-Con T-Data T-D
L4 Queue OSI/TS Trace Facility SU shows the TSP SU. L4 Queue This trace record is for Compaq internal use and shows the queuing of control blocks. 09/10/91 11:20:47.874748 >000.000000 #48 Type: Queue TCB TCB[0]: 524306 NCB[0]: 1274324 L4 SU: Queue Type shows the action, here a TCB is being queued. TCB is the index and address of the transport connection control block (TCB). NCB is the index and address of the network connection control block (NCB).
L4 TPDU OSI/TS Trace Facility L4 TPDU This trace record shows the tracing of an outbound CC-TPDU. 17:33:15.340 >000.010 #54 L4 TPDU OUT CC-TPDU CDT: 4 Dst: 1 Src: 1 Class: 3 Ext-Frmt: NO Exp-Flwctl: YES TPDU Size: 4096 Option:N-Expedited(NO) Option:Receive Conf(NO) Option:No Checksum(NO) Option:T-Expedited(YES) Operation shows the TPDU being traced, in this example, an outbound CC-TPDU. <..The following lines..> show the various parameters in the CC TPDU.
L3 Trace Records OSI/TS Trace Facility Operation shows the transport primitive being traced, in this example, a transport connection request. BufLen shows the buffer length (in bytes). Addr shows the address of the internal buffer. SU shows the TSP SU name.
L3 ESIS PDU - ESH OSI/TS Trace Facility L3 ESIS PDU - ESH This trace record shows an outbound ESIS ESH-PDU. 10:31:33.070 >000.010 #10 ESH-PDU Version: 1 Length: 13 Checksum: %H0000 NSAP count: 1 NSAP 1: 1111 ESIS PDU OUT Holdtime: 10 Operation shows the record type, in this example, an ESIS ESH-PDU. Version shows the version of the protocol. Length shows the length of the PDU. Holdtime shows the time the remote end system or intermediate system should save this configuration information.
L3 ESIS PDU - RD OSI/TS Trace Facility Version shows the version of the protocol. Length shows the length of the PDU. Holdtime shows the time the remote end system or intermediate system should save this configuration information. Checksum shows the checksum value. IS NET: shows the network entity title of the originating intermediate system (or router). L3 ESIS PDU - RD This trace record shows an outbound ESIS RD-PDU. 10/18/91 10:07:19.203035 >000.
L3 RT OSI/TS Trace Facility Redirect NSAP: shows the NSAP address which is being redirected. Better SNPA: shows.the SNPA address which should be used to reach the redirected NSAP address. L3 RT This trace record is for Compaq internal use and shows the allocation of a L3 buffer pool. 04/24/91 14:32:25.641679 >000.007669 #118 Internal Lookup SNPA NIOCBAddr: 2120274 NSAP: 4908008E0002E3 MAC Addr: 09002B000004 L3-RT Operation shows the operation performed, in this example, buffer allocation.
L3 IPDU OSI/TS Trace Facility Niocb Addr shows the address of the control block. SU shows the TSP SU. L3 IPDU This trace record shows an inbound Data IPDU. 10:31:51.800 >000.000 #52 IP PDU Incoming IP PDU SU: #TSP1FE PDU Type: Data Flags: SegPermit ReportErrs Hdr Len: 21 User Data Len: 31 Lifetime: 30 Checksum: %H0000 Operation shows the direction of the IPPDU (Incoming).
L3 N-Primitive OSI/TS Trace Facility L3 N-Primitive This trace record is generated whenever a network attach is processes within the TSP process. 03/14/91 08:18:31.018549 >000.000000 #22 Primitive N-ATTACH request NCB Index: 0 Buflen: 0 SU: #ZTI1001 L3 Addr: 3443950 Operation shows the L3 primitive, in this example, an N-ATTACH request. NCB Index shows the index of the NCB into the NCB table. BufLen shows the buffer length (in bytes).
L3 Pool OSI/TS Trace Facility Addr shows the address of the control block representing the primitive. SU shows the NSP SU name. L3 Pool This trace record is for Compaq internal use and shows the allocation of a L3 buffer pool. 04/24/91 14:32:25.634010 >000.000000 #112 Alloc RIBCB Index: 1 Addr: 2073576 L3 Pool SU: Operation shows the operation performed, in this example, an Allocate RIOCB. Index shows the Table index of the control block. Addr shows the control block address. SU shows the TSP SU.
NetIO DSM OSI/TS Trace Facility Type Subtype Operation NETIO DSM ABORT ADD DELETE INFO NETIO IO CLOSE CONTROL OPEN READ SETMODE SETPARAM WRITE NETIO Pool Allocate Deallocate NETIO Timer Timer Start Timer Stop NetIO DSM This trace record shows an SPI command to the NSP process. In this case the TSP process attempts to add an SU to an X25AM line. 17:33:04.360 >000.780 #23 Net IO DSM Add SU Req Obj: \COMM.$X25A.
NetIO DSM OSI/TS Trace Facility Cnt shows the length of the request buffer (in bytes). Tag shows the I/O operation tag. NetIO DSM This trace record shows the response from the NSP process to a previous ADD SU command. 17:33:04.830 >000.470 #25 Net IO DSM Add SU Rsp Obj: \COMM.$X25A.#ZTI1001 File: 3 Cnt: 100 Tag: 2104188 FE: 0 Retcode: 0 Operation shows the operation performed, in this example, the response of the X25AM IOP $X25A to the ADD SU command.
NetIO DSM OSI/TS Trace Facility SU to an X25AM line was rejected by SCP. DETAIL is ON to show a formatted display of the SPI response buffer. The SPI return code is -22 which is the standard data communication return code for security violation error. 13:28:27.790 >000.020 #25 Net IO DSM Add SU Rsp Obj: \COMM.$X25A.
NetIO DSM OSI/TS Trace Facility File shows the file number used by the TSP process. Cnt shows the length of the reply buffer (in bytes). Tag shows the I/O operation tag. <..detail..> shows DSM command information. The column at the left side shows the name of the SPI tokens or fields within a data structure. See the OSI/TS Management Programming Manual for parameter descriptions. NetIO DSM This trace record shows a negative response from X25AM due to invalid parameter value.
NetIO DSM OSI/TS Trace Facility 14:01:55.680 >000.000 #23 Net IO DSM Add SU Rsp Obj: \COMM.$X25A.
NetIO IO OSI/TS Trace Facility FE shows the file system error returned against this SU. For possible values, see the System Procedure Errors and Messages Manual. Retcode shows and the SPI return code. File shows the file number used by the TSP process. Cnt shows the length of the reply buffer (in bytes). Tag shows the I/O operation tag. <..detail..> shows DSM command information. The column at the left side shows the name of the SPI tokens or fields within a data structure.
NetIO IO OSI/TS Trace Facility File shows the file number of the NSP SU as stored inside the TSP process. SU shows the NSP SU name. If the IO contains data, you can display this data by specifying DETAIL ON. NetIO IO This trace record is generated when the TSP process wants to wait for a network connection. 17:33:04.980 >000.090 #27 Control-11 Req Cnt: 0 File: 4 SU: #ZTI1001 FE: 0 Net IO Tag: 2071436 Operation shows the operation performed, in this example, a Control-11 Request.
NetIO IO OSI/TS Trace Facility NetIO IO This trace record shows the response of the NSP process to a previous CONTROL-11 request indicating that a network connection request has arrived. 17:33:14.720 >009.740 #29 Control-11 Rsp Cnt: 0 File: 4 SU: #ZTI1001 FE: 0 Net IO Tag: 2071436 Operation shows the operation performed, in this example, the response from X25AM to a passive connect request. Cnt shows the length of the response buffer (in bytes).
NETIO Pool OSI/TS Trace Facility Len shows the length (in bytes) of the buffer to be allocated. Addr shows the address of the buffer. SU shows the TSP SU.
A OSI/TS SCF Command Syntax Summary ABORT Command Use the ABORT command to terminate the operation of objects as quickly as possible. This is a sensitive command. ABORT [ /OUT file-spec/ ] [ object-spec ] The object-spec is: object-type object-name PROCESS SU tsp-process-name su-name ACTIVATE Command Use the ACTIVATE command to return a suspended TSP process to the STARTED state. This is a sensitive command.
OSI/TS SCF Command Syntax Summary The object-spec is: object-type object-name SU su-name OSI/TS SCF Reference Manual—424832-001 A- 2 ADD Command
ADD SU Command OSI/TS SCF Command Syntax Summary ADD SU Command An attribute-spec for the ADD SU command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ { [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ALTCLASS { 0 | 1 | 2 | 3 | 4 } ] CHECKSUM { ON | OFF } ] CLASS { 0 | 1 | 2 | 3 | 4 } ] CONNECTTIMEOUT time ] DELETETIME { -1 | 0 } ] DISCONNECTTIMEOUT time ] EXPEDITED { ON | OFF } ] EXTENDEDFORMAT { ON | OFF } ] INACTIVETIMEOUT time ] IPNULLLAYER {
OSI/TS SCF Command Syntax Summary AGGREGATE Command AGGREGATE Command Use the AGGREGATE command to display the number of subdevices in the STARTED state and in the STOPPED state, as well as the total number of subdevices in other states. AGGREGATE [ /OUT file-spec/ ] [ object-spec ] The object-spec is: object-type object-name PROCESS tsp-process-name ALLOWOPENS Command Use the ALLOWOPENS command to permit file-system opens to be issued to a subdevice.
OSI/TS SCF Command Syntax Summary ALTER PROCESS Command ALTER PROCESS Command An attribute-spec for the ALTER PROCESS command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ LANDFC integer ] LANDFT integer ] LANEXPANDIOSIZE integer ] LANIOSIZE integer ] LANREADS integer ] LANWRITES integer ] MAXCONNECTIONS integer ] PRIORITY integer ] RECEIVEDEPTH integer ] RECEIVESIZE integer ] OSI/TS SCF Reference Manual—424832-001 A- 5
OSI/TS SCF Command Syntax Summary ALTER SERVICE #L3 Command ALTER SERVICE #L3 Command An attribute-spec for the ALTER SERVICE #L3 command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ESISCHECKSUM { ON | OFF } ] ESISENABLE { ON | OFF } ] ESISESCONFTIME time ] ESISESGROUPMACADDR { “address” | RESET } ] ESISHOLDTIME time ] ESISISGROUPMACADDR { “address” | RESET } ] ESISNOTIFYIS { ON | OFF } ] ESISQUERYRETRY integer
OSI/TS SCF Command Syntax Summary ALTER SERVICE #L4 Command ALTER SERVICE #L4 Command An attribute-spec for the ALTER SERVICE #L4 command is one of the following attribute name and value combinations: [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ALTCLASS { 0 | 1 | 2 | 3 | 4 } ] CHECKSUM { ON | OFF } ] CHECKTSEL { ON | OFF } ] CLASS { 0 | 1 | 2 | 3 | 4 } ] CONNECTTIMEOUT time ] DISCONNECTTIMEOUT time ] EXPEDITED { ON | OFF } ] EXTENDEDFORMAT { ON | OFF } ] INACTIVETIMEOUT time ] INBOUNDCRCONF
OSI/TS SCF Command Syntax Summary CHECK SU Command CHECK SU Command An attribute-spec for the CHECK SU command is one of the following select name and value combinations: [ [ [ [ [ [ DISPLAY { UP | DOWN | ALL | ONE } ] ERRORONLY ] LOCALNSAP string ] LOCALTSEL string ] OPENER process-name ] USER group-id , user-id ] DELETE Command Use the DELETE command to remove subdevices controlled by TSP. This is a sensitive command.
OSI/TS SCF Command Syntax Summary NAMES Command The object-spec is: object-type object-name SU su-name NAMES Command Use the NAMES command to display a list of the subordinate object names and types for the specified object.
OSI/TS SCF Command Syntax Summary STATS Command The object-spec is: object-type object-name PROCESS SU tsp-process-name su-name STATS Command Use the STATS command to display statistical information for the specified object. This is a sensitive command only when the RESET option is specified.
OSI/TS SCF Command Syntax Summary STOPOPENS Command The object-spec is: object-type object-name PROCESS SU tsp-process-name su-name STOPOPENS Command Use the STOPOPENS command to prevent further file-system opens from being issued to an object without disrupting any of the current activity.
TRACE Command OSI/TS SCF Command Syntax Summary TRACE Command Use the TRACE command to collect trace information between a TSP process and its environment (user applications, network service provider processes). This is a sensitive command. TRACE [ /OUT file-spec/ ] [ object-spec ] { , STOP [ , BACKUP ] { [ , BACKUP [ , COUNT count [ , NOCOLL [ , PAGES pages [ , RECSIZE size [ , SELECT select-spec [ , TO file-spec [ , WRAP } ] ] ] ] ] ] ] ] *** } *** This attribute is required when a trace is started.
OSI/TS SCF Command Syntax Summary OSI/TS SCF Reference Manual—424832-001 A -13 VERSION Command
OSI/TS SCF Command Syntax Summary OSI/TS SCF Reference Manual—424832-001 A -14 VERSION Command
B OSI/TS SCF Error Messages This appendix describes two types of SCF error messages that apply to the OSI/TS subsystem. Messages with positive error numbers are generated by the OSI/TS subsystem. Messages without error numbers are generated during command parsing and are generally self explanatory. In a few cases, however, additional information needs to be provided. These cases are documented in this appendix. Note The SCF OSI/TS online help only documents errors with positive numbers.
Error Messages With Positive Numbers OSI/TS SCF Error Messages OSI/TS Error 00008 OSI/TS 00008 Attribute attribute-name required for object-name Cause. A required attribute is missing for the command that was entered. Recovery. Check that all required attributes are entered for this command. OSI/TS Error 00011 OSI/TS 00011 STOP failed: Object is currently active Cause. You attempted to stop the TSP process while one or more SUs are open. Recovery.
Error Messages With Positive Numbers OSI/TS SCF Error Messages OSI/TS Error 00018 OSI/TS 00018 Guardian procedure call error%herror-number :procedure-name Cause. An error occurred after a call was made to a Guardian 90 procedure. Recovery. Contact your Compaq representative immediately. OSI/TS Error 01000 OSI/TS 01000 Internal error: case value out of range Cause. An invalid case value was generated with no associated case label. Recovery. Contact your Compaq representative immediately.
Error Messages Without Numbers OSI/TS SCF Error Messages Error Messages Without Numbers Messages without error numbers are generated during command parsing and are generally self explanatory. In a few cases, however, additional information needs to be provided. These cases are documented in this appendix. Error: subsystem-name subquery retcode nn Cause.
C Examples of Command Files This appendix contains examples of command EDIT files of Guardian and SCF commands used to set up particular subsystem configurations. Because each of these examples contain a mixture of SCF and other commands, use the TACL OBEY command to invoke the appropriate file. The five examples configurations are as follows: • • • • • OSI/TS on an X.25 network OSI/TS on an X.
OSI/TS on an X.25 Network Examples of Command Files OSI/TS on an X.25 Network This is an example of a command file to configure a generic (no SNDCF) loopback test over an X.25 Telenet network. In this configuration, there are two TSP processes on the same system which connect via an X.25 network (in other words, data goes from one process, out through the X.25 network, and back to the same system, to the responding process).
OSI/TS on an X.25 Network Examples of Command Files == (using X25AM). SCF must be running before you use the == OBEY command to invoke this file. == == NOTE: To use this command file for your subsystem, you == must supply names and addresses that reflect your == environment. ============================================================= == allow all errors == == Abort any processes and subdevices that are running and == that have the same name as you are configuring. == abort su ($tsp1.*, $tsp2.
OSI/TS on an X.25 Network Examples of Command Files , localtsel "3503" , altclass 2, , x25port 8 multiplex on & & == start su ($tsp1.*, $tsp2.
Examples of Command Files OSI/TS on X.25 Network with SNDCF and Full-IP OSI/TS on X.25 Network with SNDCF and Full-IP This is an example of a command file to configure a loopback test over an X.25 network, using SNDCF. In this configuration, there are two TSP processes: $tsp1 is the local process (the initiator), and $tsp2 is the remote process (the responder). Each TSP process has SNDCF enabled and is configured with one subdevice. Connections can be made between the two SNDCF subdevices.
OSI/TS on a LAN with Full-IP and no ES-IS Examples of Command Files OSI/TS on a LAN with Full-IP and no ES-IS This is an example of a command file to configure a generic (no ES-IS routing exchange protocol) loopback test over a LAN. In this configuration, there are two TSP processes on the same system which connect via a LAN (in other words, data goes from one process, out over the LAN, and back to the same system, to the responding process).
Examples of Command Files OSI/TS on a LAN with Full-IP and no ES-IS == that have the same name as you are configuring. == abort su ($tsp1.*, $tsp2.*) == Allow time to clean up all SUs. delay 10 abort process ($tsp1, $tsp2) == == Run TSPOBJ to create and start the TSP processes.
OSI/TS on a LAN with Full-IP and ES-IS Examples of Command Files OSI/TS on a LAN with Full-IP and ES-IS This is an example of a command file to configure a loopback test over a LAN, using ES-IS routing exchange protocol. In this configuration, there are two TSP processes: $tsp1 is the local process (the initiator), and $tsp2 is the remote process (the responder). Each TSP process has ES-IS routing exchange protocol enabled, and is configured with two subdevices.
OSI/TS on a LAN with Full-IP and ES-IS Examples of Command Files == In addition, the value for LANLOCALSNPA is automatically == determined by OSI/TS. ============================================================= add su $tsp1.#esis1a, nspdevice $lam1 & , remotetsel "22aa" & , localnsap "11aa", remotensap "22aa" add su $tsp1.#esis1b, like $tsp1.#esis1a & , remotetsel "22bb" ============================================================= == Add remote (responding) subdevices.
Examples of Command Files OSI/TS on a LAN with Full-IP and ES-IS == previous, generic, LAN example command file. ============================================================= alter service ($tsp1.#L3, $tsp2.#L3), ipnulllayer on & , esisenable off alter service ($tsp1.#L4, $tsp2.#L4), class 4 ============================================================= == Add and start local (initiating) subdevice. == The MAC address of $lam1 is 08008e000018. == The MAC address of $lam2 is 08008e0002e3.
Configuring Large X.25 Applications Examples of Command Files Configuring Large X.25 Applications This subsection describes some options for configuring OSI/TS and X25AM to support large applications. To control X25AM lines, there are two options: • • A single TSP process that supports all X25AM lines One TSP process for each X25AM line The advantages and limitations of each option are described in the following subsections.
Single TSP Process Supporting Multiple X25AM Lines Examples of Command Files Figure C-3. Large Application Configuration: Single TSP for Multiple X25AM Lines Transport Layer $TSP1 Network Layer $X25A $X25B $X25C $X25D (X25AM) (X25AM) (X25AM) (X25AM) Data Link Layer 025 Because transport connect requests can arrive on any of the lines at any time, there must be at least one transport connect attach outstanding on one of the TSP subdevices for each X25AM line.
Examples of Command Files • Single TSP Process Supporting Multiple X25AM Lines Startup time. The startup time may be longer if a large number of subdevices need to be added before any connection is established. Command File for a Single TSP Process Supporting Multiple X25AM Lines In this next example command file, a single TSP process supports four X25AM lines. Each line is configured for three subdevices. (In reality, the number of TSP subdevices for each line would be much larger.
Examples of Command Files One TSP Process Supporting Each X25AM Line abort,sub all alter, framemode dce, svcrange (10,60), netid telenet, & srcaddr "8765", pvcrange (1,9) start status $x25d, sub, detail == version process $tsp1 ============================================================= == Add subdevices for line $X25A ============================================================= add su $tsp1.#las01, nspdevice $x25a, x25port 01 & , localtsel "31", class 3 add su $tsp1.#las02, like $tsp1.
One TSP Process Supporting Each X25AM Line Examples of Command Files Figure C-4. Large Application Configuration: Single TSP for Each X25AM Line Transport Layer $TSP1 $TSP2 $TSP3 $TSP4 $X25A (X25AM) $X25B (X25AM) $X25C (X25AM) $X25D (X25AM) Network Layer Data Link Layer 030 Because transport connect requests can arrive on any line at any time, there must be at least one transport connect attach outstanding on one of the TSP subdevices for each X25AM line.
Examples of Command Files One TSP Process Supporting Each X25AM Line network is not very reliable and generates many network disconnections. This can occur when a remote Transport Layer entity resynchronizes a transport connection, which causes a new network connection to be established. This new network connection does not necessarily arrive at the same TSP process that is participating in the resynchronizing process.
Examples of Command Files One TSP Process Supporting Each X25AM Line abort,sub all alter, framemode dce, svcrange (10,60), netid telenet, & srcaddr "4321", pvcrange (1,9) start status $x25b, sub, detail == assume line $x25c abort,sub all alter, framemode dce, svcrange (10,60), netid telenet, & srcaddr "5678", pvcrange (1,9) start status $x25c, sub, detail == assume line $x25d abort,sub all alter, framemode dce, svcrange (10,60), netid telenet, & srcaddr "8765", pvcrange (1,9) start status $x25d, sub, deta
Examples of Command Files One TSP Process Supporting Each X25AM Line OSI/TS SCF Reference Manual—424832-001 C -18
D OSI/TS SCF Attribute Name Changes Some attribute names were changed in the C30 release to improve product usability. All changes maintain backward compatibility—existing programs or command files will still work with the original names. The following tables list the terms that were changed.
OSI/TS SCF Attribute Name Changes OSI/TS SCF Reference Manual—424832-001 D- 2 ALTER SU Command
E OSI/TS Command Support Table E-1, SCF Command Support identifies the SCF commands that can be issued to the OSI/TS subsystem and the commands that are not supported. The SCF/TS specific supported commands are documented in Section 2 of this manual. General SCF supported commands can be issued to the OSI/TS, and are documented in the Subsystem Control Facility (SCF) Reference Manual. Table E-1.
OSI/TS Command Support Table E-1.
OSI/TS Command Support Table E-1.
OSI/TS Command Support OSI/TS SCF Reference Manual—424832-001 E- 4
F OSI/TS SCF Status SU X.25 Values This appendix contains values for the following three fields in the detailed STATUS SU display shown below. • • • X25ClearCause X25DiagCode X25DisconReason OSITS Detailed Status SU $MTS0.#Z123123 State........ TC-State..... TC-SubState.. Opener....... NSP SU....... STARTED TCon in progress waiting for CR-TPDU \COMM.$MAS0 \COMM.$X25A.#MTS0001 StopOpens.... OFF Opens........ 1 Opener Id.... 255,017 NSP Subsys....... X25AM FileError........ 0 NSPDSMRetCode....
X25ClearCause OSI/TS SCF Status SU X.25 Values Table F-1.
X25DiagCode OSI/TS SCF Status SU X.25 Values X25DiagCode Table F-2 (including the associated notes at the end of the table) is a copy of Table 14-B, “Coding of the Diagnostic Code Field,” from ISO 8208, “Telecommunications and Information Exchange Between Systems.” Table F-2. X25 DiagCode Values 1 Decimal Value Applicable Packets (Note 1) 0 0 0 D, Rr, C, Re, Rg 0 0 1 1 Re 0 1 0 2 Re . .
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-3.
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-4.
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-5.
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-6. X25 DiagCode Values: Miscellaneous Decimal Value Applicable Packets (Note 1) Diagnostic Bits 8 7 Miscellaneous 0 1 0 1 0 0 0 0 80 Rr, C, Re improper cause code from DTE 0 1 0 1 0 0 0 1 81 D, Rr, C, Re nonoctet aligned 0 1 0 1 0 0 1 0 82 D, Rr, C, Re inconsistent Q-bit settings 0 1 0 1 0 0 1 1 83 Re . . . . . . . . 0 1 0 1 1 1 1 1 95 0 1 1 0 0 0 0 0 96 . . . . . . . .
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-7. X25 DiagCode Values: Miscellaneous Network 1 Decimal Value Applicable Packets (Note 1) 0 0 120 C 0 0 1 121 C 1 0 1 0 122 Rr, C, Re . . . . . 1 1 1 1 1 1 127 0 0 0 0 0 0 0 128 . . . . . . . .
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-7. X25 DiagCode Values: Miscellaneous Network 1 Decimal Value Applicable Packets (Note 1) 1 0 166 C, Re 1 1 1 167 Rg . . . . 0 1 1 1 1 175 1 1 0 0 0 0 176 . . . . . .
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-7. X25 DiagCode Values: Miscellaneous Network 1 Decimal Value Applicable Packets (Note 1) 1 1 231 C 0 0 0 232 C 1 0 0 1 233 Re 0 1 0 1 0 234 Re 1 0 1 0 1 1 235 C . . . . . .
X25DiagCode OSI/TS SCF Status SU X.25 Values Table F-8.
X25DisconReason OSI/TS SCF Status SU X.25 Values Table F-8. X25 DiagCode Values: Disconnection Diagnostic Bits 8 7 6 5 4 3 2 reset - user resynchronization 1 1 1 1 1 0 1 . . . . . . . 1 1 1 1 1 1 1 1 Decimal Value Applicable Packets (Note 1) 0 250 Re 1 255 X25DisconReason Table F-3 is taken from Table 4-12, “Reasons for Circuit Disconnection,” from the X.25 Access Method (X25AM) Manual. Table F-9. X25DisconReason Values This Word ... With This Value ...
X25DisconReason OSI/TS SCF Status SU X.25 Values Table F-9. X25DisconReason Values This Word ... With This Value ... Indicates This Reason for Circuit Disconnection ... Integer <1> nnn If <0> = 14, then <1> contains the applicable Guardian error code. Integer <2> 1 The line is logically down. (It has been downed with PUP or stopped with SCF or CMI). 2 The line is logically up, but the physical circuit has not been established.
OSI/TS SCF Status SU X.
Glossary The following glossary defines terms used in this manual and in the other Compaq OSI product manuals. Not all terms listed here are used in this particular manual. action event. An event that requires operator intervention. Each subsystem determines which events are action events by including a unique Event Management Service (EMS) token in the event message.
connection-establishment phase Glossary connection-establishment phase. The phase of an Open Systems Interconnection (OSI) connection during which the connection is created. Compare data-transfer phase or connection-release phase. connection-release phase. The phase of an Open Systems Interconnection (OSI) connection during which the connection is relinquished. This phase begins when an application initiates a release request or when an application or the service provider aborts the connection.
EMS Glossary configure Compaq OSI subsystem objects, but it can be used to configure the underlying X.25 Access Method (X25AM) and Tandem LAN Access Method (TLAM) objects. EMS. See Event Management Service (EMS). end system. A host or user machine that contains all seven Open Systems Interconnection (OSI) layers. An end system can communicate with another end system either directly or through one or more intervening intermediate systems. Compaq systems function as end systems only.
ITU Glossary Transmission Control Protocol/Internet Protocol (TCP/IP); the two protocols are similar but not identical. The OSI Internet protocol defines communications in the Network Layer. ITU. See International Telecommunications Union–Telecommunications (ITU–T). layer. There are seven layers in the Open Systems Interconnection (OSI) Reference Model: Application Layer, Data Link Layer, Network Layer, Physical Layer, Presentation Layer, Session Layer, and Transport Layer.
nonsensitive command Glossary (X25AM), NonStop TCP/IP, and Tandem LAN Access Method (TLAM) subsystem [replaced by the Port Access Method (PAM) subsystem for G-series releases]. nonsensitive command. A Distributed Systems Management (DSM) command that can be issued by any user or program allowed access to the target subsystem—that is, a command on which the subsystem imposes no further security restrictions.
OSI/AS Glossary OSI/AS. A communications subsystem that provides the services of the Open Systems Interconnection (OSI) Session Layer and Presentation Layer and the called address component of the Application Layer, allowing Compaq applications to communicate with other applications in a multivendor environment. OSI/FTAM.
presentation context Glossary D-series releases) or the Port Access Method (PAM) (for G-series releases) lines, the address used by TLAM or PAM to specify the address of the connection to a local area network (LAN) controller. Preferred binary encoding method. presentation context. The combination of an abstract syntax and assignment of a transfer syntax to each on a Presentation Layer connection.
protocol control information (PCI) Glossary protocol control information (PCI). Information exchanged between peer entities to coordinate their joint operation within a specific layer. protocol data unit (PDU). Information delivered as a unit between peer entities that contains data and/or control and address information. register request.
Service primitive Glossary Service primitive. An abstract, implementation-independent interaction between a service user and a service provider. Service primitives describe the sequences of events between adjacent layers that occur through the service access point (SAP). There are four types of service primitives: connection-establishment phase, Request primitive, and Response primitive. session.
subnetwork Glossary connection; it can be dynamically created and deleted or it can be reused after the connection is released. A ViewPoint subdevice corresponds to an X.25 network virtual circuit. Tandem LAN Access Method (TLAM) subdevices are of several types: FSAPs, ports, services, domains, workstations, windows, and gateways [for G06 and above release, Port Access Method (PAM) subdevices correspond to PAM ports]. subnetwork.
summary state Glossary for inclusion in programs, macros, and routines using the SPI procedures; and definition files in DDL for programmers writing their own subsystems. summary state. In Distributed Systems Management (DSM) interfaces to Compaq data communications subsystems, a summary state is one of the generally defined possible conditions of an object, with respect to the management of that object. A summary state differs from a state in two ways.
token bus Glossary local application. There are four session tokens; each is associated with a functional unit. The availability of each token depends on which functional units are used on the connection. (2) In Distributed Systems Management (DSM) terms, a distinguishable unit in a Subsystem Programmatic Interface (SPI) message. token bus. The IEEE 802.
transport service user Glossary and for the Internet Protocol (IP) of the network service provider (NSP) process. TSP processes are provided by the underlying OSI/TS subsystem. transport service user. An abstract representation of all entities within a single system that make use of the transport service. TSAP. See transport selector (TSEL). TSDU. See transport service data unit (TSDU). TSEL. See transport service provider (TSP) process. ViewPoint.
X.
Index A ADD command ADD SU request, example trace records 3-21/3-25, 3-42 ADD SU response, example trace records 3-25/3-27, 3-43/3-47 considerations 2-27 examples 2-31 Addressing conventions See X25REMOTENET attribute AGGREGATE command AGGREGATE PROCESS display 2-31 example 2-32 syntax 2-31 ALLOWOPENS command considerations 2-32 examples 2-32 syntax 2-32 ALTCLASS attribute used in ALTER SERVICE L4 2-46 used in ALTER SU 2-55 ALTER command ALTER PROCESS attribute-spec 233/2-35 ALTER SERVICE L3 attribute-spec
D Index Configuration, displaying information See nonsensitive commands Connection indication, example trace records 3-40 waiting for, example trace record 3-48 Connections checking 2-67 maximum number of See MAXCONNECTIONS attribute restricting use 2-129 CONNECTTIMEOUT attribute used in ALTER SERVICE L4 2-47 used in ALTER SU 2-56 Control block, example trace record 3-29 CONTROL-11 response, example trace record 3-49 CPUs, switching primary and backup 2-107 CR-TPDU, example trace record 3-34 D Data IPDU,
Index F File header record, in traces 3-18 File-system opens displaying 2-103 preventing 2-129 FILTER command, PTrace considerations 3-11 example commands 3-12 syntax 3-4/3-11 G Gateway Programmatic Interface (GPI) Glossary-6 Getting Help 3-17 GPI Glossary-6 H Header record, in traces 3-18 Help option,PTrace 3-5 Help, with collecting trace information 3-17 HEX command, PTrace 3-12 I INACTIVETIMEOUT attribute used in ALTER SERVICE L4 2-48 used in ALTER SU 2-56 INBOUNDCRCONFERRTHLD attribute used in ALTER
L Index used in ALTER SERVICE L3 2-40 used in ALTER SU 2-56 IPX25SNDCF1980ADDR attribute used in ALTER SERVICE L3 2-40 I/O buffer size See LANEXPANDIOSIZE and LANIOSIZE attributes L L3 option, PTrace 3-14 L3 trace records ESIS PDU OUT 3-36, 3-37 L3 IP 3-38 L3 IPDU 3-39 L3 N-Primitive 3-40/3-41 L3 RI 3-38 L3INTERNALS option, PTrace 3-9 L3SERVICES option, PTrace 3-10 L4 option, PTrace 3-14 L4 trace records L4 POOL 3-32 L4 Queue 3-33 L4 SM 3-33 L4 TPDU IN 3-34 L4 TPDU OUT 3-34 types and subtypes 3-32 T-PRIM
N Index MSG SYS 3-29, 3-31 MSG TIMER 3-31 types and subtypes 3-20 MSGDSM option, PTrace 3-6 MSGINTERNALS option, PTrace 3-7 MSGSU option, PTrace 3-7 MSGSYS option, PTrace 3-5 MULTIPLEX attribute used in ALTER SERVICE L4 2-50 used in ALTER SU 2-58 N NAMES command considerations 2-107 examples 2-107 NAMES null display 2-105 NAMES PROCESS displays 2-105 NAMES SERVICE display 2-106 NAMES SU display 2-106 syntax 2-104 NETIO option, PTrace 3-14 NETIO trace records NETIO DSM 3-43/3-47 NETIO IO 3-47/3-49 NETIO P
P Index OUTBOUNDTPDUPROTOERRTHLD attribute used in ALTER SERVICE L4 2-51 P PASSIVEMUX attribute used in ALTER SERVICE L4 2-51 Permanent virtual circuit See PVC Port Access Method (PAM) general description of Glossary-6 PRIMARY command considerations 2-108 example 2-108 syntax 2-107 Priority See PRIORITY, TCONPRI and X25PRICALL attributes PRIORITY attribute used in ALTER PROCESS 2-34 process name See PROCESS object, name format PROCESS object example commands AGGREGATE 2-32 ALTER 2-66 INFO 2-102 NAMES 2-1
R Index R RECEIVE file data or events, displaying 313 RECEIVEDEPTH attribute used in ALTER PROCESS 2-34 RECEIVESIZE attribute used in ALTER PROCESS 2-35 Recognized Private Operating Agency See X25RPOA attribute RECVSECURITY attribute used in ALTER SERVICE L4 2-52 used in ALTER SU 2-59 REFTIMEOUT attribute used in ADD SU 2-21 used in ALTER SERVICE L4 2-52 used in ALTER SU 2-59 REMOTENSAP attribute used in ADD SU 2-22 used in ALTER SU 2-60 REMOTETSEL attribute used in ADD SU 2-22 used in ALTER SU 2-60 Reset
T Index examples 2-119 STATS PROCESS display 2-110/2-112 STATS SERVICE L3 display STATS SERVICE L4 display STATS SU display 2-118 syntax 2-109 STATUS command examples 2-127 STATUS PROCESS displays 2-120/2122 STATUS SU displays 2-122/2-127 syntax 2-120 STOP command considerations 2-128 examples 2-128 syntax 2-128 STOPOPENS command considerations 2-129 examples 2-129 syntax 2-129 SU object example commands ADD 2-31 ALLOWOPENS 2-32 ALTER 2-66 CHECK 2-83 DELETE 2-84 INFO 2-102 LISTOPENS 2-104 NAMES 2-107 STAR
U Index TPDUSIZE attribute used in ADD SU 2-23 used in ALTER SERVICE L4 2-53 used in ALTER SU 2-61 TRACE command command examples 2-133 considerations 2-133 general description 3-1 syntax 2-130/2-132 Trace record displays See PTrace Trace Record Header record, in traces 3-18 Transport Layer events and actions, displaying 3-14 internal operations, displaying 3-7 TSP processes events and actions, displaying 3-14 TTRTIMEOUT attribute used in ADD SU 2-23 used in ALTER SERVICE L4 2-53 used in ALTER SU 2-61 TWR
X Index used in ALTER SERVICE L3 2-42 used in ALTER SU 2-62 X25DISCONNECTDELAY attribute used in ALTER SERVICE L3 2-42 X25NCONMULTIPLEX attribute used in ALTER SERVICE L3 2-42 X25NEGOTIATE attribute used in ADD SU 2-25 used in ALTER SERVICE L3 2-42 used in ALTER SU 2-62 X25NONEGOTIATE attribute used in ADD SU 2-25 used in ALTER SERVICE L3 2-43 used in ALTER SU 2-63 X25PORT attribute used in ADD SU 2-25 used in ALTER SERVICE L3 2-43 used in ALTER SU 2-63 X25PRICALL attribute used in ADD SU 2-25 used in ALT
