background image

TR3271 SUBSYSTEM DDL

?PAGE "TR3271 RESETSTATS command STRUCT for SU object"
?SECTION    ZTR3-DDL-RSTATS-SU
?SETSECTION ZTR3-DDL-RSTATS-SU
?TALBOUND   0
!
! ZTR3-DDL-RSTATS-SU :
!
!          This DDL is returned to the requester from TR3271
!          whenever a RESETSTATS SU command is processed.
!
DEF ZTR3-DDL-RSTATS-SU.

02 Zreset-time                 TYPE ZSPI-DDL-TimeStamp.
02 Zsample-time                TYPE ZSPI-DDL-TimeStamp.
02 Zerr                        TYPE ZSPI-DDL-Int.
02 Zmsg-sent                   TYPE ZSPI-DDL-Int.
02 Zmsg-recved                 TYPE ZSPI-DDL-Int.

END.

TOKEN-MAP  ZTR3-MAP-RSTATS-SU        VALUE IS ZTR3-TNM-RSTATS-SU

DEF   IS ZTR3-DDL-RSTATS-SU.
VERSION  "C20" FOR

Zreset-time THRU
Zmsg-recved.

END.

?PAGE "TR3271 STATUS command STRUCT for SU object"
?SECTION    ZTR3-DDL-STATUS-SU
?SETSECTION ZTR3-DDL-STATUS-SU
?TALBOUND   0
!
! ZTR3-DDL-STATUS-SU :
!
!    This DDL is returned to requester from TR3271 whenever a
!    STATUS SU command is processed.
!
DEF ZTR3-DDL-STATUS-SU.

02 ZSDN                     TYPE ZSPI-DDL-Int.
02 ZState                   TYPE ZSPI-DDL-Enum.
02 ZStatus                  TYPE ZSPI-DDL-Int.
02 ZFlags                   TYPE ZSPI-DDL-Int.
02 ZLast-Err                TYPE ZSPI-DDL-Int.
02 ZIS-PTP                  TYPE ZSPI-DDL-Boolean.
02 ZHIS-SYSNUM              TYPE ZSPI-DDL-Int.
02 ZHIS-LDEV                TYPE ZSPI-DDL-Int.
02 ZHIS-SDN                 TYPE ZSPI-DDL-Int.
02 ZHIS-CU                  TYPE ZSPI-DDL-Int.
02 ZHIS-DA                  TYPE ZSPI-DDL-Int.

END.

TOKEN-MAP  ZTR3-MAP-STATUS-SU       VALUE IS ZTR3-TNM-STATUS-SU

DEF   IS ZTR3-DDL-STATUS-SU.
VERSION  "C20" FOR
ZSDN THRU ZHIS-DA.
END.

B-12

Summary of Contents for TR3271

Page 1: ...rporated TR3271 Management Programming Manual Abstract This manual describes the control and inquiry interface and the event messages available to an application program controlling or monitoring the TR3271 subsystem This manual is for programmers Part Number 14948 ...

Page 2: ...ch 1989 New editions incorporate any updates issued since the previous edition Copyright All rights reserved No part of this document may be reproduced in any form including photocopying or translation to another language without the prior written consent of Tandem Computers Incorporated Copyright 1989 Tandem Computers Incorporated ...

Page 3: ...stem 2 11 SECTION 3 ELEMENTS OF SPI MESSAGES FOR THE SUBSYSTEM 3 1 Definition Files 3 2 Naming Rules and Guidelines for Applications 3 4 Common Syntax Elements for the Subsystems 3 4 Command Numbers 3 4 Object Types 3 5 Object Names 3 6 Event Numbers 3 7 Subjects of Event Messages 3 7 Tokens 3 8 Constructs Involving Multiple Tokens 3 11 Components of a Command Response and Event 3 11 SECTION 4 SPI...

Page 4: ...nd 6 31 DELETE Command 6 36 DISCONNECT Command 6 41 GETVERSION Command 6 46 INFO Command 6 50 LISTOBJECTS Command 6 63 LOAD Command 6 68 RESET Command 6 72 RESETSTATS Command 6 76 START Command 6 84 STATISTICS Command 6 89 STATUS Command 6 97 STOP Command 6 108 SWITCH Command 6 114 TRACE Command 6 119 SECTION 7 TR3271 EVENT MANAGEMENT 7 1 Subsystem Processes That Report Events 7 1 Critical Events ...

Page 5: ...ple 1 7 72 Example 2 7 73 APPENDIX A ERROR NUMBERS AND ERROR LISTS A 1 Notation Used A 1 2 ZTR3 ERR CLIP PROB A 3 3 ZTR3 ERR TARGET OBJ NOT FOUND A 4 4 ZTR3 ERR ATTR CONFL SU A 5 5 ZTR3 ERR NOT PTP SU A 7 6 ZTR3 ERR ALRDY USING ADDR A 8 7 ZTR3 ERR NO OBJ IN SEL STATE A 9 8 ZTR3 ERR OPENED SU EXIST A 10 10 ZTR3 ERR TARGET OBJNAME INV A 11 11 ZTR3 ERR NO OWNER A 12 12 ZTR3 ERR CONN EXIST A 13 13 ZTR...

Page 6: ...ommands 2 4 2 2 SCF Commands and Programmatic Commands 2 6 2 3 CMI Commands and Programmatic Commands 2 8 4 1 Command Protocol Summary State Changes 4 5 5 1 SPI Standard Definitions 5 2 5 2 EMS Standard Definitions 5 9 5 3 Data Communications Standard Definitions 5 12 6 1 Commands and Their Symbolic Names 6 2 7 1 TR3271 Event Messages 7 2 vi ...

Page 7: ...ment applications that communicate with the TR3271 subsystem TACL users who are writing macros and routines to perform management functions on the TR3271 subsystem This manual serves as a reference manual for the development of management applications The seven sections and two appendixes of this manual contain information as follows Section 1 introduces the TR3271 subsystem and the objects it con...

Page 8: ...nt messages reported by the subsystem a description of each event message that can be issued by the subsystems and examples of filters that could be used by an application Appendix A describes the error numbers and error lists that can be issued by the TR3271 subsystem Appendix B is a listing of the TR3271 subsystem s DDL To use this manual you should be familiar with Tandem system architecture ha...

Page 9: ... or event message box Command Message You must specify this token or field You can repeat this token or field name Specify or omit this token or field depending on the token field or value identified by name See the text for the exact nature of the dependency a You must choose only one of the set of tokens or fields that are indicated by a where a is the same uppercase letter of the alphabet for e...

Page 10: ... of this token or field depends on the token field or value identified by name See the text for the exact nature of the dependency Event Message This token or field can occur multiple times name The presence or absence of this token or field depends on the token field or value identified by name See the text for the exact nature of the dependency x ...

Page 11: ...t computer can be an IBM host or a Tandem host TR3271 emulates one or more 3270 family controllers with multiple terminals or printers attached TR3271 has two distinct configurations In one configuration TR3271 communicates with an application for example EM3270 that allows non 3270 terminals to access an IBM host In the other configuration TR3271 can be linked to AM3270 to provide pass through fu...

Page 12: ...connected to an AM3270 PTP subdevice using the CONNECT command through the control and inquiry interface or the CONTROL CONNECT command through the Communications Management Interface CMI Data transfer between AM3270 and TR3271 occurs without an intervening application The application on the host does not explicitly use the OPEN READ and WRITE file system requests for data transfer because they re...

Page 13: ...ractively with the available commands Controlling your subsystem includes such tasks as the following Terminating the operation of a line and subdevices Adding subdevices to the subsystem Changing certain attributes of a line and subdevices Establishing or clearing the link between a TR3271 subdevice and an AM3270 subdevice when using the pass through configura tion Removing subdevices from the su...

Page 14: ...can be passed to the host through TR3271 and data from the host can be passed to the AM3270 terminals through AM3270 without the necessity for an intervening application program You can selectively switch an AM3270 terminal between the control of a PATHWAY application and the control of TR3271 connected to an IBM host Of course there must be communication between the PATHWAY application and the us...

Page 15: ...unction between AM3270 terminals and a host by means of TR3271 Figure 1 1 illustrates the architecture of the TR3271 subsystem and the various interfaces to the subsystem S8009 001 3270 Terminals and Printers 3271 Cluster Controller Host Interactive Interfaces CMI CUP COUP SCF VIEWPOINT TR3271 I O Process Programmatic Interfaces EMS SCP TR Line Figure 1 1 TR3271 Subsystem Architecture 1 5 ...

Page 16: ...h SCF The Configuration Utility Program COUP which can be used to dynamically add or delete processes and lines VIEWPOINT which can be used to monitor event messages that display at the VIEWPOINT console The programmatic interfaces for managing the TR3271 subsystem are the following The control and inquiry interface which provides control and inquiry capability to an application program An applica...

Page 17: ...th the control and inquiry interface COUP has limited application to the TR3271 subsystem you can only add or delete a process or line using this facility The division of management tasks between operator control and programmatic control depends upon the subsystem configuration the subsystem environment and your needs as a subsystem user To determine the most effective division of management tasks...

Page 18: ... reported and the operator responds You can customize a management application to respond to the specific needs of your computer system or network HOW A MANAGEMENT APPLICATION FITS INTO THE ARCHITECTURE A management application uses Subsystem Programmatic Interface SPI messages to communicate with the TR3271 subsystem SPI messages are passed between the management application and the TR3271 subsys...

Page 19: ... the subsystem An application can then retrieve the event messages from the consumer distributor process If you want your application to retrieve only specific information you can write a filter Figure 2 1 illustrates how a management application fits into the TR3271 subsystem architecture S8009 002 Compatibility Distributor Filter Console VIEWPOINT User VIEWPOINT TCP Event Log Event Messages Even...

Page 20: ... refer to the Communications Management Programming Manual Table 2 1 TR3271 Programmatic Commands Page 1 of 2 COMMAND DESCRIPTION ABORT Terminates the operation of a line and subdevices immediately ADD Adds a subdevice to the TR3271 subsystem ALTER Changes the values of the attributes of a line or subdevice CONNECT Establishes a link between a TR3271 subdevice and an AM3270 subdevice when in pass ...

Page 21: ... Returns information about the current state of a line and subdevices STOP Terminates the operation of a line and subdevices SWITCH Changes the system resources used by a process or a line TRACE Initiates modifies or terminates trace mode on a line Table 2 2 shows the correspondence between the Subsystem Control Facility SCF commands a human operator issues to control and monitor the TR3271 subsys...

Page 22: ...CMD ALTER ZCOM OBJ SU BOOT LINE ZCOM CMD RESET ZCOM OBJ LINE CONNECT SU ZCOM CMD CONNECT ZCOM OBJ SU DELETE SU ZCOM CMD DELETE ZCOM OBJ LINE ZCOM CMD DELETE ZCOM OBJ SU DISCONNECT SU ZCOM CMD DISCONNECT ZCOM OBJ SU INFO LINE ZCOM CMD INFO ZCOM OBJ LINE INFO SU ZCOM CMD INFO ZCOM OBJ SU LOAD LINE ZCOM CMD LOAD ZCOM OBJ LINE NAMES LINE ZCOM CMD LISTOBJECTS ZCOM OBJ LINE ZCOM OBJ SU ZCOM OBJ NULL The...

Page 23: ...MD STATISTICS ZCOM OBJ SU STATS LINE ZCOM CMD RESETSTATS ZCOM OBJ LINE RESET STATS SU ZCOM CMD RESETSTATS ZCOM OBJ SU RESET STATUS LINE ZCOM CMD STATUS ZCOM OBJ LINE STATUS SU ZCOM CMD STATUS ZCOM OBJ SU STOP LINE ZCOM CMD STOP ZCOM OBJ LINE STOP SU ZCOM CMD STOP ZCOM OBJ SU SWITCH LINE ZCOM CMD SWITCH ZCOM OBJ LINE TRACE LINE ZCOM CMD TRACE ZCOM OBJ LINE VERSION ZCOM CMD GETVERSION ZCOM OBJ NULL ...

Page 24: ...use in applications Table 2 3 CMI Commands and Programmatic Commands Page 1 of 3 CMI COMMAND PROGRAMMATIC COMMAND AND OBJECT TYPE AND OBJECT TYPE ABORT LINE ZCOM CMD ABORT ZCOM OBJ LINE ABORT SU ZCOM CMD ABORT ZCOM OBJ SU ADD SUB ZCOM CMD ADD ZCOM OBJ SU ALTER LINE ZCOM CMD ALTER ZCOM OBJ LINE ALTER PROCESS ZCOM CMD SWITCH ZCOM OBJ LINE PATH ALTER PROCESS ZCOM CMD SWITCH ZCOM OBJ PROC CPU ALTER SU...

Page 25: ...BJ NULL ZCOM OBJ PROC INFO LINE ZCOM CMD INFO ZCOM OBJ LINE INFO SU ZCOM CMD INFO ZCOM OBJ SU INFO LINE ZCOM CMD LISTOBJECTS ZCOM OBJ LINE NAMES INFO SU ZCOM CMD LISTOBJECTS ZCOM OBJ SU NAMES None ZCOM CMD LISTOBJECTS ZCOM OBJ NULL START LINE ZCOM CMD START ZCOM OBJ LINE START SU ZCOM CMD START ZCOM OBJ SU STATUS LINE ZCOM CMD STATUS ZCOM OBJ LINE STATUS SU ZCOM CMD STATUS ZCOM OBJ SU The LINE obj...

Page 26: ...SU TRACE LINE ZCOM CMD TRACE ZCOM OBJ LINE For detailed descriptions of the CMI commands refer to the Communications Management Interface CMI Operator s Guide EVENT MESSAGES An event message describes an event that has occurred in a subsystem such as a hardware error or a software error All event messages are in SPI message format All event messages issued by the TR3271 subsystem are sent to the E...

Page 27: ...ffer to the VIEWPOINT Manual for details COMMUNICATING WITH THE TR3271 SUBSYSTEM A management application communicates with the TR3271 subsystem by means of SCP or the EMS distributor process When communicat ing with SCP or EMS an application calls SPI procedures to build messages to be sent to the subsystem and to retrieve messages sent from the subsystem However to send and receive SPI messages ...

Page 28: ... any error 6 Decode the response 7 Take appropriate action and return to step 2 if necessary 8 Terminate communication with SCP or the EMS distributor process All data communications subsystems must use the same message protocol for communicating with SCP For details on this protocol refer to the Communications Management Programming Manual and the Distributed Systems Management DSM Programming Ma...

Page 29: ...esponses between a management application and SCP and between SCP and a subsystem For details on message transport refer to the Distributed Systems Management DSM Programming Manual NOTE SCP is responsible for the communication between SCP and the TR3271 subsystem Your management application needs to be concerned only with the steps enumerated in Section 2 Management Programming for TR3271 SPI pro...

Page 30: ...e a standard form that identifies the definition file they come from and what the declaration defines In addition each source of definitions such as the TR3271 subsystem or SPI has associated with it a set of five definition files one in TAL one in COBOL85 one in TACL one in C and one in DDL The definition files in TAL COBOL85 and TACL are derived from the definition file in DDL To include the def...

Page 31: ...as follows ZSPIDEF ZSPICOB SPI definitions ZSPIDEF ZEMSCOB EMS definitions ZSPIDEF ZCOMCOB Data communications definitions ZSPIDEF ZTR3COB TR3271 definitions These files are located on the disk volume chosen by your site The default disk volume used by the INSTALL program is SYSTEM Section 5 Common Definitions lists the SPI EMS and data communications standard definitions used by the TR3271 subsys...

Page 32: ...ecify a command to the TR3271 subsystem or a response to a management application The management application uses a symbolic name to express the command number to the TR3271 subsystem and the subsystem uses the symbolic name to identify the corresponding response The symbolic name is of the form ZCOM CMD name where name identifies the command For example ZCOM CMD ADD identifies the ADD command in ...

Page 33: ...s the object type For example ZCOM OBJ SU identifies the subdevice object type in data communications subsystems including the TR3271 subsystem Note that object type numbers are part of the header of each command and response The header token named ZSPI TKN OBJECT TYPE contains the object type number However if there are multiple objects in a response or an object is returned within a data list an...

Page 34: ...a single line The name must be preceded by a pound sign and can have a maximum of seven alphanumeric characters not including the pound sign The first character following the pound sign must always be a letter Subdevices on separate lines can have identical object names therefore the line name and a period must precede the subdevice name to reference a specific subdevice An example of a valid obje...

Page 35: ...e three character abbreviation of the subsystem that created the event The symbolic name of event numbers are of the form Zsubsys EVT event where subsys is a three character abbreviation for the subsystem and event identifies the event The TR3271 subsystem is represented by the abbreviation TR3 Subjects of Event Messages The subject of an event message is always preceded by the ZEMS TKN SUBJECT MA...

Page 36: ... can be in one of the following forms A single field such as an integer or a character string A fixed structure An extensible structure Tokens that have a token value that is a single field or a fixed structure are called simple tokens Tokens that have a token value that is an extensible structure are called extensible structured tokens Simple Tokens Simple tokens are tokens whose values are singl...

Page 37: ...p Currently only the ADD and ALTER commands use extensible structured tokens defined by the TR3271 subsystem within the command buffer These extensible structured tokens are declared in the definition files for the TR3271 subsystem Note that extensible structured tokens do not appear in any event message issued by the TR3271 subsystem Responses to the following TR3271 commands can contain extensib...

Page 38: ...OM VAL BUFLEN ZTR3 VAL VERSION ZTR3 VAL EVT BUFLEN ZSPI VAL FALSE ZCOM VAL MAXBUFLEN ZSPI VAL TANDEM ZTR3 VAL SSID ZSPI VAL TRUE For descriptions of these predefined value names see the subsection Predefined Token and Field Values in Section 5 Common Definitions Field Types The field types used by the TR3271 subsystem are represented by symbolic names of the form Zsubsys DDL name where subsys is a...

Page 39: ...ne object or in some cases a related group of objects An error list is used in a response to enclose information about an error or warning For details on these two constructs refer to the Distributed Systems Management DSM Programming Manual Components of a Command Response and Event For general information about components of a command response or event message refer to the Communications Managem...

Page 40: ...siderations apply when an applica tion builds the command buffer for an TR3271 command The recommended buffer length in bytes for a command is a predefined value with the symbolic name ZCOM VAL MAXBUFLEN The subsystem does not support multiple commands in a single request message However some of the commands can contain the subordinate modifier token so one command can affect multiple objects The ...

Page 41: ... the comment token described in the Distributed Systems Management DSM Programming Manual ZCOM TKN TRACE OPT is a token used in the TRACE command and is described in Section 5 Common Definitions If any of the other tokens in a command appear more than once an error is returned DISCONTINUING A COMMAND IN PROGRESS General programming considerations for discontinuing a command in progress are discuss...

Page 42: ...he response is the predefined value ZCOM VAL BUFLEN The subsystem supports multiple response records over multiple messages continuation by returning a context token when a response is continued The subsystem also supports the use of the token ZSPI TKN RESPONSE TYPE which allows an application to specify in a command operating on multiple objects which kinds of response records should be returned ...

Page 43: ...example when an application requests through ZSPI TKN RESPONSE TYPE that only response records for objects on which errors or warnings occurred be returned and the command finishes processing without encountering any errors or warnings Error handling considerations for specific commands are described in Section 6 Commands and Responses The error numbers returned by the subsystems are described in ...

Page 44: ... 4 1 shows the state transitions of objects as a result of some of the TR3271 commands Table 4 1 Command Protocol Summary State Changes COMMAND OLD STATE NEW STATE START STOPPED STARTED ABORT STARTED STOPPED STOP STARTED STOPPED CONNECT STARTED STARTED DISCONNECT STARTED STARTED 4 5 ...

Page 45: ...in this section are represented in DDL Structures both fixed and extensible are defined by using DDL DEF statements For a quick explanation of DDL as it applies to SPI refer to the appendix Overview of DDL for SPI in the Distributed Systems Management DSM Programming Manual SPI STANDARD DEFINITIONS Definitions whose names begin with ZSPI are Subsystem Programmatic Interface SPI standard definition...

Page 46: ...LASTERR ZSPI TKN DATALIST ZSPI TKN LASTERRCODE ZSPI TKN ENDLIST ZSPI TKN LASTPOSITION ZSPI TKN ERRLIST ZSPI TKN MAX FIELD VERSION ZSPI TKN MANAGER ZSPI TKN MAXRESP ZSPI TKN RESPONSE TYPE ZSPI TKN OBJECT TYPE ZSPI TKN RETCODE ZSPI TKN SERVER VERSION ZSPI TKN SERVER BANNER ZSPI TKN SSID ZSPI TKN USEDLEN Special Tokens Value Names ZSPI TKN ADDR ZSPI SSN ZTR3 ZSPI TKN CLEARERR ZSPI VAL FALSE ZSPI TKN ...

Page 47: ... FNAME32 ZSPI DDL INT ZSPI TYP INT ZSPI DDL INT PAIR ZSPI TYP INT PAIR ZSPI DDL INT2 ZSPI TYP INT2 ZSPI DDL INT4 ZSPI TYP INT4 ZSPI DDL TIMESTAMP ZSPI TYP LIST ZSPI DDL UINT ZSPI TYP MARK ZSPI TYP SSCTL ZSPI TYP SSID ZSPI TYP STRING ZSPI TYP TIMESTAMP ZSPI TYP TOKENCODE ZSPI TYP UINT All SPI standard definitions are fully described in the Distributed Systems Management DSM Programming Manual Infor...

Page 48: ...ponse buffer This is the default value ZSPI VAL WARN AND NORM The subsystem continues to process the next object in the set even though warnings occurred during processing of the command on the previous object A warning is indicated by a zero value in the RETCODE token but an error list is present ZSPI VAL ERR WARN AND NORM The subsystem continues to process the next object in the set despite erro...

Page 49: ...ll objects of the set have been processed Note that if the TR3271 subsystem receives a command with the context token and there are no more objects to be processed the subsystem returns a return code that is the empty response The contents of the ZSPI TKN CONTEXT are not to be used by your management application the contents are only to be reflected back to the subsystem in a command Only one cont...

Page 50: ...en default value is provided when a management application uses the SSINIT procedure However if a managment application chooses to specify a value other than the default value for the MAXRESP token the manage ment application must specify a value using the SSPUT procedure The TR3271 subsystem provides full support for the MAXRESP token that is the management application can specify any of the foll...

Page 51: ...zero even though the command has completed successfully If the command did not complete successfully the value of this token indicates the reason the command failed The meaning of each error number is subsystem specific and possibly command specific For descriptions of all TR3271 error numbers refer to Appendix A For descriptions of all common data communications error numbers refer to the Communi...

Page 52: ...PI DDL INT value is ZSPI SSN ZTR3 02 Z VSN type ZSPI DDL UINT value is ZTR3 VAL VERSION end ZSPI TKN USEDLEN specifies the length of the used portion of the command message The value of this token is used to verify that the entire message has been read by the server The value is compared to the count read value supplied by the file system If the value of the ZSPI TKN USEDLEN is greater than the co...

Page 53: ...efinitions refer to the Event Management Service EMS Manual The EMS definitions used by the TR3271 subsystem consist of the following Header tokens Simple tokens Extensible structured tokens Table 5 2 EMS Standard Definitions Header Tokens Other Simple Tokens ZEMS TKN CONSOLE PRINT ZEMS TKN CU ZEMS TKN CPU ZEMS TKN LDEV ZEMS TKN CRTPID ZEMS TKN LDEVNAME ZEMS TKN EMPHASIS ZEMS TKN SUBJECT MARK ZEMS...

Page 54: ...MS MAP EXIOADDR token This token is volatile and is used for backward compatibility ZEMS TKN EMPHASIS specifies whether the event message is consid ered critical If the value of the token is ZSPI VAL TRUE the event is considered critical if the value is ZSPI VAL FALSE the event is not considered critical The description of each event message states whether the event is critical or not ZEMS TKN EVE...

Page 55: ...3271 and are found in the ZSPIDEF ZCOMDDL definition file Refer to Definition Files in Section 3 for details Table 5 3 lists only those data communications standard defini tions that are used in the management programming interfaces to the TR3271 subsystem It does not list data communications error numbers or definitions used only in error lists For a description of all data communications standar...

Page 56: ... CMD STATISTICS ZCOM TKN SWITCH CPU ZCOM CMD STATUS ZCOM TKN SWITCH PATH ZCOM CMD STOP ZCOM TKN TARGET MGR ZCOM CMD SWITCH ZCOM TKN TARGET OBJNAME ZCOM CMD TRACE ZCOM TKN TARGET OBJTYPE ZCOM TKN TRACE OPT Extensible Object Types Structured Tokens ZCOM OBJ LINE ZCOM MAP REQID ZCOM OBJ NULL ZCOM MAP TRACE MODIF ZCOM OBJ PROCESS ZCOM OBJ SU Fixed Structures Value Names ZCOM DDL REQID ZCOM VAL PATH A ...

Page 57: ... ZPAID type ZSPI DDL INT end ZCOM MAP TRACE MODIF is the extensible structured token sent in the TRACE command by the management application it contains the trace parameters that control the initiation of the trace file the selection of the trace environment and termination of trace mode The initiation and selection is handled in one ZCOM MAP TRACE MODIF token When the trace is to be terminated th...

Page 58: ... contains the name of a TR3271 object The object name of a LINE object is the name of a specific line configured on a single system These names are assigned when the line is congifured and they are unique within a system The object name of an SU object is the name of a specific subdevice configured on a single line and must be unique within the line The NULL object has no object name The object na...

Page 59: ...NE as the object type the value ZCOM VAL SUB NONE is accepted This value has no effect on the command If the value ZCOM VAL SUB ONLY is specified only the objects subordinate to the line are affected The objects subordinate to an TR3271 line are the subdevices on the line If the value ZCOM VAL SUB ALL is specified the objects subordinate to the line as well as the LINE object itself are affected b...

Page 60: ... or path B This value may also appear in the information returned for the line when the STATUS command is issued This value indicates the path has not yet been activated ZCOM VAL SUB ALL is a value of the token ZCOM TKN SUB indicating that the command affects both the named line and all its subordinate subdevices If this value is specified for the PROC or SU object the command is treated as if the...

Page 61: ...sed in Section 6 Commands and Responses Definitions are listed in alphabetical order within each category TR3271 Buffer Declarations The TR3271 subsystem provides the following buffer declarations for message buffers that can be used with the SPI procedures All applications should use one of these declarations for a buffer of the recommended size ZTR3 DDL MSG BUFFER is a message buffer whose size ...

Page 62: ...3271 subsystem Its structure definition is given earlier in this section under SPI Standard Definitions For more information about ZTR3 VAL SSID refer to the discussion of the subsystem ID in the Distributed Systems Management DSM Programming Manual ZTR3 VAL VERSION is the version number of this version of the TR3271 subsystem This value is a 16 bit unsigned integer the left byte contains the lett...

Page 63: ...TR3 MAP INFO LINE These tokens are described with the commands and responses they appear in See Section 6 Commands and Responses TR3271 Tokens in Error Lists The TR3271 subsystem defines several error numbers See Appendix A for detailed descriptions The error numbers for TR3271 are as follows ZTR3 ERR ALRDY USING ADDR ZTR3 ERR ATTR CONFL SU ZTR3 ERR CLIP PROB ZTR3 ERR CONN EXIST ZTR3 ERR NO OBJ IN...

Page 64: ... ERR ZTR3 TKN ADDR CTL ZTR3 TKN P REG ZTR3 TKN CIU STATUS ZTR3 TKN PROBE ERR ZTR3 TKN CLIP FUNC ZTR3 TKN SU ZTR3 TKN CLIP STATUS ZTR3 TKN TYPE SEQ ZTR3 TKN CLIP SU ZTR3 TKN X1 ZTR3 TKN CONFIG ERR ZTR3 TKN X2 ZTR3 TKN E REG ZTR3 TKN X3 ZTR3 TKN FILE ERR ZTR3 TKN X4 The tokens defined by the TR3271 subsystem that appear in event messages are described in Section 7 Event Management within the descrip...

Page 65: ... DDL as it applies to SPI refer to the appendix Overview of DDL for SPI in the Distributed Systems Management DSM Programming Manual The commands available in the programmatic interface allow an application to do the following Change the attributes of TR3271 objects Start and stop the operation of TR3271 objects Add a subdevice to or remove a subdevice from the TR3271 subsystem Obtain attribute va...

Page 66: ...and inquiry interface to the TR3271 subsystem and gives their symbolic names Table 6 1 Commands and Their Symbolic Names Page 1 of 3 SYMBOLIC NAME OF COMMAND COMMAND AND OBJECT ABORT ZCOM CMD ABORT ZCOM OBJ LINE ZCOM OBJ SU ADD ZCOM CMD ADD ZCOM OBJ SU ALTER ZCOM CMD ALTER ZCOM OBJ LINE ZCOM OBJ SU CONNECT ZCOM CMD CONNECT ZCOM OBJ SU DELETE ZCOM CMD DELETE ZCOM OBJ LINE ZCOM OBJ SU DISCONNECT ZCO...

Page 67: ... OBJ SU LISTOBJECTS ZCOM CMD LISTOBJECTS ZCOM OBJ LINE ZCOM OBJ NULL ZCOM OBJ SU LOAD ZCOM CMD LOAD ZCOM OBJ LINE RESET ZCOM CMD RESET ZCOM OBJ LINE RESETSTATS ZCOM CMD RESETSTATS ZCOM OBJ LINE ZCOM OBJ SU START ZCOM CMD START ZCOM OBJ LINE ZCOM OBJ SU STATISTICS ZCOM CMD STATISTICS ZCOM OBJ LINE ZCOM OBJ SU STATUS ZCOM CMD STATUS ZCOM OBJ LINE ZCOM OBJ SU 6 3 ...

Page 68: ...lid for each command Three of the object types have a hierarchical relationship For TR3271 subsystems these three object types are PROC LINE and SU subdevice where SU is subordinate to LINE and LINE is subordinate to PROC This subordinate arrangement means that the subordinate objects can in some instances be controlled or monitored by specifying the subordinate modifier NOTE A process controls on...

Page 69: ...he following commands ABORT RESETSTATS ALTER START DELETE STATISTICS INFO STATUS LISTOBJECTS STOP LOAD SWITCH RESET TRACE The TR3271 subsystem accepts the SU object type only in the following commands ABORT LISTOBJECTS ADD RESETSTATS ALTER START CONNECT STATISTICS DELETE STATUS DISCONNECT STOP INFO The TR3271 subsystem accepts the NULL object type only in the following commands GETVERSION LISTOBJE...

Page 70: ...can be issued by any valid user The sensitive commands available to a TR3271 subsystem user are as follows ABORT RESET ADD RESETSTATS ALTER START CONNECT STOP DELETE SWITCH DISCONNECT TRACE LOAD The nonsensitive commands available to a TR3271 subsystem user are as follows GETVERSION STATISTICS INFO STATUS LISTOBJECTS COMMAND DESCRIPTIONS On the following pages each command and its response is desc...

Page 71: ...agement DSM Programming Manual The notation used in the box for simple tokens is a shorthand version of the essential information given in the DDL TOKEN CODE statement Extensible structured tokens are defined by using DDL DEF statements For each token in the command and response buffers and for each field of an extensible structured token in the command and response buffers the box contains an ind...

Page 72: ...ttached to the specified line are aborted If the value of the modifier is ZCOM VAL SUB ALL the subsys tem aborts all the associated subdevices and then aborts the line If the value is ZCOM VAL SUB NONE or if the subordinate modifier is not present the subsystem checks the state of the subordinate subdevices The subordinate subdevices must be in the STOPPED summary state If any of the subdevices ar...

Page 73: ... ZSPI TKN MAXRESP token type ZSPI TYP INT ZSPI TKN CONTEXT token type ZSPI TYP BYTESTRING ZSPI TKN RESPONSE TYPE token type ZSPI TYP ENUM ZSPI TKN ALLOW TYPE token type ZSPI TYP ENUM ZSPI TKN COMMENT token type ZSPI TYP STRING Tokens in Response Buffer ZSPI TKN SERVER VERSION token type ZSPI TYPE INT ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN DATALIST token type ZSPI TYP LIST ZCOM TKN OBJNAME...

Page 74: ...ces If the object type is SU terminate the named subdevice ZCOM VAL SUB ONLY If the object type is LINE terminate the subdevices subordinate to the named line but do not terminate the line This value is not valid with the SU object type ZCOM VAL SUB NONE If the object type is LINE terminate the named line only if the subordinate subdevices are currently in the STOPPED summary state If the object t...

Page 75: ...munications Management Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list Within the error list the object experiencing the error is listed See SPI Standard Definitions in Section 5 for details ZSPI TKN RETCODE specifies the return code for the command This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming M...

Page 76: ...nse continues to the next reply message If this token is not present the reply message is the last to be received See SPI Standard Definitions in Section 5 for details Operational Notes ABORT is a sensitive command When the command is completed the line and subdevices are placed in the STOPPED summary state The line must be in the STARTED summary state when this command is issued If you abort a pa...

Page 77: ...ecks the configurable attributes provided in the command These attributes are defined in ZTR3 MAP ADD SU If the attributes are valid the subsystem verifies that the subdevice is not already defined and that the number of subdevices defined on the line is not greater than 253 If either of these checks fails the subsystem returns an error Typically a line can support 255 subdevices but there are two...

Page 78: ...I TKN ENDLIST token type ZSPI TYP SSCTL ZSPI TKN RETCODE token type ZSPI TYP ENUM ZSPI TKN ENDLIST token type ZSPI TYP SSCTL Tokens in Command Buffer ZTR3 MAP ADD SU is the extensible structured token that defines the configurable attributes for the subdevice that is to be added It has the token number ZTR3 TNM ADD SU and the DDL definition ZTR3 DDL ADD SU This token must be in the command and dup...

Page 79: ... screen size as the record size The record size is used for reference only PTP subdevice The TR3271 I O process allocates the buffer based on the value of this field Use the defined screen size as follows Screen Size Record Size 480 512 960 1024 1920 2048 2560 3072 3440 4096 3564 4096 When using pass through mode the TR3271 subdevice should have the same record size as the AM3270 subdevice that is...

Page 80: ...btype 2 indicates a printer ZCOM TKN OBJNAME specifies the subdevice that is to be added Your application must provide this token in the command This token is described in Data Communications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZCOM MAP REQID and ZCOM TKN CMD TIMEOUT are standard data communications tokens that your application ...

Page 81: ...ZSPI TKN ERRLIST indicates the beginning of an error list This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual ZSPI TKN RETCODE specifies the return code for the command This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management Programming Manual For details on the data communica...

Page 82: ...d ZTR3 ERR ALRDY USING ADDR 6 Your management application attempted to add a subdevice at an address already in use by another object Reissue the command using a value for the ZADDR field that has not been previously assigned ZTR3 ERR CLIP PROB 2 Your management application attempted to add a subdevice but the operation failed because of an internal CLIP problem Check event messages 165 and 164 fo...

Page 83: ...e given to a subdevice must be unique on the line You can add a maximum of 253 subdevices to a line To remove a subdevice stop the SU then use the DELETE command To add a line or a process use the Dynamic System Configuration DSC facility 6 19 ...

Page 84: ...ype ZSPI DDL BOOLEAN 02 ZCTL SET type ZSPI DDL ENUM 02 ZDEBUG type ZSPI DDL BOOLEAN 02 ZDROP RTS type ZSPI DDL BOOLEAN 02 ZINIT STATUS type ZSPI DDL INT2 02 ZMULTI BLOCK type ZSPI DDL BOOLEAN 02 ZOFFLINE TIMER type ZSPI DDL TIMESTAMP 02 ZPROG type ZSPI DDL FNAME 02 ZREAD CMD type ZSPI DDL ENUM 02 ZRETRY type ZSPI DDL INT 02 ZSYNCS type ZSPI DDL INT 02 ZTEST INTVL type ZSPI DDL TIMESTAMP 02 ZTHRES ...

Page 85: ... ZSPI TYP TIMESTAMP ZSPI TKN MANAGER token type ZSPI TYP FNAME32 ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN MAXRESP token type ZSPI TYP INT ZSPI TKN RESPONSE TYPE token type ZSPI TYP ENUM ZSPI TKN ALLOW TYPE token type ZSPI TYP ENUM ZSPI TKN COMMENT token type ZSPI TYP STRING Tokens in Response Buffer ZSPI TKN SERVER VERSION token type ZSPI TYP INT ZSPI TKN SSID token type ZSPI TYP SSID ZSPI ...

Page 86: ...raph and Telephone Consultative Committee check will be used The default value is ZTR3 VAL BCC CRC16 ZCHARSET The character set to be used The value ZTR3 VAL CHAR ASCII indicates the ASCII character set will be used The value ZTR3 VAL CHAR EBCDIC indicates the EBCDIC character set will be used The default value is ZTR3 VAL CHAR EBCDIC ZCTL RTS A Boolean variable that specifies whether the Carrier ...

Page 87: ...t WACK indicating that the subdevice is busy The subdevice remains busy until an application OPENs or CONNECTs the subdevice Note that this can have a cyclic effect the host front end might resend a SELECT each time it receives a WACK from the TR3271 subsystem 177776 The TR3271 subsystem does not respond to SELECTs Consequently the host times out the subdevice provided the subdevice has not been O...

Page 88: ... If the TR3271 subsystem does not receive anything within this interval the host is considered down and a timeout error is reported The value must be in the 0 through 5 27 67 range The default is 0 wait forever ZPROG A 32 byte file name that identifies the program file that is to be downloaded to the CLIP The default is SYSTEM CSS00 C9315P00 ZREAD CMD An enumerated value that specifies whether the...

Page 89: ...ZTIMEOUT A timestamp that specifies the line I O timeout value in 01 seconds This value defines how long the I O process waits before retrying when a data link error occurs The value must be in the range 00 00 6 through 00 10 The default is 00 02 7 ZXLATE A Boolean variable that specifies whether the TR3271 subsystem translates inbound and outbound data If the value is ZSPI VAL TRUE the TR3271 sub...

Page 90: ...s the extensible structured token that defines the configurable attributes that are to be altered for a subdevice It has the token number ZTR3 TNM ALTER SU and the DDL definition ZTR3 DDL ALTER SU This extensible structured token must be in the command when the specified object is ZCOM OBJ SU It cannot be in the command when the object is ZCOM OBJ LINE Duplicate occurrences of the token are not al...

Page 91: ... the subdevice if the value is ZSPI VAL FALSE it is not The default is ZSPI VAL FALSE Transparent text mode can only be enabled if the TR3271 line is configured with the EBCDIC character set and control set and transparent text mode is enabled for the line ZTYPE A pair of integers that specifies the device type and subtype of the subdevice to be altered The first integer is the device type which d...

Page 92: ...ese tokens are optional These tokens are described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Tokens in Response Buffer ZSPI TKN DATALIST indicates the beginning of a data list This token is described in SPI Standard Definitions in Section 5 Common Definitions and the Distributed Systems Management DSM Programming Manual ZCOM TKN OBJNAME ...

Page 93: ... 24 ZCOM ERR SECUR VIOL 22 ZCOM ERR OBJNAME INV 19 ZCOM ERR OBJ NOT FOUND 17 ZCOM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR OBJ NOT SUPP 18 Your management application has tried to alter an object that is not supported by the TR3271 subsystem The supported objects are PROC LINE and SU For the ALTER command you must specify the value ZCOM OBJ LINE or ZCOM OBJ SU ZCOM ERR NO MEM SPACE 14 The...

Page 94: ...TE and ZXPARENT fields are not properly specified ZSPI TKN ENDLIST indicates the end of a data list or an error list This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Operational Notes ALTER is a sensitive command When the command is completed the line and subdevice remain in the same state as they were before the command...

Page 95: ...and described in the Subsystem Control Facility SCF Reference Manual If the AM3270 subsystem is not supported by DSM you can use the CMI ALTER SUBDEVICE command Refer to the Communications Management CMI Operator s Guide for more information The lines for the TR3271 and targeted AM3270 subdevice must be in the STARTED summary state Command ZCOM CMD CONNECT Object Type ZCOM OBJ SU Tokens in Command...

Page 96: ...ted to the target subdevice Your application must provide this token in the command This token is described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZCOM TKN TARGET MGR specifies the name of the manager controlling the AM3270 subdevice to which you want to establish a link If your management application does not provide a value t...

Page 97: ... error that prevents the CONNECT command from being attempted at all this token is present in every response record ZCOM TKN OBJNAME is described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZCOM TKN OBJTYPE specifies the type of TR3271 object that at tempted to build a link The only valid value for this token is ZCOM OBJ SU This tok...

Page 98: ...e object type ZCOM OBJ SU ZCOM ERR OBJ NOT FOUND 17 Your application has tried to build a link from a TR3271 subdevice that does not exist Issue the LISTOBJECTS command to determine the subdevices that exist and reissue the CONNECT command with an appropriate subdevice ZCOM ERR CMD MISMATCH 4 Your management application tried to build a link from a process or line by using the object type ZCOM OBJ...

Page 99: ...ply with the valid format ZSPI TKN ENDLIST indicates the end of a data list or an error list This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Operational Notes CONNECT is a sensitive command The line and subdevice must be in the STARTED summary state when this command is issued When the command is completed the lines and...

Page 100: ...the SU object the subsystem deletes only the specified subdevice Although the subordinate modifier can be present for the SU object the only valid values are ZCOM VAL SUB NONE and ZCOM VAL SUB ALL If your management application specifies the subordinate modifier with the value ZCOM VAL SUB ONLY value for a subdevice the subsystem returns an error Command ZCOM CMD DELETE Object Type ZCOM OBJ LINE o...

Page 101: ...ffer ZCOM TKN OBJNAME specifies either the line whose subdevices are to be deleted or the subdevice that is to be deleted Your application must provide this token in the command This token is described in Data Communications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZCOM MAP REQID and ZCOM TKN CMD TIMEOUT are standard data communicati...

Page 102: ...amming Manual ZCOM TKN OBJNAME specifies either the name of the TR3271 line whose subdevices were deleted or the name of the subdevice that was deleted If the LINE object type was specified in the command the first occurrence of this token contains the line name subsequent occurrences of this token contain the name of a subordinate subdevice If the SU object type was specified in the command this ...

Page 103: ...OT FOUND 25 ZCOM ERR SSID INV 24 ZCOM ERR SECUR VIOL 22 ZCOM ERR OBJNAME INV 19 ZCOM ERR OBJ NOT FOUND 17 ZCOM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR TKN VAL INV 30 Your management application specified the subordinate modifier with the value ZCOM VAL SUB ONLY for the SU object Or your management application specified the SUB modifier with the value ZCOM VAL SUB NONE or ZCOM VAL SUB ALL...

Page 104: ...fies whether there are more reply messages to be received for a response This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Operational Notes DELETE is a sensitive command When the command is completed the subdevices are removed from the subsystem The line must not be in the DIAGNOSING summary state when this command is is...

Page 105: ...y of these conditions are not met the TR3271 subsystem rejects the command and returns an error Your management application should always issue a DISCONNECT command before aborting a PTP subdevice that is connected Command ZCOM CMD DISCONNECT Object Type ZCOM OBJ SU Tokens in Command Buffer ZCOM TKN OBJNAME token type ZSPI TYP STRING ZCOM TKN TARGET MGR token type ZSPI TYP FNAME32 ZCOM TKN TARGET ...

Page 106: ...pplication must provide this token in the command This token is described in SPI Standard Definitions in Section 5 and the Communications Management Programming Manual ZCOM TKN TARGET MGR specifies the name of the manager controlling the AM3270 subdevice from which you want to delete a link If your management application does not provide a value the TR3271 subsystem derives the line name from the ...

Page 107: ...on 5 and the Distributed Systems Management DSM Programming Manual ZSPI TKN DATALIST indicates the beginning of a data list This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual ZCOM TKN OBJNAME specifies the name of the TR3271 subdevice that was trying to delete the link to the AM3270 subdevice Unless there is an error that ...

Page 108: ... INV 24 ZCOM ERR SECUR VIOL 22 ZCOM ERR OBJNAME INV 19 ZCOM ERR OBJ NOT SUPP 18 ZCOM ERR OBJ NOT FOUND 17 ZCOM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR PATH DOWN 20 There has been an unexpected loss of the link between the AM3270 subdevice and the TR3271 subdevice ZCOM ERR CMD MISMATCH 4 Your management application tried to delete a link from a process or line by using the object type ZCO...

Page 109: ...ot comply with the valid format ZSPI TKN ENDLIST indicates the end of a data list or an error list This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Operational Notes DISCONNECT is a sensitive command The line and subdevices must be in the STARTED summary state when this command is issued When the command is completed the...

Page 110: ...3271 subsystem returns an error Any valid user can issue the GETVERSION command Command ZCOM CMD GETVERSION Object Type ZCOM OBJ PROC or ZCOM OBJ NULL Tokens in Command Buffer ZCOM TKN OBJNAME token type ZSPI TYP STRING ZCOM MAP REQID MAP is optional but if present fields are required def ZCOM DDL REQID 02 ZCRTPID type ZSPI DDL CRTPID 02 ZPAID type ZSPI DDL INT end ZCOM TKN CMD TIMEOUT token type ...

Page 111: ...the line name Your application must provide this token only if the value ZCOM OBJ PROC has been specified This token is described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZCOM MAP REQID and ZCOM TKN CMD TIMEOUT are standard data communications tokens that your application can optionally pro vide These tokens are described in Data...

Page 112: ...gramming Manual ZCOM TKN OBJTYPE specifies the type of object for which informa tion was requested The value of this token should be ZCOM OBJ NULL or ZCOM OBJ PROC This token is described in Data Communications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list See SPI Standard Definiti...

Page 113: ...L ZSPI TKN SERVER BANNER specifies the 50 byte character string that contains the server product name product number and release date ZSPI TKN ENDLIST indicates the end of a data list or an error list See SPI Standard Definitions in Section 5 for details Operational Notes GETVERSION is a nonsensitive command When the command is completed the summary states of all objects remain the same as they we...

Page 114: ... the subordinate modifier is not present the subsystem returns information about the line only When your management application issues the INFO command for a subdevice the subsystem returns information only for the specified subdevice Although the SU object has no subordinates your management application can specify the subordinate modifier with the value ZCOM VAL SUB NONE and ZCOM VAL SUB ALL Thi...

Page 115: ... TKN MAXRESP token type ZSPI TYP INT ZSPI TKN CONTEXT token type ZSPI TYP BYTESTRING ZSPI TKN RESPONSE TYPE token type ZSPI TYP ENUM ZSPI TKN ALLOW TYPE token type ZSPI TYP ENUM ZSPI TKN COMMENT token type ZSPI TYP STRING Tokens in Response Buffer ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN SERVER VERSION token type ZSPI TYP INT ZSPI TKN DATALIST token type ZSPI TYP LIST ZTR3 MAP INFO LINE OBJ...

Page 116: ...ZXLATE IN type ZSPI DDL CHAR occurs 256 times 02 ZXLATE OUT type ZSPI DDL CHAR occurs 256 times end ZTR3 MAP INFO SU OBJ SU OBJ NULL def ZTR3 DDL INFO SU All fields are present 02 ZADDR type ZSPI DDL INT PAIR 02 ZPROTO type ZSPI DDL ENUM 02 ZRECSIZE type ZSPI DDL INT 02 ZXPARENT type ZSPI DDL BOOLEAN 02 ZTYPE type ZSPI DDL INT PAIR end ZCOM TKN OBJNAME token type ZSPI TYP STRING ZCOM TKN OBJTYPE t...

Page 117: ...ts subordinate subdevices If the object type is SU return information about the named subdevice only ZCOM VAL SUB ONLY If the object type is LINE return information about the subdevices subordinate to the named line Do not obtain information about the line This value is not valid for the SU object type ZCOM VAL SUB NONE If the object type is LINE return information for the named line only If the o...

Page 118: ...lds in the ZTR3 MAP INFO LINE token are as follows ZBCCTYPE The block check character BCC type to be used by the line The value ZTR3 VAL BCC LRC8 indicates that the longitudinal redundancy check LRC8 will be used The value ZTR3 VAL BCC CRC16 indicates that the cyclic redundancy check CRC16 will be used The value ZTR3 VAL BCC CCITT indicates that the International Telegraph and Telephone Consultati...

Page 119: ...the value is ZSPI VAL TRUE the signal will be dropped when switching operations If the value is ZSPI VAL FALSE the RTS signal will not be dropped The default value is ZSPI VAL FALSE ZINIT STATUS A 32 bit integer that specifies the initial IBM status that the TR3271 subsystem returns when it receives a SELECT for a subdevice that has not been OPENed or CONNECTed The possible values are 0 The TR3271...

Page 120: ...receiving the RVI polls the subsystem The value must be in the correct format Refer to Appendix C in the Device Specific Access Methods AM3270 TR3271 for a list of appropriate values ZMULTI BLOCK A Boolean variable that specifies whether the TR3271 subsystem supports multiple block trans missions If the value is ZSPI VAL TRUE the subsystem supports multiple block transmissions if the value is ZSPI...

Page 121: ...3271 retransmits data as a result of data link errors before returning an error The value must be in the 1 through 14 range The default is 3 ZSYNCS An integer that specifies the number of SYN characters that precede each frame The value must be in the 1 through 14 range The default is 3 ZTEST INTVL A timestamp that specifies the interval in 01 seconds at which the status probe is issued to the CLI...

Page 122: ...FALSE it is not The default is ZSPI VAL FALSE Transparent text mode can only be enabled if the line is configured with the EBCDIC character set ZWACK DELAY A timestamp that specifies the period of time in 01 seconds that the TR3271 subsystem waits before sending a wait for acknowledgement WACK to the host in response to a SELECT The value must be in the 0 through 32767 range The default is 0 ZXLAT...

Page 123: ...the address assigned to the subdevice The first integer is the address of the control unit The second integer is the address of the subdevice Both integers should be in the range 0 through 31 ZPROTO An enumerated value that specifies the protocol used by the subdevice There is no default value It can have one of the following values ZTR3 VAL PROTO CRT The CRT protocol is used ZTR3 VAL PROTO PTP Th...

Page 124: ... following screen sizes ZTYPE Screen Size 10 1 12 x 40 10 2 24 x 80 10 3 32 x 80 10 4 43 x 80 10 5 12 x 80 60 x The subdevice is a Pass Through Protocol PTP subdevice The value of x can have the value of 1 or 2 Subtype 1 indicates a CRT subdevice and subtype 2 indicates a printer ZSPI TKN DATALIST indicates the beginning of a data list See SPI Standard Definitions in Section 5 for details ZCOM TKN...

Page 125: ...J NOT SUPP 18 ZCOM ERR OBJ NOT FOUND 17 ZCOM ERR NO MEM SPACE 14 ZCOM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR TKN VAL INV 30 Your management application specified the SUB modifier with the value ZCOM VAL SUB ONLY for the SU object type The SU object type accepts only the value ZCOM VAL SUB NONE or ZCOM VAL SUB ALL for the SUB modifier ZCOM ERR CMD MISMATCH 4 Your management application t...

Page 126: ...ine and subdevice remain in the same summary state they were in before the command was executed All valid users on the system can issue the INFO command To change the values of the attributes use the ALTER command To obtain information about the current summary state of a line or subdevice use the STATUS command To obtain statistical information about a line or subdevice use the STATISTICS command...

Page 127: ...name have a zero length or not be present Only the line type and name are listed The TR3271 subsystem only supports one line per process If the SUB modifier is included depending on the value the object types and names of the subordinate subdevices are also listed When your management application specifies the SU object the OBJNAME token can contain a specific subdevice name have a zero length or ...

Page 128: ...e ZSPI TYP SSID ZSPI TKN MAXRESP token type ZSPI TYP INT ZSPI TKN CONTEXT token type ZSPI TYP BYTESTRING ZSPI TKN RESPONSE TYPE token type ZSPI TYP ENUM ZSPI TKN ALLOW TYPE token type ZSPI TYP ENUM ZSPI TKN COMMENT token type ZSPI TYP STRING Tokens in Response Buffer ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN SERVER VERSION token type ZSPI TYP INT ZSPI TKN DATALIST token type ZSPI TYP LIST ZC...

Page 129: ...he named line and all its subordinate subdevices If the object type is SU list the named subde vice only ZCOM VAL SUB ONLY If the object type is LINE list the subde vices subordinate to the named line the line is not to be affected by this command This is not a valid value for the SU object type ZCOM VAL SUB NONE If the object type is LINE or SU list the named object only If this token is not pres...

Page 130: ...LINE The object is a line ZCOM OBJ SU The object is a subdevice This token is described in Data Communications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list See SPI Standard Definitions in Section 5 for details ZSPI TKN RETCODE specifies the return code for the command This token i...

Page 131: ...SPI TKN ENDLIST indicates the end of a data list or an error list See SPI Standard Definitions in Section 5 for details ZSPI TKN CONTEXT specifies whether there are more reply messages to be received for a response If this token is present the response will continue to the next reply message If this token is not present the reply message is the last to be received See SPI Standard Definitions in S...

Page 132: ...m generation time the line comes up not loaded and the subsystem can accept the LOAD command without previously being RESET Command ZCOM CMD LOAD Object Type ZCOM OBJ LINE Tokens in Command Buffer ZCOM TKN OBJNAME token type ZSPI TYP STRING ZCOM MAP REQID MAP is optional but if present fields are required def ZCOM DDL REQID 02 ZCRTPID type ZSPI DDL CRTPID 02 ZPAID type ZSPI DDL INT end ZCOM TKN CM...

Page 133: ...nications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZCOM MAP REQID and ZCOM TKN CMD TIMEOUT are standard data communications tokens that your application can optionally pro vide These tokens are described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZSPI TKN MANAGER SSID...

Page 134: ...nagement Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list See SPI Standard Definitions in Section 5 for details ZSPI TKN RETCODE specifies the return code for the command This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual For details on the data communications error numbers and their associated ...

Page 135: ...ional Notes LOAD is a sensitive command When the command is completed the line remains in the STOPPED summary state The line must be in the STOPPED summary state when this command is issued Use the START command to start the line The RESET command should be issued before the LOAD command unless the NOLOAD modifier has been specified at system generation time 6 71 ...

Page 136: ...e Communications Access Process CAP s copy of LINE and SU statistics is not reset Command ZCOM CMD RESET Object Type ZCOM OBJ LINE Tokens in Command Buffer ZCOM TKN OBJNAME token type ZSPI TYP STRING ZCOM MAP REQID MAP is optional but if present fields are required def ZCOM DDL REQID 02 ZCRTPID type ZSPI DDL CRTPID 02 ZPAID type ZSPI DDL INT end ZCOM TKN CMD TIMEOUT token type ZSPI TYP TIMESTAMP Z...

Page 137: ... Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZCOM MAP REQID and ZCOM TKN CMD TIMEOUT are standard data communications tokens that your application can optionally pro vide These tokens are described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZSPI TKN MANAGER SSID MAXRESP ...

Page 138: ...Data Communications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list See SPI Standard Definitions in Section 5 for details ZSPI TKN RETCODE specifies the return code for the command This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management...

Page 139: ...ED summary state The STARTED and DIAGNOSING summary states prevent processing of the RESET command ZSPI TKN ENDLIST indicates the end of a data list or an error list See SPI Standard Definitions in Section 5 for details Operational Notes RESET is a sensitive command The line must be in the STOPPED summary state when this command is issued When the command is completed the line remains in the STOPP...

Page 140: ... ZSAMPLE TIME fields You can issue this command for a line or a subdevice but not a process The line summary state is not checked by the TR3271 subsystem when you issue the RESETSTATS command Command ZCOM CMD RESETSTATS Object Type ZCOM OBJ LINE or ZCOM OBJ SU Tokens in Command Buffer ZCOM TKN OBJNAME token type ZSPI TYP STRING ZCOM MAP REQID MAP is optional but if present fields are required def ...

Page 141: ... L2 04 ZTOTAL MSG type ZSPI DDL INT 04 ZMSG SENT type ZSPI DDL INT 04 ZMSG RECVED type ZSPI DDL INT 04 ZSHORT BUF type ZSPI DDL INT 04 ZL2 ERR type ZSPI DDL INT 04 ZNAK type ZSPI DDL INT 04 ZBCC ERR type ZSPI DDL INT 04 ZFRMT ERR type ZSPI DDL INT 04 ZRETRY type ZSPI DDL INT 04 ZMSG L256 SENT type ZSPI DDL INT 04 ZMSG L256 RECVED type ZSPI DDL INT 04 ZMSG L1024 SENT type ZSPI DDL INT 04 ZMSG L1024...

Page 142: ...ion can optionally pro vide These tokens are described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZCOM TKN SUB specifies whether subordinates are to be affected by the RESETSTATS command For the RESETSTATS command the possible values of this token are as follows ZCOM VAL SUB ALL If the object type is LINE return information and res...

Page 143: ...s in Section 5 for details ZTR3 MAP RSTATS LINE is the extensible structured token that lists the statistical counters obtained during the sample period for the line It has the token number ZTR3 TNM RSTATS LINE and the DDL definition ZTR3 DDL RSTATS LINE Each counter is defined in a separate field The fields in the ZTR3 MAP RSTATS LINE token are as follows ZRESET TIME is the time that the TR3271 s...

Page 144: ...level 2 for the specified line ZNAK is the number of Negative Acknowlegements NAKS that the TR3271 subsystem sent to the the specified line ZBCC ERR is the number of BCC errors that occurred at level 2 for the specified object ZFRMT ERR is the number of format errors that occurred at level 2 for the specified line ZRETRY is the number of retries attempted by the TR3271 subsystem at level 2 for the...

Page 145: ...ed subdevice ZMSG SENT is the number of messages that were sent from the TR3271 subsystem to the specified subdevice ZMSG RECVED is the number of messages that were received by the TR3271 subsystem from the specified subdevice ZSPI TKN DATALIST indicates the beginning of a data list See SPI Standard Definitions in Section 5 for details ZCOM TKN OBJNAME specifies the name of the TR3271 line or subd...

Page 146: ...COM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR TKN VAL INV 30 Your management application specified the SUB modifier with the value ZCOM VAL SUB ONLY for the SU object The SU object accepts only the value ZCOM VAL SUB NONE or ZCOM VAL SUB ALL for the SUB modifier ZCOM ERR CMD MISMATCH 4 Your management application tried to obtain statistical infor mation for a process by using the value ZCO...

Page 147: ...hen the command is completed the line and subdevices remain in the same summary state they were in before the command was executed The summary state of the line is not checked when the command is issued For statistical information without initializing the counters use the STATISTICS command 6 83 ...

Page 148: ...cified line are started the line must already be in the STARTED summary state If the value of the modifier is ZCOM VAL SUB ALL the subsystem starts the line and then all the associated subdevices If the value is ZCOM VAL SUB NONE only the line is started The value ZCOM VAL SUB NONE has the same effect as if the SUB modifier was not present in the command buffer When your management application iss...

Page 149: ...JNAME token type ZSPI TYP STRING ZCOM TKN OBJTYPE token type ZSPI TYP ENUM ZSPI TKN ERRLIST token type ZSPI TYP LIST ZSPI TKN ENDLIST token type ZSPI TYP SSCTL ZSPI TKN RETCODE token type ZSPI TYP ENUM ZSPI TKN ENDLIST token type ZSPI TYP SSCTL ZSPI TKN CONTEXT token type ZSPI TYP BYTESTRING Tokens in Command Buffer ZCOM TKN OBJNAME specifies the line and subdevices that are to be started Your app...

Page 150: ...t is started If this token is not present and the LINE or SU object is specified the command affects only the named object ZSPI TKN MANAGER SSID MAXRESP CONTEXT RESPONSE TYPE ALLOW TYPE and COMMENT are standard SPI tokens With the exception of the ZSPI TKN SSID token which your management application must pass to SSINIT these tokens are optional These tokens are described in SPI Standard Definitio...

Page 151: ...ken is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual For details on the data communications error numbers and their associated error lists see Common Error Numbers and Error Lists in the Communications Management Programming Manual The possible nonzero values of RETCODE in response to the START command are as follows ZCOM ERR EMPT ...

Page 152: ... list See SPI Standard Definitions in Section 5 for details ZSPI TKN CONTEXT specifies whether there are more reply messages to be received for a response If this token is present the response continues to the next reply message If this token is not present the reply message is the last to be received See SPI Standard Definitions in Section 5 for details Operational Notes START is a sensitive comm...

Page 153: ... by the ZRESET TIME and ZSAMPLE TIME fields You can issue this command for a line or a subdevice but not a process The line summary state is not checked by the TR3271 subsystem when you issue the STATISTICS command All valid users can issue the STATISTICS command Command ZCOM CMD STATISTICS Object Type ZCOM OBJ LINE or ZCOM OBJ SU Tokens in Command Buffer ZCOM TKN OBJNAME token type ZSPI TYP STRIN...

Page 154: ...ZFRAME ERR type ZSPI DDL INT 04 ZNO BUF type ZSPI DDL INT 02 ZTR3 LINE L2 04 ZTOTAL MSG type ZSPI DDL INT 04 ZMSG SENT type ZSPI DDL INT 04 ZMSG RECVED type ZSPI DDL INT 04 ZSHORT BUF type ZSPI DDL INT 04 ZL2 ERR type ZSPI DDL INT 04 ZNAK type ZSPI DDL INT 04 ZBCC ERR type ZSPI DDL INT 04 ZFRMT ERR type ZSPI DDL INT 04 ZRETRY type ZSPI DDL INT 04 ZMSG L256 SENT type ZSPI DDL INT 04 ZMSG L256 RECVE...

Page 155: ...ications tokens that your application can optionally pro vide These tokens are described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZCOM TKN SUB specifies whether subordinates are to be affected by the STATISTICS command For the STATISTICS command the possible values of this token are as follows ZCOM VAL SUB ALL If the object type ...

Page 156: ...for the line It has the token number ZTR3 TNM STATS LINE and the DDL definition ZTR3 DDL STATS LINE Each counter is defined in a separate field The fields in the ZTR3 MAP STATS LINE token are as follows ZRESET TIME is the time that the TR3271 subsystem read the counters This time indicates the end of the sample period ZSAMPLE TIME is the last time that the counters were reset This time indicates t...

Page 157: ...d line ZBCC ERR is the number of BCC errors that occurred at level 2 for the specified object ZFRMT ERR is the number of format errors that occurred at level 2 for the specified line ZRETRY is the number of retries attempted by the TR3271 subsystem at level 2 for the specified line ZMSG L256 SENT is the number of messages which were less than 256 bytes in length that the TR3271 subsystem sent to t...

Page 158: ... TR3271 subsystem to the specified subdevice ZMSG RECVED is the number of messages that were received by the TR3271 subsystem from the specified subdevice ZSPI TKN DATALIST indicates the beginning of a data list See SPI Standard Definitions in Section 5 for details ZCOM TKN OBJNAME specifies the name of the TR3271 line or subdevice for which statistical information was requested Unless there is an...

Page 159: ...4 ZCOM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR TKN VAL INV 30 Your management application specified the SUB modifier with the value ZCOM VAL SUB ONLY for the SU object The SU object accepts only the value ZCOM VAL SUB NONE or ZCOM VAL SUB ALL for the SUB modifier ZCOM ERR CMD MISMATCH 4 Your management application tried to obtain statistical infor mation for a process by using the value ...

Page 160: ...CS is a nonsensitive command any valid user can issue this command The summary state of the line does not prevent the successful completion of the STATISTICS command To initialize the statistical counters after the reply message is built use the RESETSTATS command 6 96 ...

Page 161: ...mmand affects subordinate objects The select state modifier allows your management application to inquire about objects based on their current summary state You can select objects by the summary state they are in or by a summary state they are not in For example if your management application wanted information about objects not in the STARTED summary state the Boolean value portion of the select ...

Page 162: ... INT PAIR ZSPI TKN MANAGER token type ZSPI TYP FNAME32 ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN MAXRESP token type ZSPI TYP INT ZSPI TKN CONTEXT token type ZSPI TYP BYTESTRING ZSPI TKN RESPONSE TYPE token type ZSPI TYP ENUM ZSPI TKN ALLOW TYPE token type ZSPI TYP ENUM ZSPI TKN COMMENT token type ZSPI TYP STRING Tokens in Response Buffer ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN SERVER...

Page 163: ...UB def ZTR3 DDL STATUS SU All fields are present 02 ZSDN type ZSPI DDL INT 02 ZSTATE type ZSPI DDL ENUM 02 ZSTATUS type ZSPI DDL INT 02 ZFLAGS type ZSPI DDL INT 02 ZLAST ERR type ZSPI DDL INT 02 ZIS PTP type ZSPI DDL BOOLEAN 02 ZHIS SYS NUM type ZSPI DDL INT 02 ZHIS LDEV type ZSPI DDL INT 02 ZHIS SDN type ZSPI DDL INT 02 ZHIS CU type ZSPI DDL INT 02 ZHIS DA type ZSPI DDL INT end ZCOM TKN OBJNAME t...

Page 164: ...llows ZCOM VAL SUB ALL If the object type is LINE return information for the named line and all its subordinate subdevices If the object type is SU return information about the named subdevice ZCOM VAL SUB ONLY If the object type is LINE return information for the subdevices subordinate to the named line the line is not to be affected by this command This value is invalid for the SU object type ZC...

Page 165: ...formation for objects not in the STARTED summary state The objects for which information is returned depends on the named object and the value of the SUB modifier FALSE STOPPED Return information for objects not in the STOPPED summary state The objects for which information is returned depends on the named object and the value of the SUB modifier FALSE DIAGNOSING Return information for objects not...

Page 166: ...cified in the command and the ZCOM VAL SUB ONLY modifier is not present Each field contains discrete status information The fields in the ZTR3 MAP STATUS LINE token are as follows ZSTATE is the summary state of the object The value of this field can be one of the following ZCOM VAL SUMSTATE DIAG The line is in the DIAGNOSING summary state ZCOM VAL SUMSTATE STARTED The line is in the STARTED summar...

Page 167: ... is the logical device number of the CSM for the line ZCU PRIM is the primary path to the LIU for the line ZCU BKUP is the backup path to the LIU for the line ZDEBUG is a Boolean variable that specifies whether the CLIP debug interface is enabled The value of this field can be one of the following ZTR3 VAL DEBUG OFF The CLIP debug interface is not enabled ZTR3 VAL DEBUG ON The CLIP debug interface...

Page 168: ... subdevice number ZSTATE is the summary state of the object The value of this field can be one of the following ZCOM VAL SUMSTATE STARTED The line is in the STARTED summary state ZCOM VAL SUMSTATE STOPPED The line is in the STOPPED summary state ZSTATUS is the status of the subdevice ZFLAGS is a bit array that indicates status information for the subdevice The status can be a combination of these ...

Page 169: ... the number of the line to which the TR3271 subdevice is subordinate This field applies only to PTP subdevices ZHIS SDN is the subdevice number of the TR3271 subdevice This field applies only to PTP subdevices ZHIS CU is the controller number of the TR3271 subdevice This field applies only to PTP subdevices ZHIS DA is the device address of the TR3271 subdevice This field applies only to PTP subdev...

Page 170: ...ommon Error Numbers and Error Lists in the Communications Management Programming Manual For details on the TR3271 error numbers and their associated error lists see Appendix A in this manual The possible nonzero values of RETCODE in response to the STATUS command are as follows ZCOM ERR EMPT RSP 33 ZCOM ERR TKN REQ 29 ZCOM ERR TKN DUP 27 ZCOM ERR TKN CODE INV 26 ZCOM ERR SUB NOT FOUND 25 ZCOM ERR ...

Page 171: ...e received for a response If this token is present the response continues to the next reply message If this token is not present the reply message is the last to be received This token is described in SPI Standard Definitions in Section 5 Common Definitions and the Distributed Systems Management Programming Manual Operational Notes STATUS is a nonsensitive command any valid user on the system can ...

Page 172: ...nagement application issues the STOP command for a line the subsystem checks for the optional subordinate modifier token If the value of the modifier is ZCOM VAL SUB ONLY the subsystem stops only the subdevices attached to the specified line If the value of the modifier is ZCOM VAL SUB ALL the subsystem stops the subdevices first then the line If the value ZCOM VAL SUB NONE is specified the subsys...

Page 173: ...ZSPI TKN MAXRESP token type ZSPI TYP INT ZSPI TKN CONTEXT token type ZSPI TYP BYTESTRING ZSPI TKN RESPONSE TYPE token type ZSPI TYP ENUM ZSPI TKN ALLOW TYPE token type ZSPI TYP ENUM ZSPI TKN COMMENT token type ZSPI TYP STRING Tokens in Response Buffer ZSPI TKN SSID token type ZSPI TYP SSID ZSPI TKN SERVER VERSION token type ZSPI TYP INT ZSPI TKN DATALIST token type ZSPI TYP LIST ZCOM TKN OBJNAME t...

Page 174: ...l its subordinate subdevices If the object type is SU terminate the named subdevice ZCOM VAL SUB ONLY If the object type is LINE terminate the subdevices subordinate to the named line The line is not to be affected by this command This value is not valid with the SU object ZCOM VAL SUB NONE Terminate the named line or named subdevice If this token is not present and the LINE or SU object is specif...

Page 175: ...SU This token is described in SPI Standard Definitions in Section 5 Common Definitions and the Distributed Systems Management DSM Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list See SPI Standard Definitions in Section 5 for details ZSPI TKN RETCODE specifies the return code for the command This token is described in SPI Standard Definitions in Section 5 and the Distrib...

Page 176: ... Your management application issued the STOP command for the LINE object type but there is one or more subordinate SUs that are opened by an application This message applies only when the LINE object has been specified but does not apply when the LINE object has been specified with the SUB modifier that has the value ZCOM VAL SUB ONLY ZTR3 ERR CONN EXIST 12 Your management application issued the S...

Page 177: ...uted Systems Management DSM Programming Manual Operational Notes STOP is a sensitive command When the command is completed the object is placed in the STOPPED summary state If both a line and its subordinate subdevices are to be stopped the subdevices are stopped first and then the line The line must not be in the DIAGNOSING summary state STOPPED summary state or in the STARTED summary state with ...

Page 178: ...IAG summary state When your management application issues the SWITCH command for the PROC or LINE object the resource being switched to must exist and cannot be the same one currently in use by the named object If the resource does not exist the command is rejected If the resource is currently in use the command completes with a warning In addition if the ZCOM TKN SWITCH CPU is specified the CPU b...

Page 179: ...e ZSPI TYP SSCTL ZSPI TKN RETCODE token type ZSPI TYP ENUM ZSPI TKN ENDLIST token type ZSPI TYP SSCTL Tokens in Command Buffer ZCOM TKN OBJNAME specifies the line name associated with the process to be switched Your application must provide this token in the command This token is described in Data Communications Standard Definitions in Section 5 Common Definitions and the Communications Management...

Page 180: ... tokens With the exception of the ZSPI TKN SSID token which your management application must pass to SSINIT these tokens are optional These tokens are described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Tokens in Response Buffer ZSPI TKN SSID is an echo of the subsystem ID value provided by your application See SPI Standard Definitions i...

Page 181: ...tions Management Programming Manual The possible nonzero values of RETCODE or within the error list in response to the SWITCH command are as follows ZCOM ERR EMPT RSP 33 ZCOM ERR TKN VAL INV 30 ZCOM ERR TKN REQ 29 ZCOM ERR TKN DUP 27 ZCOM ERR TKN CODE INV 26 ZCOM ERR SSID INV 24 ZCOM ERR SECUR VIOL 22 ZCOM ERR OBJ NOT SUPP 18 ZCOM ERR FNAME INV 9 ZCOM ERR CMD TIMED OUT 7 ZCOM ERR RES NOT CONFIG 21...

Page 182: ...I TKN ENDLIST indicates the end of a data list or an error list See SPI Standard Definitions in Section 5 for details Operational Notes SWITCH is a sensitive command When the command is completed the process and line remain in the same summary state they were in before the command was executed The line must not be in the DIAGNOSING summary state when this command is issued Use the STATUS command t...

Page 183: ...n of the trace environment and termination of trace mode This fixed structure along with one or more ZCOM TKN TRACE OPT tokens are sent to SCP The ZCOM TKN TRACE OPT tokens are the trace options selected by your management application From these trace options which have enumerated type values the SCP creates a bit mask that is sent to the subsystem The subsystem uses this bit mask to determine the...

Page 184: ...INT 02 ZCOLL type ZSPI DDL BOOLEAN 02 FNAME type ZSPI DDL FNAME32 end ZCOM TKN TRACE OPT token type ZSPI TYP ENUM ZCOM MAP REQID MAP is optional but if present fields are required def ZCOM DDL REQID 02 ZCRTPID type ZSPI DDL CRTPID 02 ZPAID type ZSPI DDL INT end ZCOM TKN CMD TIMEOUT token type ZSPI TYP TIMESTAMP ZSPI TKN MANAGER token type ZSPI TYP FNAME32 ZSPI TKN SSID token type ZSPI TYP SSID ZSP...

Page 185: ...a Communications Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZCOM MAP TRACE MODIF is a standard data communications token described in the Communications Management Programming Manual This token is required in the command and duplicate occurrences are not allowed ZCOM TKN TRACE OPT specifies the trace option s that your man agement appl...

Page 186: ...es of ZCOM TKN TRACE OPT are allowed You can select more than one option ZCOM MAP REQID and ZCOM TKN CMD TIMEOUT are standard data communications tokens that your application can optionally provide These tokens are described in Data Communications Standard Definitions in Section 5 and the Communications Management Programming Manual ZSPI TKN MANAGER SSID MAXRESP CONTEXT RESPONSE TYPE ALLOW TYPE an...

Page 187: ...ations Standard Definitions in Section 5 Common Definitions and the Communications Management Programming Manual ZSPI TKN ERRLIST indicates the beginning of an error list This token is described in the Distributed Systems Management DSM Programming Manual ZSPI TKN RETCODE specifies the return code for the command This token is described in SPI Standard Definitions in Section 5 and the Distributed ...

Page 188: ...messages to be received for a response If this token is present the response continues to the next reply message If this token is not present the reply message is the last to be received This token is described in SPI Standard Definitions in Section 5 and the Distributed Systems Management DSM Programming Manual Operational Notes TRACE is a sensitive command This command is processed by CMP by mea...

Page 189: ...efer to the Event Management Service EMS Manual For information on how event messages can be obtained interactively refer to the VIEWPOINT Manual In this section event message tokens and their values are represented in DDL For a quick explanation of DDL as it applies to SPI refer to the appendix Overview of DDL for SPI in the Distributed Systems Management DSM Programming Manual SUBSYSTEM PROCESSE...

Page 190: ...PROC ABEND SYSGEN parameter error 106 INSUFF BUF Line handler buffer too small 112 DISCARD ERR Discard error message 141 CLIP DWLOAD CLIP downloaded 147 CSS PROBE ERR CLIP status probe error 157 CSS FRAME ERR Frame error 158 CSS UNEXP BRKPT Unexpected breakpoint 160 CSS LIU CONFIG ERR Line configuration error 164 CSS LINE ERR Invalid function modifier 165 CSS SUBDEV ERR Invalid subdevice state EVE...

Page 191: ...ning one piece of information about the event There are no extensible structured tokens or lists in these event messages Some TR3271 event messages are reported to EMS some are reported to both EMS and the Tandem Maintenance and Diagnostic System TMDS and some only to TMDS TMDS events are intended for internal Tandem use only and will not be discussed in this manual All messages are also displayed...

Page 192: ...age Header tokens are listed here because an application can filter event messages by header tokens as well as by other tokens for example the subsystem ID These tokens are divided into three categories 1 Unconditional tokens tokens that are always present in the event message 2 Volatile tokens tokens that are subject to change from release to release 3 Tandem internal tokens those intended for Ta...

Page 193: ...e text version of an event message is available through the EMSTEXT procedure and it contains a standard header that includes the date time system name and other information For further information on the standard header refer to the Event Management Service EMS Manual The text shown in the box follows this standard header When you use the EMSTEXT procedure to get the text version of an event mess...

Page 194: ...pe ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI ...

Page 195: ...indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message to its log files Z...

Page 196: ...system switches to the backup process and aborts all requests Note that the backup process does not retry the operation once the switch has occurred The valid file system error numbers given by the value file err in the text message must be in the range 214 through 229 The values of file err are as follows file err Meaning 214 Channel timeout 215 I O attempted to absent memory page 216 Memory brea...

Page 197: ... Report this message and other related console messages to your Tandem representative The remaining errors indicate a possible hardware problem Report this message and other related console messages to your Tandem representative Provide your Tandem representative with as much information as possible about the activity occurring at the time of this event message 7 9 ...

Page 198: ...VNAME token type ZSPI TYP FNAME32 ZEMS TKN LDEV token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM t...

Page 199: ...ns the value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event ...

Page 200: ...of ZEMS MAP EXIOADDR ldevname corresponds to the value of ZEMS TKN LDEVNAME and ciu status corresponds to the value ZTR3 TKN CIU STATUS Probable Cause An error occurred on the indicated line The I O process attempts a retry If the problem persists another path or processor is tried If another path or processor is not available the system brings down the line The value ciu status in the text messag...

Page 201: ...ceiver underrun param retry 12 incoming CLB bits not modulo 256 param retry 13 CLB output WAK timeout param retry 14 CLB input enable WAK timeout OUTPUT 15 FLAK timeout clear retry 16 CLIP BOB protocol violation clear retry 17 reserved should not happen clear retry 20 LOCS address out of range ABORT 21 LOCS block exceeds end of RAM ABORT 22 LOCS block sizes do not match ABORT 23 LOCS block invalid...

Page 202: ...R3271 EVENT MANAGEMENT 4 ZTR3 EVT CIU ERR Recommended Action The information given by the value ciu status in the text message usually indicates a hardware problem contact your Tandem representative 7 14 ...

Page 203: ...ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR Event Message Text Display and Console Compatible Format LDEV ldev ldevname UP Unco...

Page 204: ...CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message to its log files ZEMS TKN PIN is the PIN of the TR3271 subsystem that reported the event ZEMS TKN SYSTEM is the EXPAND system number of the system node on which the event was rep...

Page 205: ...grammatically using the START command or interactively using the SCF or CMI START LINE command For a description of the programmatic START command for TR3271 see START Command in Section 6 Commands and Responses The operation is completed Recommended Action This event message is an informative message only no corrective action is needed 7 17 ...

Page 206: ...ECT MARK token type ZSPI TYP MARK ZEMS TKN LDEVNAME token type ZSPI TYP FNAME32 ZEMS TKN LDEV token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN ...

Page 207: ...sponds to the value ldev in the text message ZEMS TKN EMPHASIS contains the value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event me...

Page 208: ...robable Cause The TR3271 line has been brought down programmatically with the STOP or ABORT command or interactively with the SCF or CMI STOP or ABORT command or the TR3271 subsystem brought down the line because of errors All activity on the line stops Recommended Action If this event was not caused by a command note console messages and any information about activity occurring at the time of thi...

Page 209: ...NSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZTR3 TKN SU token type ZSPI TYP UINT ZTR3 TKN FILE ERR token...

Page 210: ...ess ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message to its log files ZEMS TKN PIN is the PIN of the TR3271 subsystem that reported the event ZEMS TKN SYSTEM is the EXPAND system number of the system node on which the event was reported ZEMS TKN USE...

Page 211: ...se An operation or a request to the indicated TR3271 subdevice is incorrect The value ldev identifies the TR3271 line the value ddd identifies the subdevice and the value file err identifies the file system error number Recommended Action Appropriate recovery action depends on the file system error that occurred For information on file system errors and how to recover from them refer to the System...

Page 212: ...OLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR Volatile Tokens ZEMS TKN CU token type ZSPI TYP UINT Tandem Internal Tokens ZEMS MAP EXIOADDR ...

Page 213: ...ASIS contains one of the following values ZSPI VAL TRUE This event is critical ZSPI VAL FALSE This event is not critical The event message contains debugging information for an event that follows ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is th...

Page 214: ...value of ZEMS TKN LDEVNAME and the remaining values are internal tokens Probable Cause An internal error has been detected After this event message is issued application requests are aborted and the TR3271 subsystem recovers Recommended Action If the TR3271 subsystem can recover from the internal error you can continue to run Otherwise report this and other related event messages to your Tandem re...

Page 215: ...token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token ty...

Page 216: ... TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message to its log files ZEMS TKN PIN is the PIN of the TR3271 subsystem that reported the event ZEMS TKN SYSTEM is the EXPAND system number of the system node on which the event was reported ZEMS TKN USERID is the user ID of the TR3271 subsystem reporting th...

Page 217: ...emory related errors 1 999 are as follows Error Code Meaning 1 ALLOCATESEGMENT failed 2 USESEGMENT failed 3 LOCKMEMORY failed 4 DEFINEPOOL failed 5 GETLOCALPOOL failed 6 GETLOCALPOOL from translation table failed 7 Remaining memory less than MAXLOCALAREA 8 GETLOCALPOOL for ZSPI failed 9 ALLOCATE XSEG for ZSPI failed 10 DEFINEPOOL for ZSPI failed The configuration related errors 1000 1999 are as fo...

Page 218: ...ommended Action If the error code is memory related 1 999 take a memory dump and contact your Tandem representative If the error code is configuration related 1000 1999 reconfigure the process correctly using COUP commands and restart the process 7 30 ...

Page 219: ...ZSPI TYP MARK ZEMS TKN LDEVNAME token type ZSPI TYP FNAME32 ZEMS TKN LDEV token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI ...

Page 220: ...VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message to its lo...

Page 221: ...ZEMS TKN LDEVNAME Probable Cause The MAXLOCALAREA modifier defined in SYSGEN does not specify the necessary buffer space The line handler does not accept any operations Recommended Action Reconfigure the system specifying a larger buffer with the MAXLOCALAREA modifier The MAXLOCALAREA specifies the largest buffer obtainable from the local pool The default is 2048 words 7 33 ...

Page 222: ...pe ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZTR3 TKN SU token type ZSPi TYP UINT Event Message Text Display and Console Compatible Format LDEV ldev ldevname DAX SUBD...

Page 223: ...bsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message to its log files ZEMS TKN PIN is the PIN of the TR3271 subsystem that reported the event ZEMS TKN SYSTEM is the EXPAND system number of the system node on which the event was reported ZEMS TKN USERID is the user ID of the TR3271 subsystem reporting the event ZTR3 TKN SU is the subdevice that h...

Page 224: ... command An INITSTATUS of 177777 causes the TR3271 subsystem to respond to SELECTs sent from a host to subdevices that are neither OPENed nor CONNECTed with an ACK0 An ACK0 indicates that the data from the host which is unsolicited is acknowledged However the data is dicarded because the target SU is not ready to receive it Recommended Action Verify that the subdevice identified by the value ddd h...

Page 225: ...type ZSPI TYP FNAME32 ZEMS TKN LDEV token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZS...

Page 226: ... EMPHASIS contains the value ZSPI VAL FALSE indicating that this event is not a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the coll...

Page 227: ...f ZEMS TKN LDEV n n nn nnn corresponds to the value of ZEMS MAP EXIOADDR and ldevname corresponds to the value of ZEMS TKN LDEVNAME Probable Cause The CLIP of the 6100 CSS was successfully downloaded The value of ZCOM TKN NEW PATH indicates the path used for downloading The possible values are as follows 020101 Path B is primary ZCOM VAL PATH B 020102 Path A is primary ZCOM VAL PATH A The operatio...

Page 228: ...N SUBJECT MARK token type ZSPI TYP MARK ZEMS TKN LDEVNAME token type ZSPI TYP FNAME32 ZEMS TKN LDEV token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEM...

Page 229: ...he value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event mes...

Page 230: ... NEW PATH and probe err corresponds to the value of ZTR3 TKN PROBE ERR Probable Cause The TR3271 subsystem received a status probe response from the CLIP indicating that it is in the boot state instead of the run state The TR3271 subsystem attempts to download the CLIP again If this cannot be done on the primary path TR3271 attempts a download on another path The value path indicates the primary p...

Page 231: ...ecommended Action Decode the CLIP status byte given by the value probe err of the message text to determine which error occurred and note the error for your Tandem representative If the CLIP does not restart automatically try to restart it manually 7 43 ...

Page 232: ...HASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZCOM TKN NEW PA...

Page 233: ...alue ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event message...

Page 234: ... the event buffer only if the controller uses subchannel type I O addressing Event Message Text In the message text ldev corresponds to the value of ZEMS TKN LDEV n n nn nnn corresponds to the value of ZEMS MAP EXIOADDR ldevname corresponds to the value of ZEMS TKN LDEVNAME path corresponds to the value of ZCOM TKN NEW PATH frame err corresponds to the value of ZTR3 TKN FRAME ERR param1 correspond...

Page 235: ...ield sequence number 5 Invalid function 6 Not the expected response to the command 7 Type 6 error message received from CLIP 10 Not the expected multiframe type received The value param1 in the text message contains the CIU to LIU Bus CLB frames A and C and param2 contains the CLB frames T and S Recommended Action If this event occurs other than during a path switch note the values of nn param1 an...

Page 236: ...EV token type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token...

Page 237: ...he value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event mes...

Page 238: ...message text ldev corresponds to the value of ZEMS TKN LDEV n n nn nnn corresponds to the value of ZEMS MAP EXIOADDR ldevname corresponds to the value ZEMS TKN LDEVNAME path corresponds to the value of ZCOM TKN NEW PATH and param1 corresponds to the value of ZTR3 TKN CLIP FUNC Probable Cause The CLIP of the 6100 CSS encountered an unexpected breakpoint and has stopped Recommended Action Note the v...

Page 239: ...type ZSPI TYP UINT ZEMS TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSP...

Page 240: ...lue ldev in the text message ZEMS TKN EMPHASIS contains the value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN L...

Page 241: ...EMS TKN LDEV n n nn nnn corresponds to the value of ZEMS MAP EXIOADDR ldevname corresponds to the value ZEMS TKN LDEVNAME path corresponds to the value ZCOM TKN NEW PATH config err corresponds to the value ZTR3 TKN CONFIG ERR param1 corresponds to the value ZTR3 TKN CLIP FUNC Probable Cause The CLIP of the 6100 CSS received a line configuration different from that in the I O process The line does ...

Page 242: ...TKN EMPHASIS token type ZSPI TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZCOM TKN...

Page 243: ...value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event messag...

Page 244: ... ZEMS MAP EXIOADDR ldevname corresponds to the value of ZEMS TKN LDEVNAME path corresponds to the value ZCOM TKN NEW PATH param1 corresponds to the value ZTR3 TKN CLIP FUNC param2 corresponds to the value ZTR3 CLIP STATUS and param3 corresponds to the value ZTR3 TKN CLIP SU Probable Cause The CSS CLIP responded to the I O process with an invalid function modifier The value of param1 indicates the ...

Page 245: ...t 21 Read buffer too small 22 Reset request received 23 EOT received 24 Unknown device status 25 Line overran CLIP 26 Not used 27 Operation timeout 28 Line not configured 29 Invalid parameter 30 SU not ready 31 RVI received with status The value of param3 indicates the CLIP subdevice number Recommended Action Note the values of all the parameters in the message text and contact your Tandem represe...

Page 246: ... TYP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZCOM TKN NEW PATH token type ZSPI TY...

Page 247: ...e value ZSPI VAL TRUE indicating that this event is a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event mess...

Page 248: ...DR ldevname corresponds to the value of ZEMS TKN LDEVNAME path corresponds to the value ZCOM TKN NEW PATH param1 corresponds to the value ZTR3 TKN CLIP SU param2 corresponds to the value ZTR3 CLIP FUNC and param3 corresponds to the value ZTR3 TKN CLIP STATUS Probable Cause The CSS CLIP responded to the I O process with an invalid subdevice state The value of param1 indicates the subdevice number T...

Page 249: ...e in device 20 Improper buffer format 21 Read buffer too small 22 Reset request received 23 EOT received 24 Unknown device status 25 Line overran CLIP 26 Not used 27 Operation timeout 28 Line not configured 29 Invalid parameter 30 SU not ready 31 RVI received with status Recommended Action Note the values of all the parameters in the message text and contact your Tandem representative 7 61 ...

Page 250: ... PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZCOM TKN NEW CPU token type ZSPI TYP INT ZCOM TKN OLD CPU token t...

Page 251: ...MPHASIS contains the value ZSPI VAL FALSE indicating that this event is not a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collec...

Page 252: ... message text ldev corresponds to the value of ZEMS TKN LDEV n n nn nnn corresponds to the value of ZEMS MAP EXIOADDR ldevname corresponds to the value of ZEMS TKN LDEVNAME cpu1 corresponds to the value of ZCOM TKN OLD CPU cpu2 corresponds to the value of ZCOM TKN NEW CPU and reason corresponds to the value of ZCOM TKN CAUSE CPU SWITCH Probable Cause The TR3271 I O process switches to the backup C...

Page 253: ...YP BOOLEAN ZEMS TKN CONSOLE PRINT token type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZCOM TKN NEW PATH token type ZSPI TYP ...

Page 254: ...sage ZEMS TKN EMPHASIS contains the value ZSPI VAL FALSE indicating that this event is not a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time ...

Page 255: ... OP REQ OPERATOR REQUESTED ZCOM VAL HW of HARDWARE OR LOW LEVEL SOFTWARE PROBLEM ZCOM VAL TAKOVR TAKEN OVER BY PRIMARY Volatile Tokens ZEMS TKN CU is a standard EMS token that contains the controller and unit number This token is present in the event buffer only if the controller uses subchannel type I O addressing Event Message Text In the message text ldev corresponds to the value of ZEMS TKN LD...

Page 256: ...r as a result of a software or hardware error The SWITCH command can be issued programmatically or interactively See Section 6 Commands and Responses for a description of the programmatic SWITCH command Recommended Action If a command caused the switch no action is necessary If not note the reason code and contact your Tandem representative 7 68 ...

Page 257: ... type ZSPI TYP BOOLEAN ZEMS TKN CPU token type ZSPI TYP UINT ZEMS TKN CRTPID token type ZSPI TYP CRTPID ZEMS TKN GENTIME token type ZSPI TYP TIMESTAMP ZEMS TKN LOGTIME token type ZSPI TYP TIMESTAMP ZEMS TKN PIN token type ZSPI TYP UINT ZEMS TKN SYSTEM token type ZSPI TYP UINT ZEMS TKN USERID token type ZSPI TYP BYTE PAIR ZCOM TKN OBJSTATE token type ZSPI TYP ENUM ZCOM TKN OLD OBJSTATE token type Z...

Page 258: ...e value ZSPI VAL FALSE indicating that this event is not a critical event ZEMS TKN CONSOLE PRINT contains the value ZSPI VAL TRUE ZEMS TKN CPU is the CPU of the TR3271 subsystem ZEMS TKN CRTPID is the process ID of the TR3271 subsystem reporting the event ZEMS TKN GENTIME is the time that the TR3271 subsystem created the event message ZEMS TKN LOGTIME is the time that the collector wrote the event...

Page 259: ... if the controller uses subchannel type I O addressing Event Message Text In the message text ldev corresponds to the value of ZEMS TKN LDEV n n nn nnn corresponds to the value of ZEMS MAP EXIOADDR ldevname corresponds to the value of ZEMS TKN LDEVNAME state1 corresponds to the value of ZCOM TKN OLD OBJSTATE state2 corresponds to the value of ZCOM TKN OBJSTATE and reason corre sponds to the value ...

Page 260: ...Ds that are not initialized in the filter have been initialized by other means For more information on filters refer to the Event Management Service EMS Manual Example 1 The following filter selects all of the TR3271 event messages Filter that selects only event messages issued by the TR3271 subsystem SET ztr3 val ssid zspi val tandem zspi ssn ztr3 ztr3 val version FILTER tr3271 messages BEGIN IF ...

Page 261: ...ave as their subject token a particular line name SET ztr3 val ssid zspi val tandem zspi ssn ztr3 ztr3 val version FILTER critical tr3271 msgs BEGIN IF zspi tkn ssid SSID ztr3 val ssid THEN This is an TR3271 event message IF zems tkn emphasis zspi val true THEN This is a critical event message ELSE This is not a critical event message FAIL ELSE This is not an TR3271 event message FAIL END of criti...

Page 262: ...g Manual The following descriptions are in ascending numerical order NOTATION USED For each error list description on the pages that follow there is a box that contains a list of the simple and structured tokens that can appear in the error list Included are the tokens ZSPI TKN ERRLIST and ZSPI TKN ENDLIST which start and end all error lists With the exception of ZSPI TKN ERRLIST and ZSPI TKN ENDL...

Page 263: ...ed The tokens ZSPI TKN ERRLIST and ZSPI TKN ENDLIST serve the same function in all error lists They are not described in this section Information about these tokens can be found in the Distributed Systems Management DSM Programming Manual A 2 ...

Page 264: ... the error number ZTR3 ERR CLIP PROB This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in the error list Otherwise i...

Page 265: ...ubsystem ID and the error number ZTR3 ERR TARGET OBJ NOT FOUND This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in ...

Page 266: ...SPI TYP ENUM ZSPI TKN ENDLIST type ZSPI TYP SSCTL Tokens ZSPI TKN ERROR is the standard SPI error token described in the Distributed Systems Management DSM Programming Manual Its value consists of the target subsystem ID and the error number ZTR3 ERR ATTR CONFL SU This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This toke...

Page 267: ...ERROR NUMBERS AND ERROR LISTS 4 ZTR3 ERR ATTR CONFL SU Recommended Action Redefine the LINE and SU attributes so that they will be consistent A 6 ...

Page 268: ...or list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in the error list Otherwise it is omitted from the list ZCOM TKN OBJTYPE is the object type provided with...

Page 269: ...he target subsystem ID and the error number ZTR3 ERR ALRDY USING ADDR This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is pres...

Page 270: ... the target subsystem ID and the error number ZTR3 ERR NO OBJ IN SEL STATE This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is...

Page 271: ... ZTR3 ERR OPENED SU EXIST This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in the error list Otherwise it is omitte...

Page 272: ...error number ZTR3 ERR TARGET OBJNAME INV This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in the error list Otherwi...

Page 273: ...ubsystem ID and the error number ZTR3 ERR NO OWNER This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in the error li...

Page 274: ...error number ZTR3 ERR CONN EXIST This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem made choices based on the object name this token is present in the error list Otherwise it is...

Page 275: ...ms Management DSM Programming Manual Its value consists of the target subsystem ID and the error number ZTR3 ERR SU OPENED This token is always present in the error list ZCOM TKN OBJNAME is the object name on which the error occurred in the command This token is present in the error list if its presence is relevant to the cause of the error That is if the error was detected after the subsystem mad...

Page 276: ... file depends on ZSPIDDL SECTION constants SETSECTION constants TR3271 version definition value change with each release CONSTANT ZTR3 VAL VERSION VALUE IS VERSION C20 TR3271 subsystem descriptor DEF ZTR3 VAL SSID TACL SSID 02 Z Filler TYPE CHARACTER 8 VALUE IS ZSPI VAL TANDEM 02 Z Owner REDEFINES Z FILLER TYPE ZSPI DDL CHAR8 02 Z Num TYPE ZSPI DDL INT VALUE IS ZSPI SSN ZTR3 02 Z Vsn TYPE ZSPI DDL...

Page 277: ...TUS LINE VALUE IS 2100 CONSTANT ZTR3 TNM STATUS SU VALUE IS 2110 CONSTANT ZTR3 TNM STRUCT LAST VALUE IS 3999 PAGE TR3271 ERROR definitions ERROR definitions CONSTANT ZTR3 ERR clip prob VALUE 2 CONSTANT ZTR3 ERR target obj not found VALUE 3 CONSTANT ZTR3 ERR attr confl su VALUE 4 CONSTANT ZTR3 ERR not ptp su VALUE 5 CONSTANT ZTR3 ERR alrdy using addr VALUE 6 CONSTANT ZTR3 ERR no obj in sel state VA...

Page 278: ... Trace Opt L0 VALUE 0 CONSTANT ZTR3 VAL Trace Opt L1 VALUE 1 CONSTANT ZTR3 VAL Trace Opt L2 VALUE 2 CONSTANT ZTR3 VAL Trace Opt L3 VALUE 3 CONSTANT ZTR3 VAL Trace Opt L4 VALUE 4 CONSTANT ZTR3 VAL Trace Opt DI VALUE 8 CONSTANT ZTR3 VAL Trace Opt DO VALUE 9 CONSTANT ZTR3 VAL Trace Opt CLBI VALUE 10 CONSTANT ZTR3 VAL Trace Opt CLBO VALUE 11 CONSTANT ZTR3 VAL Trace Opt CLIP VALUE 15 set if 16 29 is se...

Page 279: ...DDL INT2 02 Z Index TYPE ZSPI DDL INT 02 Z Offset TYPE ZSPI DDL INT END Message buffer definition for COBOL both min and max size DEFINITION ZTR3 DDL MSG BUFFER 02 Z MSGCODE TYPE ZSPI DDL INT 02 Z BUFLEN TYPE ZSPI DDL UINT 02 Z OCCURS TYPE ZSPI DDL UINT 02 Z FILLER TYPE ZSPI DDL BYTE OCCURS 0 TO ZCOM VAL BUFLEN TIMES DEPENDING ON Z OCCURS END DEFINITION ZTR3 DDL MSG MAX BUF 02 Z MSGCODE TYPE ZSPI ...

Page 280: ...n 02 Zdrop rts TYPE ZSPI DDL Boolean 02 Zinit status TYPE ZSPI DDL Int2 SPI NULL 255 02 Zmulti block TYPE ZSPI DDL Boolean 02 Zoffline timer TYPE ZSPI DDL TimeStamp 02 Zprog TYPE ZSPI DDL Fname 02 Zread cmd TYPE ZSPI DDL Enum SPI NULL 255 02 Zretry TYPE ZSPI DDL Int SPI NULL 255 02 Zsyncs TYPE ZSPI DDL Int SPI NULL 255 02 Ztest intvl TYPE ZSPI DDL TimeStamp 02 Zthres TYPE ZSPI DDL Int SPI NULL 255...

Page 281: ...Zinit status TYPE ZSPI DDL Int2 02 Zmulti block TYPE ZSPI DDL Boolean 02 Zoffline timer TYPE ZSPI DDL TimeStamp 02 Zprog TYPE ZSPI DDL Fname 02 Zread cmd TYPE ZSPI DDL Enum 02 Zretry TYPE ZSPI DDL Int 02 Zsyncs TYPE ZSPI DDL Int 02 Ztest intvl TYPE ZSPI DDL TimeStamp 02 Zthres TYPE ZSPI DDL Int 02 Ztimeout TYPE ZSPI DDL TimeStamp 02 Zxlate TYPE ZSPI DDL Boolean 02 Zxparent TYPE ZSPI DDL Boolean 02...

Page 282: ...DDL Int 04 ZNo Buf TYPE ZSPI DDL Int For L2 02 ZTR3 Line L2 04 ZTotal Msg TYPE ZSPI DDL Int 04 ZMsg Sent TYPE ZSPI DDL Int 04 ZMsg Recved TYPE ZSPI DDL Int 04 ZShort buf TYPE ZSPI DDL Int 04 ZL2 Err TYPE ZSPI DDL Int 04 ZNak TYPE ZSPI DDL Int 04 ZBCC Err TYPE ZSPI DDL Int 04 ZFrmt Err TYPE ZSPI DDL Int 04 ZRetry TYPE ZSPI DDL Int 04 ZMsg L256 Sent TYPE ZSPI DDL Int 04 ZMsg L256 Recved TYPE ZSPI DD...

Page 283: ...DDL Int 04 ZNo Buf TYPE ZSPI DDL Int For L2 02 ZTR3 Line L2 04 ZTotal Msg TYPE ZSPI DDL Int 04 ZMsg Sent TYPE ZSPI DDL Int 04 ZMsg Recved TYPE ZSPI DDL Int 04 ZShort buf TYPE ZSPI DDL Int 04 ZL2 Err TYPE ZSPI DDL Int 04 ZNak TYPE ZSPI DDL Int 04 ZBCC Err TYPE ZSPI DDL Int 04 ZFrmt Err TYPE ZSPI DDL Int 04 ZRetry TYPE ZSPI DDL Int 04 ZMsg L256 Sent TYPE ZSPI DDL Int 04 ZMsg L256 Recved TYPE ZSPI DD...

Page 284: ... Int 04 Zpin TYPE ZSPI DDL Int 02 ZBpid 04 Zcpu TYPE ZSPI DDL Int 04 Zpin TYPE ZSPI DDL Int 02 ZPath TYPE ZSPI DDL Enum 02 ZCSM Ldev TYPE ZSPI DDL Int 02 ZCU Prim TYPE ZSPI DDL Int 02 ZCU Bkup TYPE ZSPI DDL Int 02 ZDebug TYPE ZSPI DDL Boolean 02 ZTrace TYPE ZSPI DDL Boolean 02 ZTotal SU TYPE ZSPI DDL Int 02 ZTotal Su Opened TYPE ZSPI DDL Int 02 zio addr prim TYPE ZSPI DDL EXIOADDR 02 zio addr bkup...

Page 285: ...DDL Int SPI NULL 255 02 Zxparent TYPE ZSPI DDL Boolean 02 ZType TYPE ZSPI DDL Int Pair SPI NULL 255 END TOKEN MAP ZTR3 MAP ADD SU VALUE IS ZTR3 TNM ADD SU DEF IS ZTR3 DDL ADD SU VERSION C20 FOR ZAddr THRU ZType END PAGE TR3271 ALTER command STRUCT for SUBDEVICE object SECTION ZTR3 DDL ALTER SU SETSECTION ZTR3 DDL ALTER SU TALBOUND 0 ZTR3 DDL ALTER SU This DDL is sent to TR3271 whenever an ALTER SU...

Page 286: ...Addr THRU ZType END PAGE TR3271 STATISTICS command STRUCT for SU object SECTION ZTR3 DDL STATS SU SETSECTION ZTR3 DDL STATS SU TALBOUND 0 ZTR3 DDL STATS SU This DDL is returned to the requester from TR3271 whenever a STATISTICS SU command is processed DEF ZTR3 DDL STATS SU 02 Zreset time TYPE ZSPI DDL TimeStamp 02 Zsample time TYPE ZSPI DDL TimeStamp 02 Zerr TYPE ZSPI DDL Int 02 Zmsg sent TYPE ZSP...

Page 287: ...C20 FOR Zreset time THRU Zmsg recved END PAGE TR3271 STATUS command STRUCT for SU object SECTION ZTR3 DDL STATUS SU SETSECTION ZTR3 DDL STATUS SU TALBOUND 0 ZTR3 DDL STATUS SU This DDL is returned to requester from TR3271 whenever a STATUS SU command is processed DEF ZTR3 DDL STATUS SU 02 ZSDN TYPE ZSPI DDL Int 02 ZState TYPE ZSPI DDL Enum 02 ZStatus TYPE ZSPI DDL Int 02 ZFlags TYPE ZSPI DDL Int 0...

Page 288: ... evt cssunexbkpt CONSTANT ztr3 evt css liu config err VALUE IS zems evt cssconfigerr CONSTANT ztr3 evt css line err VALUE IS zems evt csslineerr CONSTANT ztr3 evt css subdev err VALUE IS zems evt csssubdeverr TR3 EMS misc constants CONSTANT ztr3 val evt buflen VALUE IS 512 bytes PAGE TR3271 EMS definitions TR3271 EMS token definitions CONSTANT ztr3 tnm p reg VALUE IS 1 CONSTANT ztr3 tnm e reg VALU...

Page 289: ...ile err VALUE IS ztr3 tnm file err TOKEN TYPE IS zspi typ uint TOKEN CODE ztr3 tkn clip func VALUE IS ztr3 tnm clip func TOKEN TYPE IS zspi typ uint TOKEN CODE ztr3 tkn clip status VALUE IS ztr3 tnm clip status TOKEN TYPE IS zspi typ uint TOKEN CODE ztr3 tkn addr ctl VALUE IS ztr3 tnm addr ctl TOKEN TYPE IS zspi typ uint TOKEN CODE ztr3 tkn type seq VALUE IS ztr3 tnm type seq TOKEN TYPE IS zspi ty...

Page 290: ...ommands 4 1 recommended for responses 4 3 Building the command buffer 4 1 CLIP downloading 6 71 placing in boot state 6 75 CMI corresponding commands of 2 8 Command buffer building 4 1 Command numbers 3 4 Command number token 5 4 Commands 6 1 ABORT 6 8 ADD 6 13 ALTER 6 20 building the buffer for 4 1 by object type 6 4 compared to CMI commands 2 8 compared to SCF commands 2 6 components 3 12 CONNEC...

Page 291: ... 93 STATUS 6 102 STOP 6 113 subordinate modifier token in 4 1 SWITCH 6 119 symbolic names 6 2 TRACE 6 125 Commands and responses 6 1 Comment token 5 5 Common definitions 5 1 Common syntax elements 3 4 Console messages 7 7 Constructs involving multiple tokens 3 12 Context token 5 5 Continuation of commands 4 1 of responses 4 3 Critical events 7 4 CU token use of 7 6 Data lists 3 12 5 5 representati...

Page 292: ...splayed on operator console 7 4 event numbers of 3 7 filters 7 4 notation 7 6 obtaining 7 1 order of tokens 7 6 relationship to console messages 7 7 reported to EMS 7 4 reported to TMDS 7 4 standard header in text version 7 7 subjects 3 7 Tandem internal tokens 7 6 text version 7 7 TR3271 subsystem 7 1 TR3271 subsystem ID 7 1 unconditional tokens 7 6 volatile tokens 7 6 Event numbers 3 7 Event man...

Page 293: ...cting 6 5 object names 5 14 INFO command 6 52 Initializing structured tokens 4 2 Letter Z using in applications 3 4 LINE object See Lines Lines aborting 6 8 altering 6 20 commands affecting 6 5 current status 6 102 format of object names 3 6 loading 6 71 monitoring statistics 6 93 object names of 5 14 object type of 5 14 obtaining statistics 6 79 resetting 6 75 resetting statistics counters 6 79 s...

Page 294: ...name 3 5 getting release version 6 48 NULL object commands affecting 6 5 object type of 5 14 Object names format 3 6 I O processes 5 14 number accepted in commands 3 6 of lines 5 14 of subdevices 5 14 when required in a command 5 14 Object types 3 5 commands listed by 6 4 I O processes 5 14 of lines 5 14 of NULL object 5 14 of subdevices 5 14 Object name token 5 14 Object type header token 5 6 Obj...

Page 295: ...3 number of in one reply message 4 3 number of objects described in 4 3 selecting 4 3 tokens in 6 7 Response type token 5 7 Responses 6 1 components 3 12 continuation of 4 3 decoding the buffer 4 3 extensible structured tokens in 3 9 multiple response records in 4 3 notation used to describe 6 6 order of tokens in 6 7 receiving the buffer 4 3 recommended buffer sizes 4 3 selecting response records...

Page 296: ...6 SUBDEVICE object See Subdevices Subdevices aborting 6 8 adding 6 13 altering 6 20 commands affecting 6 5 connecting 6 33 current status 6 102 deleting 6 38 disconnecting 6 43 format of object names 3 6 monitoring statistics 6 93 object names of 5 14 object type of 5 14 obtaining statistics 6 79 resetting statistics counters 6 79 starting 6 88 stopping 6 113 terminating operation 6 8 Subject toke...

Page 297: ...oken values 5 19 tokens in error lists 5 21 tokens in event messages 5 21 TR3271 subsystem command numbers supported 3 5 commands accepted by 6 1 common syntax elements 3 4 data communications definitions 5 12 definitions 5 18 elements of SPI messages 3 1 EMS definitions 5 9 event messages 7 1 object names 3 6 object types supported 3 5 responses issued by 6 1 SPI definitions 5 2 SPI programming c...

Page 298: ... ZCOM EVT CPU SWITCH 7 67 PATH SWITCH 7 70 SUMSTATE CHG 7 74 ZCOM MAP REQID 5 13 TRACE MODIF 5 13 ZCOM OBJ LINE 5 14 NULL 5 14 PROC 5 14 SU 5 14 ZCOM TKN OBJNAME 5 14 OBJTYPE 5 14 SEL SUMSTATE 5 15 SUB 5 15 SWITCH CPU 5 15 SWITCH PATH 5 15 TARGET MGR 5 15 TARGET OBJNAME 5 15 TARGET OBJTYPE 5 16 TRACE OPT 5 16 ZCOM VAL PATH A 5 16 PATH B 5 16 PATH UNDEF 5 16 SUB ALL 5 16 SUB NONE 5 16 SUB ONLY 5 16...

Page 299: ... SSN ZTR3 5 3 ZSPI TKN ALLOW TYPE 4 2 5 4 CHECKSUM 5 4 COMMAND 5 4 COMMENT 5 5 CONTEXT 5 5 DATALIST 5 5 6 7 ENDLIST 5 5 6 7 ERRLIST 5 5 6 7 HDRTYPE 5 6 MANAGER 5 6 MAX FIELD VERSION 5 6 MAXRESP 4 3 5 6 OBJECT TYPE 5 6 RESPONSE TYPE 4 3 5 7 RETCODE 5 7 SERVER BANNER 5 7 SERVER VERSION 5 7 SSID 5 8 USEDLEN 5 8 ZSPI VAL CMDHR 5 6 ERR WARN AND NORM 5 4 EVTHDR 5 6 NORM ONLY 5 4 TANDEM 5 8 WARN AND NORM...

Page 300: ... 7 47 CSS LINE ERR 7 57 CSS LIU CONFIG ERR 7 54 CSS PROBE ERR 7 42 CSS SUBDEV ERR 7 62 CSS UNEXP BRKPT 7 51 DISCARD ERR 7 36 INSUFF BUF 7 33 INTL ERR 7 26 IOBUS ERR 7 8 OBJ STARTED 7 17 OBJ STOPPED 7 20 PROC ABEND 7 29 SUBDEV ERR 7 23 ZTR3 TKN ABENDNUM 7 30 ADDR CTL 7 49 CIU STATUS 7 13 CLIP FUNC 7 52 7 56 7 59 7 64 CLIP STATUS 7 59 7 64 CLIP SU 7 59 7 64 CONFIG ERR 7 55 E REG 7 26 FILE ERR 7 9 7 ...

Page 301: ...INDEX ZTR3 VAL EVT BUFLEN 5 19 PROTO CRT 6 15 PROTO PTP 6 15 SSID description 5 19 structure definition 5 8 VERSION 5 19 DEBUG 6 13 ZSPI 6 13 Index 12 ...

Reviews: