clDiskList

The clDiskList event producer monitors changes in cluster membership.

Overview

The clDiskList event producer resides under the disk directory and monitors for disks added or removed from the cluster. This event producer is available only when the system is part of a cluster. This event is generated when a disk is added or removed from the cluster (for example, using the chcluster command).

Capabilities

AHAFS_THRESHOLD_STATE
AHAFS_REMOTE_EVENT_ENABLED
AHAFS_CALLBACK_INTRCNTX

Return codes

The clDiskList returns 0 as the return code. Only if the cluster is removed AHAFS_CLUSTER_REMOVE (-1) is returned.

Event producer message

This event producer passes the DISK_ADD and DISK_DELETE messages as part of its event data in the EVENT_TYPE field. It will pass the DISK_NAME and the DISK_UID of the concerned disk. Also, as it is part of a cluster event producer it will additionally pass the NODE_NUMBER, NODE_ID and CLUSTER_ID information.

Acceptable monitor files

To monitor for changes in the list of disks, a monitor file should be created under the clDiskList.monFactory directory. The monitor file name

/aha/disk/clDiskList.monFactory/clDiskListEvent.mon

has to be used. No other monitor files may be created in this directory.

Example event data

The following is event data from a clDiskList event with the default INFO_LVL.

BEGIN_EVENT_INFO
TIME_tvsec=1271927983
TIME_tvnsec=696543410
SEQUENCE_NUM=0
RC_FROM_EVPROD=0
BEGIN_EVPROD_INFO
EVENT_TYPE=DISK_ADD
DISK_NAME=cldisk1
DISK_UID=3E213600A0B800016726C000000FF4B8677C80F1724-100 FAStT03IBMfcp
NODE_NUMBER=2
NODE_ID=0xF079E8C801C11DF
CLUSTER_ID=0x6EA7B08888D811DFB918BEB25635B404
END_EVPROD_INFO
END_EVENT_INFO