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.
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.
To leave the LS inactive but specify that it can be activated
(either by SNAplus2 or by the remote system) when required, specify
one or both of the following values (combined using a logical OR):
- AUTO_ACT
The LS can be automatically activated by SNAplus2 when
required for a session. This value should be used only when the
LS is defined to automatically activated (auto_act_supp in the LS definition is set to YES).
This action re-enables auto-activation after the LS has been manually
stopped using stop_ls.
- REMOTE_ACT
The LS can be activated by the remote system. This value
does not alter the defined value of the disable_remote_act parameter in the LS definition; when the LS is next
stopped, it will return to the defined setting.
Returned Parameters |
|
No parameters are returned by SNAplus2 when this command executes successfully.
Error Return Codes |
|
If the command cannot be executed, SNAplus2 returns a primary
return code to indicate the type of error and a secondary return
code to provide specific details about the reason for unsuccessful
execution.
If the command does not execute because of a parameter error,
SNAplus2 returns the following parameters:
- primary_rc
PARAMETER_CHECK
- secondary_rc
Possible values are:
- INVALID_LINK_NAME_SPECIFIED
The ls_name parameter was not the name of a defined LS.
- INVALID_LINK_ENABLE
The enable parameter was not set to a valid value.
If the command does not execute because of a state error,
SNAplus2 returns the following parameters:
- primary_rc
STATE_CHECK
- secondary_rc
Possible values are:
- ACTIVATION_LIMITS_REACHED
The LS cannot be started because the outbound link activation
limit has been reached.
- PARALLEL_TGS_NOT_SUPPORTED
A link to the remote system is already active. The adjacent
node does not support parallel transmission groups.
- LINK_DEACT_IN_PROGRESS
The specified LS is currently being deactivated.
You cannot start it until deactivation is complete.
- ALREADY_STARTING
The specified LS is already starting.
If the command does not execute because other conditions exist, SNAplus2
returns the following parameters:
- primary_rc
CANCELLED
- secondary_rc
Possible values are:
- NO_SECONDARY_RC
A stop_ls command was issued before the start_ls command had completed. The start_ls command was canceled.
- LINK_DEACTIVATED
The DLC or port used by the LS was stopped before
the start_ls command had completed. The start_ls command was canceled.
Printable version
