SNAX/APC Management Programming Manual
ZAPC-TKN-SNAX-FILE-NAME
Common Definitions
4–42 111813 Tandem Computers Incorporated
ZAPC-TKN-SNAX-FILE-NAME
specifies the file name of the Tandem access method that the local LU uses to
exchange data with an SNA network. Although SNAX/APC does not check for
duplicate files, every local LU should have a distinct SNAX-FILE-NAME, since
SNAX/APC issues the OPEN request to the underlying access method
exclusively. If multiple LUs have the same SNAX-FILE-NAME, all LUs except the
one that was started first will encounter file system error number 61 ( no more
file opens permitted on this volume or device) when the LU is
started.
The SNAX-FILE-NAME token has the token type ZSPI-TYP-STRING. 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.
If you are using the SNAX/CDF access method, enter the OPENNAME of the
SNAX/CDF APPL object associated with this SNAX/APC LU. The name you
specify must include the SNAX/CDF process name and must match the
OPENNAME of a previously defined SNAX/CDF APPL object. The format of the
name must be:
$
snax/cdf-name
.#
openname
If you are using the SNAX/XF access method, enter the name of the associated
SNAX/XF LU. The name you specify must include the SNAX/XF device name.
The form of the name must be:
$
snax/xf-name
.#
lu-name
When used with ZCOM-CMD-ADD, this is a required token. This token is always
returned in the ZCOM-CMD-INFO response buffer.
ZAPC-TKN-SNAX-MAX-RETRY-COUNT
specifies the maximum number of times that SNAX/APC will attempt the open
request. The valid values are from 0 through 32767. The default value is zero
(0),which specifies that no retry will be attempted.
If the specified number of attempts is reached without a successful open of the
underlying SNAX access method, the SNAX/APC LU and its subordinate objects
stay in the STARTING state. SNAX/APC does not attempt to open the SNAX
access method again until a START LU command or a TP-READY verb for that LU
is received.
The SNAX-MAX-RETRY-COUNT token has the token type ZSPI-TYP-INT. The
programmatic commands that use this token are ZCOM-CMD-ADD, ZCOM-
CMD-ALTER, and ZCOM-CMD-INFO. The valid object type for this token is LU.