Supplied parameters

The application supplies the following parameters:

opcode

AP_QUERY_AVAILABLE_TP

buf_ptr

A pointer to a data buffer that CS Linux will use to return the requested information.

buf_size

Size of the supplied data buffer.

num_entries

Maximum number of TPs for which data should be returned. To request data for a specific TP rather than a range, specify the value 1. To return as many entries as possible, specify zero; in this case, CS Linux will return the maximum number of entries that can be accommodated in the supplied data buffer.

list_options

The position in the list of TPs from which CS Linux should begin to return data. Possible values are:

AP_FIRST_IN_LIST

Start at the first entry in the list.

AP_LIST_INCLUSIVE

Start at the entry specified by the combination of TP name and system name.

AP_LIST_FROM_NEXT

Start at the entry immediately following the entry specified by the combination of TP name and system name.

For more information about how the list is ordered and how the application can obtain specific entries from it, see List options for QUERY_* Verbs.

tp_name

TP name. This is a 64-byte string, padded on the right with spaces if the name is shorter than 64 characters. This value is ignored if list_options is set to AP_FIRST_IN_LIST.

system_name

The computer name for which TP information is required. The system name is an ASCII string of 1-128 characters, which must match a CS Linux computer name. This value is ignored if list_options is set to AP_FIRST_IN_LIST.

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

If CS Linux is running with all programs on a single computer, there is no need to specify the computer name (it can be left as all binary zeros). For a client/server system, specify the computer name to list only TPs on the specified computer, or leave it as all binary zeros to list TPs on all computers.