HP UX Internet and Networking Software manual Livenesstimeout, Shortholdmode, Remoteiphost

Administration Commands

define_ip_ls

The maximum number of times that the local station will retry sending a command frame. If this retry count is exceeded without receiving a response, the link is considered to have failed.

A lower value for this parameter means that link failures will be detected quickly, but may cause unnecessary reporting of link failures if a few packets are lost.

Specify a value in the range 0–255. A typical value is 10 retries.

liveness_timeout

Duration for the liveness timer (sometimes called the TL timer): the time in milliseconds for which the link will be held active if there is no evidence that the remote station is still active.

A lower value for this parameter means that link failures will be detected quickly, but may increase network traffic on idle active links.

Specify a value in the range 1–65535 milliseconds. A typical value is 10000 (10 seconds).

short_hold_mode

Specifies whether the liveness protocol runs only if there has been no evidence that the remote system is still active since data was last transmitted (YES or NO).

Setting this parameter to YES allows links to stay active and idle without unnecessary data traffic, but means that link failures are not detected until the local station attempts to send data. In general this parameter should be set to NO.

remote_ip_host

Remote host name of the destination node for this link. This can be specified as a dotted-decimal IP address (such as 193.1.11.100), as a name (such as newbox.this.co.uk), or as an alias (such as newbox). If you specify a name or alias, the HP-UX system must be able to resolve this to a fully qualified name (either using the local TCP/IP configuration or using a Domain Name server).

2.32.2 Returned Parameters

No parameters are returned by SNAplus2 when this command executes successfully.

2.32.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:

CANT_MODIFY_PORT_NAME

The ls_name parameter matched the name of an existing LS, but the port_name parameter did not match the existing definition. You cannot modify the port name when changing the definition of an existing LS.

DEF_LINK_INVALID_SECURITY

The security parameter was not set to a valid value.

INVALID_AUTO_ACT_SUPP

109