Using AUDITOR with SYSWATCH

Using the EXIT SENDSTAT Option to Send SVM Data to the Central Site: SYSWATCH can forward SVM status from a monitored system to the central site by means of the SENDSTAT exit in AUDITOR. A sample exit routine, SENDSTAT EXEC, is provided for use with this exit. To use this sample, add the line 
EXIT SENDSTAT SENDSTAT

to the AUDITOR OPTIONS file. The SENDSTAT exit routine is executed anytime an SVM’s status is checked. It gets the status information, formats it for SYSWATCH, and sends it to the central monitoring system named in SYSWATCH CONTROL. To ensure you can display the data once it is received, verify you have added a statement to SYSWATCH THRESHLD for each monitored SVM. Use the SVM’s user ID as the variable name in field 3 (see Table 1, and Figure 1).

To use the SENDSTAT exit with your own exit routine, exec_name, include an option statement in the format

EXIT SENDSTAT exec_name

in AUDITOR OPTIONS. The exit routine is passed a string in the format:

userid state

where userid is the service virtual machine monitored by AUDITOR, and state is the corresponding status of that machine (UP, DOWN, SERVICE, CYCLE, RECYCLED, IGNORE, FAILURE, PD, or OFF). The SENDSTAT exit takes this string, formats it for SYSWATCH, and sends it to the central monitoring system named in SYSWATCH CONTROL.

See AUDITOR for details on AUDITOR and its input files.

Setting the Warning Levels for SVMs:

SENDSTAT EXEC associates a number with each of the AUDITOR states. The numbers are:
  • 1=UP
  • 2=DOWN, SERVICE, CYCLE, RECYCLED, IGNORE
  • 3=FAILURE, PD
  • 4=OFF

You can set meaningful warning levels for SVMs by using the above numbers for the Level 1, 2, and 3 values in the SYSWATCH THRESHLD file.

For example, say that for a monitored SVM, CMSAPPL at LOSANGEL, you specify 2 for Level 1, 3 for Level 2, and 4 for Level 3 in SYSWATCH THRESHLD, just like in Figure 1. Then the System Detail panel for node LOSANGEL will display in its Value field for CMSAPPL:
  • 1=UP (in the normal text color), if CMSAPPL’s state is UP
  • 2=DOWN, SERVICE, CYCLE, RECYCLED, IGNORE (in the Level 1 color), if CMSAPPL’s state is DOWN, SERVICE, CYCLE, RECYCLED, or IGNORE.
  • 3=FAILURE, PD (in the Level 2 color), if CMSAPPL’s state is FAILURE or PD
  • 4=OFF (in the Level 3 color), if CMSAPPL’s state is OFF.

 PI end