Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Datastream for Db2 7.1.

Sample CZAGENT JCL for running BMC AMI Defender as a started task


Use JCL that is similar to the following example, which is provided in the CZAGENT member of the amihlq.CZAGENT.CNTL data set.

//CZAGENT PROC RUNMODE=,INSTALL=,VERBOSE=,TRACE=,DEFINES=CZDEFINE,
// INSTANCE=*,SET=,TYPERUN=,
// SECPFX='AMIZOS.AGT', AMI API1 security resource prefix
// LEOPTS=CZALEOPT, CEEOPTS member
// PARMS=CZAPARMS,
// LOAD=LOAD, Change to 'ARCH9.LOAD' for backlevel support
// AMISSID='CZAS', Agent Subsystem ID Must be 4 chars A-Z, 0-9
// SOUT=*, Sysout class
// LOGFREE=DAILY, DAILY/EOJ; When to close and free CZAZOSLG
// SWITCH=DEFLTCFG
//*
//* Cataloged procedure for starting BMC AMI Defender
//*
//* You must edit 'amihlq' below to your installed
//* high level qualifier
//*
//* If you make changes to this JCL note that AMI Defender must
//* be loaded from STEPLIB, not from JOBLIB or the link pack area
//*
//* If you use the DB2 "START" facility to allow AMI Defender to
//* start internal DB2 traces in order to generate SMF 100, 101
//* and 102 records, you must add the DB2 SDSNLOAD library to the
//* STEPLIB concatenation.
//*
//CZAGENT EXEC PGM=CZAZOS,TIME=1440,REGION=0M,PARMDD=CZAPRMDD
//*
//* EXPORT must go before the symbols it exports ...
// EXPORT SYMLIST=*
// SET $DEFINES=&DEFINES
// SET $INSTALL=&INSTALL
// SET $INSTANC=&INSTANCE
// SET $PARMS=&PARMS
// SET $RUNMODE=&RUNMODE
// SET $SET=&SET
// SET $SWITCH=&SWITCH
// SET $TRACE=&TRACE
// SET $TYPERUN=&TYPERUN
// SET $VERBOSE=&VERBOSE
// SET $SSID=&AMISSID
// SET $SOUT=&SOUT
// SET $SPFX=&SECPFX
// SET $FREE=&LOGFREE
//*
//CZAPRMDD DD *,SYMBOLS=JCLONLY
&$VERBOSE,TRACE(&$TRACE),CZAPARMS(&$PARMS),DEF(&$DEFINES),
MODE(&$RUNMODE &$INSTALL),INSTANCE(&$INSTANC),SET(&$SET),
TYPERUN(&$TYPERUN),SWITCH(ON(&$SWITCH)),AMISSID(&$SSID),
SYSOUT(&$SOUT),SPFX(&$SPFX),FREE(&$FREE)
/*
//STEPLIB DD DSN=amihlq.CZAGENT.&LOAD,DISP=SHR
//* DD DISP=SHR,DSN=DB2.SDSNLOAD
//CZAPARMS DD DSN=amihlq.CZAGENT.PARM,DISP=SHR
//SYSEXEC DD DSN=amihlq.CZAGENT.EXEC,DISP=SHR
//CZADIAG DD SYSOUT=&$SOUT
//CEEOPTS DD DISP=SHR,DSN=amihlq.CZAGENT.PARM(&LEOPTS)
//BMCPSWD DD DISP=SHR,DSN=amihlq.CZAGENT.BMCPSWD
// PEND


Important

  • The CZAPARMS DD must specify an entire PDS or PDSE (single data set or a concatenation, LRECL=80, RECFM=FB) and not a member, that is, amihlq.CZAGENT.PARM, not amihlq.CZAGENT.PARM(member)
  • The agent and its exit must be loaded from STEPLIB, not from some other DD such as JOBLIB, nor from the link pack concatenation.

BMC AMI Defender for z/OS parameters

The following parameters provide added functionality:

Parameter

Description

SECPFX

(SPE2104)

Defines the security authorization name prefix for subsystem writers

AMISSID

(SPE2010)

Specifies the name of the AMI z/OS subsystem

Enter a four-character name using A–Z or 0–9. Only one AMI z/OS agent can use the name specified in AMISSID. If a second agent tries using the name, the agent will not be able to enable the AMI z/OS subsystem functionality.

For more information, see BMC-AMI-z-OS-subsystem.

SOUT

(SPE2010)

Specifies the SYSOUT class to be assigned to output log files

LOGFREE

(SPE2107)

Automatically close the CZAZOSLG output log at midnight or when the agent address space is terminated

Specify one of the following values:

  • DAILY—Closes the output log at midnight and opens a new output log
  • EOJ—Maintains a continuous output log
    This might create problems because of the excessive SYSOUT spool usage. You can use the JES command SPIN or the $PRT SPIN command to release the SYSOUT spool and open a new output log.

    F agentname,$PRT SPINFor more information about $PRT SPIN, see MODIFY-command.

    You can then archive the old CZAZOSLG SYSOUT log and clear the JES spool.


 

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