This command outputs all routes and command devices in the route list definition files specified by the input parameters. However, if YES is specified for the STATUS parameter, the command device statuses of all routes that originate from the specified DAD are output.
Request body format
{ "action":"submit",
"cliname":"YKDSPRMT",
"CLIPARMS":[
["PREFIX△1prefix"]
[,"DAD△1DADID"]
[,"ROUTEID△1route-list-ID"]
[,"STATUS△1{YES|NO}"]
]
}
Parameters specified in the request body
- PREFIX prefix ~ <PREFIX string of 16 or fewer characters>
-
This is a common parameter included in the default parameter dataset. For details, see Creating a default parameter dataset.
- DAD DADID ~ <DAD string>
-
This is a common parameter included in the default parameter dataset. For details, see Creating a default parameter dataset.
Responses
Return code
If the CLI command has finished running, the return code of the CLI command is set in the rc key of the response. If an error occurs before the CLI command is run, the BCM Web API server sets the return code.
The following table lists and describes the return codes when the YKDSPRMT command ends.
Return code |
Meaning |
---|---|
-3 |
The module cannot be loaded. |
0 |
The command terminated normally. |
4 |
Unknown XML attribute(s) or element(s) were encountered in the configuration file. |
32 |
An I/O error occurred. |
36 |
The configuration file is invalid. |
40 |
|
48 |
There is an error in the record specified for the parameter dataset. |
128 |
The user does not have permission to executed the command. |
For details about return codes set by the BCM Web API server, see Return codes set by the BCM Web API server.