PAM Management Programming Manual

Commands and Responses
PAM Management Programming Manual—142481
5-31
LISTOPENS Command
Operational Notes
There are several things you should remember when using the LISTOPENS command:
•
You can use the ZCOM-TKN-SUB token to obtain a list of the openers of the
specified object and/or its subordinates, if any. The values for this token are as
follows:
ZCOM-VAL-SUB-ALL
lists the openers of the specified object and its subordinate objects, if any.
ZCOM-VAL-SUB-NONE
lists the openers of the specified object but does not list the openers of
subordinate objects.
ZCOM-VAL-SUB-ONLY
lists the openers of the subordinate objects but does not list the openers of the
specified object.
•
You can use the ZCOM-TKN-SEL-SUMSTATE token to list only the openers of
those objects that are currently in the STARTED summary state.
•
You can use both the ZCOM-TKN-SUB and the ZCOM-TKN-SEL-SUMSTATE
tokens, in combination, to list the openers of only those objects and/or subordinate
objects that are currently in the STARTED summary state.
•
There is no summary state transition associated with the LISTOPENS command.
Error-Handling Notes
ZSPI-TKN-RETCODE is the standard SPI return-code token, whose value is a number
identifying successful completion (ZCOM-ERR-OK) or an error. There are no unique
errors that can occur in response to the LISTOPENS command.