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.
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.
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
- INVALID_DLC
The name supplied for the dlc_name parameter was not the name of a defined DLC.
If the command does not execute because of a state error,
SNAplus2 returns the following parameters:
- primary_rc
STATE_CHECK
- secondary_rc
- DLC_DEACTIVATING
The specified DLC has already been started, and
is being deactivated.