Using the CZALSPAC program
CZALSPAC is a simple list space utility program that sends the allocated and available space on one or more on-line DASD volumes in a syslog message to your configured syslog server. Your syslog server can optionally be configured to send an alert of your choosing if available space falls less than some configured threshold.
CZALSPAC also serves as a sample API program. It is provided in both executable and source code form. See BMC AMI Defender for z/OS application program interface.
In CEF mode, CZALSPAC messages have a Header Signature ID of LSPACE; and a Header Name of LSPACE.
CZALSPAC can be executed with a JCL similar to the following:
// PARM='instance volser volser volser ...'
//STEPLIB DD DSN=<amihlq>.CZAGENT.LOAD,DISP=SHR
//SYSOUT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
Where instance is the desired BMC AMI Defender instance number from 0 to 7 (see INSTANCE= under START-command) and volser volser volser … is one or more volume serial numbers to be checked for space. You might code up to about 14 volsers within the 100 characters allowed by PARM=. If more volsers are needed then execute CZALSPAC one or more additional times. If you need to continue the PARM= parameter onto more than one JCL records, you might continue it as shown:
// ' DB2S01 DB2S02 DB2S03')
There is sample JCL in amihlq.CZAGENT.CNTL(CZALSPAC).
For a complete list of the fields sent by CZALSPAC, see EVENT-LSPACE-fields.
CZALSPAC returns a completion code to the job or the calling program. For information about the possible return codes and their meanings, see Codes issued by BMC AMI Defender products.