Command Reference Guide

Administration Commands
query_active_transaction
fq_req_loc_cp_name
Fully qualified control point name of the transaction requestor.
req_agent_appl_name
Application name of the transaction requester. This name is usually a type-1134 character string; alternatively,
it can be one of the MS Discipline-Specific Application Programs specified in
Systems Network Architecture:
Management Services.
seq_num_dt
Sequence number date/time correlator (17 bytes long) of the original transaction, as defined in Systems Network
Architecture: Formats.
2.101.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:
INVALID_ACTIVE_TRANSACTION
The fq_req_loc_cp_name, req_agent_appl_name, and seq_num_dt parameter values did not match the
parameter values specified for an active transaction.
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands,
occur for this command.
Function Not Supported
If the command does not execute because the node’s configuration does not support it, SNAplus2 returns the
following parameters:
primary_rc
FUNCTION_NOT_SUPPORTED
The local node does not support MS network management functions; support is defined by the
mds_supported parameter on the define_node command.
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.
304