SNAX/APC Management Programming Manual

ZAPC-TKN-MIN-CONWINNERS-LIM
Common Definitions
4–32 111813 Tandem Computers Incorporated
ZAPC-TKN-MIN-CONWINNERS-LIM
specifies the minimum number of contention-winner sessions that the partner
mode has. The value is used as the MIN_CONWINNER_SOURCE parameter of
the CHANGE_SESSION_LIMIT (CNOS) verb. Valid values range from 0 to 1024.
The MIN-COWINNERS-LIM token has the token type ZSPI-TYP-INT. The
programmatic commands that use this token include 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 MIN-CONWINNERS-
LIM token can only be specified when the target PTNR-MODE object is in the
STARTED state. Attempts to do otherwise will cause the command to be rejected
with the error token ZAPC-ERR-TKN-IN-SUMSTATE.
This token is always returned in the ZCOM-CMD-INFO response buffer.
ZAPC-TKN-MODE-NAME
specifies the mode name used for building SNA requests (such as the BIND
request). It is also the mode name used as the parameter of the ALLOCATE and
MC_ALLOCATE verbs (AL-MODENAME and MC-AL-MODENAME).
The specified mode name has to be unique among all of the PTNR-MODE objects
subordinate to the same PTNR-LU object. The mode name SNASVCMG is
reserved for the default PTNR-MODE object, and therefore cannot be specified.
The MODE-NAME token has the token type ZSPI-TYP-STRING, with a maximum
length of eight characters. 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 MODE-NAME token can
only be specified when the PTNR-MODE object is in the STOPPED state. If the
PTNR-MODE 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 token.
This token is always returned in the ZCOM-CMD-INFO response buffer.
ZAPC-TKN-ONE-STEP-READ
indicates whether one step reads are allowed. The value ZSPI-VAL-TRUE
indicates that one step reads are allowed. The value ZSPI-VAL-FALSE indicates
that one step reads are not allowed (two-step reads will be used).
The ONE-STEP-READ token has the token type ZSPI-TYP-BOOLEAN. The
programmatic command that uses this token is ZCOM-CMD-INFO. The valid
object type for this token is PROC.