HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_ACTIVE_TRANSACTION
/* origin */
unsigned char fq_dest_cp_name[17]; /* cp name of transaction */
/* destination */
unsigned char dest_ms_appl_name[8]; /* appl name of transaction dest */
unsigned char fq_req_loc_cp_name[17]; /* fq cp name of transaction */
/* requestor */
unsigned char req_agent_appl_name[8]; /* appl name of transaction */
/* requestor */
unsigned char seq_num_dt[17]; /* sequence number date/time */
unsigned char reserva[20]; /* reserved */
} ACTIVE_TRANSACTION_DATA;
3.90.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_ACTIVE_TRANSACTION
buf_ptr
A pointer to a data buffer that SNAplus2 will use to return the requested information.
buf_size
Size of the supplied data buffer.
num_entries
Maximum number of transactions for which data should be returned. To request data for a specific transaction
rather than a range, specify the value 1. To return as many entries as possible, specify zero; in this case,
SNAplus2 will return the maximum number of entries that can be accommodated in the supplied data buffer.
list_options
The position in the list from which SNAplus2 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 fq_req_loc_cp_name, req_agent_appl_name, and seq_num_dt
parameters.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the fq_req_loc_cp_name,
req_agent_appl_name, and seq_num_dt parameters.
The list is ordered by fq_req_loc_cp_name, then by req_agent_appl_name, and finally in numerical order of
seq_num_dt. For more information about how the list is ordered and how the application can obtain specific
entries from it, see Section 2.7, List Options For QUERY_* Verbs.
fq_req_loc_cp_name
Fully qualified control point name of the transaction requestor. This parameter is ignored if list_options is
set to AP_FIRST_IN_LIST. The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It
consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character, and a network
name of up to 8 A-string characters.
req_agent_appl_name
Application name of the transaction requestor. This parameter is ignored if list_options is set to
AP_FIRST_IN_LIST.
343