SPI Common Extensions Manual

ZCMK Definitions
SPI Common Extensions Manual—427508-001
B-39
ZCMK Command Processing
ZCMK Command Processing
Commands sent to and responses generated by ZCMK-based subsystems can contain
ZCMK tokens. For individual descriptions of these tokens, see ZCMK Data Definitions
on page B-9, and the context of specific commands in these command and response
descriptions.
A command sent to a subsystem process that is based on the ZCMK definitions might
accept additional tokens if the object specified in the command is the ZCMK-based
process itself. Such a process is called a native object, and the object type
(ZCOM-OBJ-objtype) assigned to it is called the native object type. The value for the
native object type is frequently ZCOM-OBJ-PROC or ZCOM-OBJ-SUBSYS. The native
object type must be the highest type in any object-type hierarchy defined by the
subsystem.
An application can issue commands to and receive responses from the native object of
a ZCMK-based subsystem by assigning the manager process name to ZCOM-TKN-
OBJNAME and the native object type to ZSPI-TKN-OBJTYPE in the command
message. The command modifier ZCOM-TKN-SUB can be used with any command
that acts on a native object type, with the exception of the ADD command.
File Names in Commands and Responses
File names included in commands sent to ZCMK-based subsystems should be fully
qualified. The subsystem fills any missing part of the name using the local node and
$SYSTEM.SYSTEM as the default.
File names returned in a response buffer by a ZCMK-based subsystem are fully
qualified and in string format (token-type ZSPI-TYP-STRING). If the node has a name,
the node name is included.
ALTER
A ZCMK-based subsystem accepts these tokens in an ALTER command that is
directed to the subsystem’s native object type:
ZCMK-MAP-ALTER
ZCMK-TKN-ALTER-BKUP-CPU token-type ZSPI-TYP-INT
ZCMK-TKN-CHMAP-NAME token-type ZSPI-TYP-CHAR50
ZCMK-TKN-CHMAP-XFNAME token-type ZSPI-TYP-STRING
ZCMK-TKN-EMS-XFNAME token-type ZSPI-TYP-STRING
ZCMK-TKN-EMS-XFNAME-1 token-type ZSPI-TYP-STRING
ZCMK-TKN-EMS-XFNAME-2 token-type ZSPI-TYP-STRING
ZCMK-TKN-EMS-XFNAME-3 token-type ZSPI-TYP-STRING
ZCMK-TKN-LOG-XFNAME token-type ZSPI-TYP-STRING
ZCMK-TKN-MSG-XFNAME token-type ZSPI-TYP-STRING
subsys-type-name token-type subsys-defined