Administration Commands

query_available_tp

The local node is an end node or LEN node. This command is valid only for a network node.

secondary_rc

(This parameter is not used.)

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.103 query_available_tp

The query_available_tp command returns information about active invokable transaction programs (TPs). Active invokable TPs are APPC applications that have issued the RECEIVE_ALLOCATE verb, or CPI-C applications that have issued the Accept_Conversation or Accept_Incoming call. This command can be used to obtain information about a specific TP or about multiple TPs, depending on the options used. It returns information about all active invokable TPs that are running, whether or not they currently have an APPC verb or a CPI-C call outstanding to accept an incoming conversation.

This command must be issued to a running node.

2.103.1 Supplied Parameters

Parameter name

Type

Length

Default

[query_available_tp]

 

 

 

num_entries

decimal

 

1

list_options

constant

 

LIST_INCLUSIVE

tp_name

character

64

(null string)

system_name

character

128

(null string)

Supplied parameters are:

num_entries

Maximum number of TPs for which data should be returned. You can specify 1 to return data for a specific TP, a number greater than 1 to return data for multiple TPs, or 0 (zero) to return data for all TPs.

list_options

The position in the list of TPs from which SNAplus2 begins to return data.

Possible values are:

FIRST_IN_LIST

Start at the first entry in the list

LIST_INCLUSIVE

Start at the entry specified by the combination of the tp_name and system_name parameters

LIST_FROM_NEXT

Start at the entry immediately following the entry specified by the combination of the tp_name and system_name parameters

tp_name

TP name for which information is required. This name is a 64-byte string. This value is ignored if list_options is set to FIRST_IN_LIST.

307

Page 307
Image 307
HP UX Internet and Networking Software manual Queryavailabletp, Tpname