Administration Commands
start_ls
primary_rc
UNSUCCESSFUL
secondary_rc
Possible values are:
DLUS_REJECTED
The DLUS rejected the session activation request.
DLUS_CAPS_MISMATCH
The configured DLUS name was not a DLUS node.
PU_FAILED_ACTPU
The local node rejected a message from the DLUS. This can be caused by an internal error, a resource shortage, or a problem with the received message; check the SNAplus2 log files for messages providing more information.
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.
2.196 start_ls
The start_ls command is usually used to start an inactive link station (LS). Alternatively, the command can be used to leave the LS inactive but specify that it can be automatically activated by SNAplus2 when required or activated by the remote system.
If this command is used to activate the LS, the associated port, DLC, and node are activated automatically if they are not already active.
Note
If the LS is a leased SDLC link or a QLLC PVC link, it must be activated by the remote system as well as by SNAplus2. You are recommended to define the LS to be activated when the node is started and to be reactivated automatically after failures, to ensure that the link is always available; see Section 2.51, define_sdlc_ls or Section 2.45, define_qllc_ls for more information.
2.196.1 Supplied Parameters
Parameter name | Type | Length | Default |
[start_ls] |
|
|
|
ls_name | character | 8 |
|
enable | constant |
| ACTIVATE |
Supplied parameters are:
ls_name
Name of the link station to be started. This LS must already have been previously defined.
enable
Specifies the action to be taken for the LS.
To start the LS, set this parameter to ACTIVATE.
602
