Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Commands
Safeguard Management Programming Manual—422086-028
7-200
LISTOPENS Command
ZCMK-TKN-LISTOP-XPNAM
records the process name of the opener in external format.
ZCMK-TKN-LISTOP-QUALIFS
records the qualifiers used when the process was opened. For ZPROTO = ZSFG-
VAL-PROTO-SMP-BUF, the token value is a null string. For ZPROTO = ZSFG-
VAL-PROTO-SPI the token value is #ZSPI.
ZCMK-MAP-LISTOP
ZCMK-TKN-LISTOP-XPNAME
ZCMK-TKN-LISTOP-QUALIF
together describe an opener of $ZSMP. These tokens occur together; that is, the
nth occurrence of each of the three tokens refers to the same opener.
ZSPI-TKN-CONTEXT
is a special token that indicates by its presence or absence whether or not there
are more reply messages to come. This token is only returned when the request
generated more responses than fit in one buffer. For a description of this token,
see the SPI Programming Manual.
Error-Handling Notes
ZSPI-TKN-RETCODE
is the standard SPI return code token, whose value is a number identifying
successful completion (ZCOM-ERR-OK), an informational warning, or an error.
Errors or warnings that can occur in response to the LISTOPENS command follow:
ZCOM-ERR-SPI-ERR
is returned if one of the procedures (for example, SSGETTKN) returned an
error. The SPI error list defines the procedure in error, the error status, and the
token involved.
ZCOM-ERR-TKN-CODE-INV
is returned if an invalid, foreign, or unsupported token was found. The error list
identifies the invalid token.