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

Commands
Safeguard Management Programming Manual—422086-028
7-51
ADD TERMINAL (LU) Command
ZSFG-TKN-CI-LIB-XFNAME
is an optional token that specifies the library (if any) associated with the
aforementioned CI.
ZSFG-TKN-CI-PCPU
is an optional token that specifies the primary CPU where the CI is to be started.
ZSFG-TKN-CI-NAME
is an optional token that specifies the CI's process name.
ZSFG-TKN-CI-SWAP
is an optional token that specifies the CI's SWAP volume.
ZSFG-TKN-CI-PRI
is an optional token that specifies the CI's priority.
ZSFG-TKN-CI-PARAM-TEXT
is an optional token that specifies the CI's startup parameter text.
ZSFG-TKN-FROZEN
is an optional token that specifies whether the terminal is to be in the suspended,
or frozen, state. The default is FALSE. Specifying this token is equivalent to
executing a SUSPEND TERMINAL command.
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ADD TERMINAL
command, see Section 6, Common Definitions.
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.
These errors or warnings can occur in response to the ADD TERMINAL command:
ZCOM-ERR-SECUR-VIOL
is returned if the requestor's process access ID does not have authority to
perform the ADD TERMINAL command. The rules for who can manage
terminal security are defined in the Safeguard Reference Manual.