HP-UX SNAplus2 R7 Administration Command Reference

Administration Commands

aping

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_RESOURCE_TYPE

The value speciﬁed in the resource_type parameter was not valid.

INVALID_MESSAGE_TYPE

The value speciﬁed in the message_type parameter was not valid.

INVALID_RTP_CONNECTION

The resource_name parameter does not match any RTP connection.

State Check

No speciﬁc state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands,

occur for this command.

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.4 aping

The aping command is the APPN version of the “ping” utility and allows a management application to check the

communications path from a local LU to a remote LU in the network.

Instead of using the aping command, you can use the

APING program described in HP-UX SNAplus2 APPC Ap-

plication Suite User’s Guide.

SNAplus2 aping is implemented using an internally-deﬁned APPC TP. This TP sends data to the partner LU, and

optionally receives data from the partner LU. If the TP completes successfully, aping returns information about

the time taken to allocate a conversation to the partner LU and to send and receive data.

This command is intended for checking the path to an LU on a remote node. Using aping to check communications

with a partner LU on the local node will impact the performance of other programs on the local computer, and is

not recommended.

This command must be issued to a running node.

2.4.1 Supplied Parameters

Parameter name Type Length Default

[aping]

lu_name character 8 (null string)

lu_alias character 8 (null string)

plu_alias character 8 (null string)

mode_name character 8

tp_name character 64 APINGD