SNAX/APC Management Programming Manual

ZAPC-TKN-SESS-LIM
Common Definitions
4–40 111813 Tandem Computers Incorporated
ZAPC-TKN-SESS-LIM
specifies the maximum number of sessions that the local LU can have. Valid
values range from 1 to 1024. If the value of ZAPC-TKN-SESS-LIM is 1, the local
LU is treated as a single-session LU (that is, not supporting parallel sessions). If
the value of ZAPC-TKN-SESS-LIM is greater than 1, the local LU is treated as a
parallel-session LU.
The maximum number of active sessions supported by a SNAX/APC process is
1024. You can configure all 32 LUs to have ZAPC-TKN-SESS-LIM set to 1024, but
as soon as 1024 sessions are active, no more active sessions are allowed.
The 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 types for this token are LU and PTNR-
MODE. The ZCOM-CMD-ADD, ZCOM-CMD-ALTER, and ZCOM-CMD-INFO
commands are valid with the LU object, and the ZCOM-CMD-ALTER and ZCOM-
CMD-INFO commands are valid with the PTNR-MODE object.
When the SESS_LIM token is used with ZCOM-CMD-ADD to add an LU, the
default value of SESS-LIM is 1.
When the SESS-LIM token is used with with ZCOM-CMD-ALTER to alter the
session limit of the PTNR-MODE object, the PTNR-MODE object must be in the
STARTED state. If the PTNR-MODE object is not in the STARTED state when the
command is issued, the command will be rejected with the error token ZAPC-
ERR-TKN-INV-IN-SUMSTATE. Also, when this token is specified for the ZCOM-
CMD-ALTER command, the value is used as the LU_MODE_SESSION_LIMIT
parameter of the CNOS verb CHANGE_SESSION_LIMIT.
This token is always returned in the ZCOM-CMD-INFO response buffer.
ZAPC-TKN-SESS-TYPE
specifies the role of the local LU in a particular session.
The SESS-TYPE token has the token type ZSPI-TYP-ENUM. The programmatic
command that uses this token is ZCOM-CMD-INFO. The valid object type for this
token is SESS.
The following enumerated values are valid for this token:
ZAPC-VAL-SESS-TYPE-PRIMARY
specifies that the LU has the primary role in this session.
ZAPC-VAL-SESS-TYPE-SECONDARY
specifies that the LU has the secondary role in this session.
The SESS-TYPE token is always returned in the ZCOM-CMD-INFO response
buffer.