TS/MP 2.5 Management Programming Manual

described in “SPI Error Messages” (page 305). Messages returned to servers from TCPs are described
in the Pathway/iTS Management Programming Manual.
Other Tokens
Commands, responses, and event messages for the Pathway subsystem, like those for other
subsystems, also include other tokens providing further information.
Comment Token
ZSPI-TKN-COMMENT is a token that a requester can use to include arbitrary information of its
own in a command. Pathway, like other NonStop subsystems, does not use this token and does
not return it in responses.
Buffer sizes recommended by NonStop subsystems allow for one 80-byte comment token in every
command. ZSPI-TKN-COMMENT is currently useful only within NonStop software.
Context Token
The ZSPI-TKN-CONTEXT data token facilitates referencing more than one object with a single
command. This token is returned in the response if you specify a constant (that is,
ZPWY-VAL-ALLobjectname) in the object-selector token and more objects must be processed. To
continue the command for additional objects, your management application must copy
ZSPI-TKN-CONTEXT into a duplicate of the original command message and resubmit the command
message.
For more information on continuation, see “Specifying Continuation” (page 40).
Extensible Structured Tokens
This is a sample DDL definition for an extensible structured token that defines the attributes for a
program. The TAL, COBOL, TACL, and C code generated follows the DDL definition.
NOTE: The TAL, COBOL, TACL, and C codes redefine each character field (Z^C and Z-C in the
examples) as an integer array and as an array of individual bytes to accommodate certain NonStop
operating system procedures. For clarity, the redefinitions are removed from the example.
DDL definition for ZPWY-DDL-DEF-SCASSIGN.
nl
def ZPWY-DDL-DEF-SCASSIGN.
nl
nl
token-type ZSPI-DDL-
02 ZGUARDIANFILE
nl
nl
nl
nl
nl
nl
nl
nl
nl
nl
nl
nl
nl
FNAME32.
token-type ZSPI-DDL-INT2.
02 ZEXTENTSIZE.
token-type ZSPI-DDL-INT2.
03 ZPRIMARY
nl
nl
token-type ZSPI-DDL-INT2.
03 ZSECONDARY
token-type ZSPI-DDL-INT.
02 ZFILECODE
token-type ZSPI-DDL-INT.
02 ZEXCLUSION
token-type ZSPI-DDL-INT.
02 ZACCESS
token-type ZSPI-DDL-INT.
02 ZRECORDSIZE
02 ZBLOCKSIZE
end.
Corresponding TAL structure for ZPWY-DDL-DEF-SCASSIGN:
STRUCT ZPWY^DDL^DEF^SCASSIGN^DEF (*);
BEGIN
STRUCT ZGUARDIANFILE;
Message Elements for the Pathway Subsystem 35