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

Page 304
Image 304
HP UX Internet and Networking Software manual 304