hatsoptions Command

Purpose

Controls topology services options on a node or a control workstation.

Syntax

hatsoptions [-s] [-d]

Description

Before this command can be executed, environment variable HB_SERVER_SOCKET must be set to the location of the UNIX domain socket used by the topology services subsystem. The statement below can be used:

export HB_SERVER_SOCKET=/var/ha/soc/hats/server_socket.partition name

Alternatively, variable HA_SYSPAR_NAME can be set to the partition name.

The topology services daemon must be running in order for this command to be successful.

hatsoptions can be used to control a number of options in topology services. Option -s instructs the topology services daemon to reject messages that are apparently delayed. This can be used in very large system configurations, where messages are sometimes delayed in the network or in the sender and receiver nodes. Use this option only if the Time-Of-Day clocks are synchronized across all the nodes and the control workstation. Otherwise messages may be incorrectly discarded when the sender's Time-Of-Day clock is behind the receiver's.

Option -d instructs the topology services daemon not to reject messages that are apparently delayed. This is the default.

Flags

-s: Instructs the topology services daemon to reject messages that are apparently delayed.
-d: Instructs the topology services daemon not to reject messages that are apparently delayed (this is the default).

Security

You must have root privilege to run this command.

Exit Status

0: Indicates the successful completion of the command.
1: Indicates the command was unsuccessful.

Environment Variables

HB_SERVER_SOCKET: This environment variable should be set before this command can be executed. It must be set to the location of the UNIX domain socket used by topology services clients to connect to the topology services daemon. This environment variable must be set to /var/ha/soc/hats/server_socket.partition name.
HA_SYSPAR_NAME: If HB_SERVER_SOCKET is not set, then HA_SYSPAR_NAME must be set to the partition name.

Restrictions

This command is valid in a peer domain only.

Standard Output

When the -h flag is specified, this command's usage statement is written to standard output. All verbose messages are written to standard output.

Standard Error

This command writes error messages (as necessary) to standard error.

Examples

To instruct the topology services daemon on the local node to start discarding apparently delayed messages, enter:

export HA_SYSPAR_NAME=partition1
 
/usr/sbin/rsct/bin/hatsoptions -s

Location

/usr/sbin/rsct/bin/hatsoptions: Contains the hatsoptions command

Files

/var/ha/soc/hats/server_socket.partition name