Administration Commands

query_available_tp

system_name

The computer name for which TP information is required. The system name is a string of 1–64 locally displayable characters. This value is ignored if list_options is set to FIRST_IN_LIST.

If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the computer name.

It is not necessary to specify the system_name parameter if SNAplus2 is standalone. In a client-server system, specify the system name to list only TPs on a specified computer. If you do not specify this parameter, SNAplus2 lists TPs on all computers.

2.103.2 Returned Parameters

Parameter name

Type

Length

tp_name

character

64

system_name

character

128

If the command executes successfully, SNAplus2 returns the following parameters:

tp_name

TP name.

system_name

Name of the computer where the TP is running.

2.103.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

Possible values are:

UNKNOWN_TP

The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the tp_name parameter value was not valid, or the system_name parameter was supplied and was not valid.

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.

308

Page 308
Image 308
HP UX Internet and Networking Software manual 308