SNAX/APC Management Programming Manual

ZAPC-TKN-D-SESS-LIM
Common Definitions
4–26 111813 Tandem Computers Incorporated
ZAPC-TKN-D-SESS-LIM
specifies the maximum number of sessions that can be established under a PTNR-
MODE object. The value can range from 1 to 1024, and is used as the
LU_MODE_SESSION_LIMIT parameter of the INITIALIZE_SESSION_LIMIT
CNOS verb.
The sum of the D-SESS-LIMIT tokens of all started PTNR-MODE objects must be
at least two less than the SESS-LIM value of the parent LU for those PTNR-MODE
objects. This is because two sessions are required to carry CNOS requests and
replies.
The D-SESS-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 D-SESS-LIM 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 error.
Also, if the ZAPC-TKN-MODE-NAME token for the target PTNR-MODE object
has the value SNASVCMG, using the ZCOM-CMD-ALTER command with the
D-SESS-LIM token will cause the error ZAPC-ERR-CMD-INV-DEFT-OBJ.
When used with the ZCOM-CMD-INFO command, the D-SESS-LIM token is
always in the response buffer.
ZAPC-TKN-DISPATCHED-IND
specifies if the TP-READY request is initiated by a DISPATCH-TP request. A
value of ZSPI-VAL-FALSE indicates that the TP was not dispatched.
The DISPATCHED-IND 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 TPI.
This token is always returned in the ZCOM-CMD-INFO response buffer.
ZAPC-TKN-DRAIN-SOURCE
specifies whether the source LU in a CNOS conversation, initiated by a
RESET_SESSION_LIMIT CNOS verb, can drain its allocation requests. A value of
ZSPI-VAL-FALSE indicates that the LU cannot drain its allocation requests.
The DRAIN-SOURCE token has the token type ZSPI-TYP-BOOLEAN. The
programmatic commands that use this token include ZCOM-CMD-INFO and
ZCOM-CMD-STOP. The valid object type for this token is PTNR-MODE.
This token is always returned in the ZCOM-CMD-INFO response buffer. When
specified with the STOP command, the default value is ZSPI-VAL-FALSE.