Administration Commands
query_ls
Parameter Check
No parameter errors occur for this command.
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.140 query_ls
The query_ls command returns a list of information about the link stations defined at the node. This information is structured as determined data (data dynamically gathered during execution, and returned only if the LS is active) and defined data (data supplied in the definition of the LS).
This command can be used to obtain summary or detailed information about a specific link station or about multiple link stations, depending on the options used. For multiple link stations, the information is returned in a separate entry for each link station.
2.140.1 Supplied Parameters
Parameter name | Type | Length | Default |
[query_ls] |
|
|
|
num_entries | decimal |
| 1 |
list_options | constant |
| SUMMARY + LIST_INCLUSIVE |
ls_name | character | 8 | (null string) |
port_name | character | 8 | (null string) |
Supplied parameters are:
num_entries
Maximum number of link stations for which data should be returned. You can specify 1 to return data for a specific link station, a number greater than 1 to return data for multiple link stations, or 0 (zero) to return data for all link stations.
list_options
The level of information required for each entry and the position in the list of link stations from which SNAplus2 begins to return data.
Specify the level of information required with one of the following values:
SUMMARY
Summary information only
DETAIL
Detailed information
Use a + character to combine this value with one of the following values:
FIRST_IN_LIST
411