SPI Common Extensions Manual

Extended SPI Concepts
SPI Common Extensions Manual—427508-001
2-12
Subsystem Manager Process Identification
manager^id allocates storage for a structure based on the template structure.
Assume the manager process name is $MGR and the system name is \LOCAL. Assign
these values to the structure elements:
manager^id ':=' ["\LOCAL ",
"$MGR "];
status := SSPUTTKN(message^buffer
,ZSPI^TKN^MANAGER
,manager^id);
The manager token ZCOM-TKN-XMGR allows string representation of the manager
name for use in D-series applications. See Message Routing on page 3-2.
Specifying the Manager Using the Object-Name Token
Some subsystems include the manager process identifier as part of the first
occurrence of ZCOM-TKN-OBJNAME in the command message.
Assume that the destination manager process is located on system \LOCAL, its
process name is $MGR, and the object name is $LINE.#SUB. The object name might
be:
\LOCAL.$MGR.$LINE.#SUB or $MGR.$LINE.#SUB
This example illustrates how to create and use a qualified object-name token:
STRUCT .objname;
BEGIN
INT length;
STRING name[0:ZCOM^VAL^OBJNAME^LEN - 1];
END;
objname.name ':=' "$MGR.$LINE.#SUB";
objname.length := 15; !The actual number of characters.
status := SSPUTTKN(message^buffer,ZCOM^TKN^OBJNAME,objname);