HP UX Internet and Networking Software manual Aping, Primaryrc

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 specified in the resource_type parameter was not valid.

INVALID_MESSAGE_TYPE

The value specified in the message_type parameter was not valid.

INVALID_RTP_CONNECTION

The resource_name parameter does not match any RTP connection.

State Check

No specific 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-defined 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

44