Expand Management Programming Manual

COMMANDS AND RESPONSES
TRACE Command (NCP Process, Lines, and Paths)
Tokens in Response Buffer
ZSPI-TKN-DATALIST is a standard SPI data list, as described in
the Distributed Systems Management (DSM) Programming Manual . The
list ends with the token ZSPI-TKN-ENDLIST.
ZCOM-TKN-OBJNAME is an object-name token that contains the name
of the NCP ("$NCP") or of a line or path that was affected by the
command. This token is always present in the response. ZCOM-
TKN-OBJNAME is described in Section 6, "Common Definitions."
ZCOM-TKN-OBJTYPE is an object-type token that contains the value
ZCOM-OBJ-PROCESS. This token is always present in the response,
and it is described in Section 6, "Common Definitions."
ZSPI-TKN-RETCODE is the standard SPI return token described in
the Distributed Systems Management (DSM) Programming Manual .
Some values of RETCODE that are likely to occur in response to
this form of the TRACE command are the following:
1 (ZEXP-ERR-TOO-MANY-OBJNAMES): More than 30 object names
were in the command.
3 (ZEXP-ERR-EMPT-RSP): The empty response record is being
returned.
5 (ZEXP-ERR-OBJ-TYPE-NAME-MISMATC): A conflict exists be-
tween the object type and an object name.
For descriptions of all EXPAND error numbers and their associated
error lists, refer to Appendix A.
ZSPI-TKN-ERRLIST is a standard SPI error list, as described in
the Distributed Systems Management (DSM) Programming Manual . The
list ends with the token ZSPI-TKN-ENDLIST.
ZSPI-TKN-CONTEXT is the standard SPI context token described in
the Distributed Systems Management (DSM) Programming Manual .
Operational Notes
• TRACE is a sensitive command.
• Only one object can be traced at a time; therefore, you cannot
use this command while another TRACE command is in progress.
• No summary-state transition is associated with this command.
7-124