 |
» |
|
|
|
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. 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 64 (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. - 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. 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.
Returned Parameters | |
Parameter name Type Length
tp_name character 64
system_name character 64
|
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.
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. 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.
|
Printable version
