hagsns Command

Purpose

Gets group services name server information.

Syntax

hagsns [-h host] [-c] -g group_name

hagsns [-h host] [-c] -s subsystem_name

hagsns [-h host] [-c] -p subsystem_pid

Description

Use the hagsns command to query the status of the group services nameserver.

Flags

-c

Forces the output as "English_only." If the -c flag is not specified, the daemon's locale will be used for the output.

-g group_name

Specifies a group of subsystems to get status for. The command is unsuccessful if the group_name variable is not contained in the subsystem object class.

-h host

Specifies the host to obtain name server status for.

-p subsystem_pid

Specifies a particular instance of the subsystem_pid to obtain name server status for.

-s subsystem_name

Specifies a subsystem to get status for. The subsystem_name variable can be the actual subsystem name or the synonym name for the subsystem. The command is unsuccessful if the subsystem_name variable is not contained in the subsystem object class.

Parameters

daemon_name

Specifies the name used by the daemon to name log files and identify its messages in the AIX error log.

Security

You must have root authority to run this command.

Exit Status

0

Indicates that the command completed successfully.

a non-zero value

Indicates that an error occurred.

Restrictions

This command is valid in a PSSP environment only.

Standard Output

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

Standard Error

This command writes error messages, as necessary, to standard error.

Examples

hagsns -c -s cthags

hagsns -s cthags

HA GS NameServer Status
NodeID=1.16, pid=14460, domainID=6.14, NS established,CodeLevel=GSLevel(DRL=8)
NS state=kCertain, protocolInProgress=kNoProtocol,outstandingBroadcast=KNoBcast
Process started on Jun 19 18:34:20, (10d 20:19:22) ago, HB connection took (19:14:9).
Initial NS certainty on Jun 20 13:48:45, (10d 1:4:57) ago, taking (0:0:15).
Our current epoch of Jun 23 13:05:19 started on (7d 1:48:23), ago.
Number of UP nodes: 12
List of UP nodes: 0 1 5 6 7 8 9 11 17 19 23 26

In this example, domainID=6.14 means that node 6 is the name server (NS) node. The domain ID consists of a node number and an incarnation number. The incarnation number is an integer, incremented whenever the group services daemon is started. NS established means that the name server was established.

Location

/opt/rsct/bin/hagsns

Contains the hagsns command

Files

/var/ha/log/hags_nodenum_instnum. syspar_name

Contains the log of the hagsd daemons on the nodes.

/var/ha/log/hags.syspar_name_nodenum_instnum.syspar_name

Contains the log of each hagsd daemon on the control workstation.