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. 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:

Where instance is the desired BMC AMI Datastream 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:

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 Datastream products.