Administration Commands
start_dlc
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.
2.194 start_dlc
The start_dlc command activates a DLC.
When this command is issued, the associated node is activated automatically if it is not already active.
If this command does not return an error message, this indicates only that the command was issued successfully. The command does not wait for the DLC to initialize and therefore does not return error return codes if the initialization of the DLC fails. DLC initialization failures are reported by messages written to the error log file.
2.194.1 Supplied Parameters
Parameter name | Type | Length |
[start_dlc] |
|
|
dlc_name | character | 8 |
Supplied parameters are:
dlc_name
Name of the DLC to be started. This must match the name of a defined DLC.
2.194.2 Returned Parameters
No parameters are returned by SNAplus2 when this command executes successfully.
2.194.3 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.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
INVALID_DLC
The name supplied for the dlc_name parameter was not the name of a defined DLC.
State Check
If the command does not execute because of a state error, SNAplus2 returns the following parameters:
599
