Skip to Content

Using the CZASMFLD program (version 5.9.02)

The CZASMFLD program reads SMF records from an input file and passes them to the designated BMC AMI Defender for z/OS agent. The agent address space must be active and running on the local LPAR.


Setting up CZASMFLD

You can find a sample procedure in amihlq.CZAGENT.CNTL(CZASMFLD). The procedure builds control cards for an IBM SMF Dump program (IFASMFDP) to select key SMF records that are created before starting the BMC AMI Defender for z/OS agent. The procedure contains examples of the IFASMFDP control cards and documentation for the execution parameters required to run CZASMFLD.

You can use the sample procedure to select any SMF records from an existing SMF data set and pass the records to the local agent.


Invoking CZASMFLD

The CZASMFLD program requires the following execution parameters to control its processing:

(5.9.02, January 2020 applied)

//SMFLOAD  EXEC PGM=CZASMFLD,TIME=1440,REGION=0M,
//         PARM='&INSTANCE &RECSEND &RECSEC'
//STEPLIB  DD  DSN=<amihlq>.CZAGENT.LOAD,DISP=SHR
//CZALOG   DD  DISP=SHR,DSN=<smfRecordFile>
Click to expand code sample without 5.9.02, January 2020 applied.

The PARM= line contains the difference between this version and the 5.9.02, January 2020 version.

//SMFLOAD  EXEC PGM=CZASMFLD,TIME=1440,REGION=0M,
//         PARM='&INSTANCE.,&RECSEND.,&RECSEC.'  
//STEPLIB  DD  DSN=<amihlq>.CZAGENT.LOAD,DISP=SHR
//CZALOG   DD  DISP=SHR,DSN=<smfRecordFile>


Parameter

Description

&INSTANCE

Agent name or instance number of the 

BMC AMI Defender agent

You can obtain the agent name and instance number values from the CZA0205I message in the agent’s JESLOG. For more information about the message, see Messages CZA0200 through CZA0299.

&RECSEND

Number of records to send to the agent

Warning

Note

If the input file does not have enough records to fulfill the specification, the program rereads the file until it reaches the specified record count.

For example, if the record count specification is 100 and only 35 records are in the input file, the file is opened, processed, and closed three times. For the first two iterations, the product passes the entire file to the agent. For the third iteration, the product passes only the first 30 records to the agent, thereby reaching the 100-record count.

To limit the execution to a single pass of the entire file, specify a record count of zero.

&RECSEC

Rate (records per second) at which the program sends records to the agent

When running in an environment that produces tens of thousands of SMF records per second, the product might overwhelm the agent’s queue and overall system-processing capacity. You might need to limit the number of records per second that the product passes to the agent.

Set this parameter based on your specific environmental considerations. If you are unsure, consider the anticipated number of input records and the completion requirement of the job.

A value of zero has no restriction and results in the product passing records to the agent as fast as they can be read.

CZALOG

Input SMF record file

The record file contains specific SMF input records. The record file can be an SMF-record archive data set or extracted records from the SMF dump utility program (IFA SMFDP).


Related topic

Command-and-syntax-reference


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Defender for Db2 5.9