Command Reference Guide

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