SNAX/APC Management Programming Manual

ZAPC-TKN-AUTO-ACTIVATE-LIM
Common Definitions
4–20 111813 Tandem Computers Incorporated
ZAPC-TKN-AUTO-ACTIVATE-LIM
specifies the number of contention-winner sessions that are activated
automatically after the PTNR-MODE object is in the STARTED state. If the value
of the AUTO-ACTIVATE-LIM token is greater than the value of the MIN-
CONWINNERS-LIM token after the CNOS command has been negotiated, only
the number of sessions specified by the MIN-CONWINNERS-LIM token is
pre-established. Valid values for this token range from 0 to 1024.
The AUTO-ACTIVATE-LIM token has the token type ZSPI-TYP-INT. The
programmatic commands that use this token include ZCOM-CMD-ADD, ZCOM-
CMD-ALTER, and ZCOM-CMD-INFO. The valid object type for this token is
PTNR-MODE.
When used with the ZCOM-CMD-ALTER command, the AUTO-ACTIVATE-LIM
token can only be specified when the PTNR-MODE object is in the STOPPED state.
If the PTNR-MODE object is not in the STOPPED state, the token will not be
processed and the command will be rejected with the ZAPC-ERR-TKN-INV-IN-
SUMSTATE error.
The AUTO-ACTIVATE-LIM token is always returned in the ZCOM-CMD-INFO
response buffer when applied to a PTNR-MODE object.
ZAPC-TKN-AUTO-START
specifies whether the local LU is started automatically during the SNAX/APC
process initialization. When SNAX/APC is started and a non-empty
configuration file is specified, all LUs referenced in the file and listed as AUTO-
START will be automatically started. For an LU to be automatically started, this
token should be present in the buffer with the value ZSPI-VAL-TRUE. A value of
ZSPI-VAL-FALSE indicates that it is not started automatically.
Note, however, that an LU won’t be automatically started when it is first added,
even if the value of the ZAPC-TKN-AUTO-START is ZSPI-VAL TRUE. The
configuration file is updated when an LU is added, but the value of the AUTO-
START token is not referenced until subsequent restarts. Therefore, when an LU is
first added, it must be explicitly started.
The AUTO-START token has the token type ZSPI-TYP-BOOLEAN. The
programmatic commands that use this token include ZCOM-CMD-ADD, ZCOM-
CMD-ALTER, and ZCOM-CMD-INFO. The valid object type for this token is LU.
The ZCOM-CMD-ALTER command can only be used when the LU is in the
STOPPED state. This token is always returned in the ZCOM-CMD-INFO response
buffer when applied to the LU object.