SNAX/APC Configuration and Management Manual

SCF Commands for SNAX/APC
SNAX/APC Configuration and Management Manual—138787
8-76
START LU Command
STARTING state and then placed in the STARTED state after its parent object is
started.
START LU Command
The START LU command places the specified LU in the STARTED state and issues an
OPEN request to the underlying access method.
Considerations
•
Upon completion of the START LU command, SNAX/APC opens the underlying
access method (as specified in the SNAXFILENAME attribute).
•
When a START command acts on a local LU with dynamic SNAXFILENAME
support (the SNAXFILENAME contains a null string), the LU is placed in the
STARTING state without opening its underlying access method. In fact, the local
LU’s underlying access method is not known until it receives the STARTLU
notification. This notification is sent from the SNAX Creator-2 process, upon receipt
of a BIND request from a partner LU. The local LU will then be placed in the
STARTED state. The SNAXFILENAME attribute will now contain an open name
given by the SNAX Creator-2 process. When all of its subordinate sessions are
terminated, the underlying access method will be closed, and the LU will be placed
back to the STARTING state. The SNAXFILENAME attribute is reset back to a
null string.
•
If more than one local LU shares the same SNAXFILENAME for the underlying
access method open name, only one can be started. Remaining LUs with the same
SNAXFILENAME generate the file system error number 61 (no more file opens
permitted on the device) upon completion of the START LU command.
•
When a START LU command is executed, the retry counter is reset. This counter
keeps track of the retries of the local LU. Once the counter is reset and if an error
occurs, the local LU will perform as many retries as specified by
SNAXMAXRETRYCOUNT attribute.
Example
-> ASSUME PROCESS $APC1
-> START LU LU01
START PTNR-LU Command
The START PTNR-LU command places the specified PTNR-LU object in the
STARTED state and, if applicable, starts its subordinate PTNR-MODE object named
SNASVCMG.
Example
-> ASSUME PROCESS $APC1
-> START PTNR-LU LU01.CICSLU62