Sample CZAMIOPS JCL for running BMC AMI Datastream for Ops as a started task


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

//CZAMIOPS PROC RUNMODE=,INSTALL=,VERBOSE=,TRACE=,DEFINES=CZADAO,
//   INSTANCE=*,SET=,TYPERUN=,
//   SECPFX='AMIZOS.AGT', AMI API1 security resource prefix
//   LEOPTS=CZALEOPT,     CEEOPTS member
//   PARMS=CZAPAO,
//   LOAD=LOAD,           Change to 'ARCH9.LOAD' for backlevel support
//   AMISSID=CZAO,        AMI Defender Subsystem ID
//   SOUT=*,              Sysout class
//   LOGFREE=DAILY,       DAILY/EOJ; When to close and free CZAZOSLG
//   SWITCH=
//*
//*  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
//*
//CZAMIOPS EXEC PGM=CZAZOSAO,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 $FREE=&LOGFREE
// SET $SPFX=&SECPFX
//*
//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),FREE(&$FREE),SPFX(&$SPFX)
/*
//STEPLIB  DD  DSN=amihlq.CZAMIOPS.&LOAD,DISP=SHR
//CZAPARMS DD  DSN=amihlq.CZAMIOPS.PARM,DISP=SHR
//CZADIAG  DD  SYSOUT=&$SOUT
//CEEOPTS  DD  DISP=SHR,DSN=amihlq.CZAMIOPS.PARM(&LEOPTS)
//BMCPSWD  DD  DISP=SHR,DSN=amihlq.CZAMIOPS.BMCPSWD
//         PEND


Important

  • amihlq represents the high-level qualifier that you assigned to your BMC AMI Datastream for Ops data sets.
  • The CZAPARMS DD must specify an entire PDS or PDSE (single data set or a concatenation, LRECL=80, RECFM=FB) and not a member. For example, amihlq.CZAGENT.PARM but not amihlq.CZAGENT.PARM(member). 
  • The agent and its exit must be loaded from STEPLIB and not from some other DD, such as JOBLIB, or from the link pack concatenation.

Control parameters

The following parameters provide added functionality:

Parameter

Description

AMISSID

Specifies the name of the AMI z/OS subsystem

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

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

Unless you are running two or more agent address spaces on the same LPAR, we recommend you leave the default value for this parameter.

LOAD

Specifies the applicable load library for your system's architecture level

If you do not know which library to use, contact your system administrator. Enter one of the following values:

  • LOAD—This is the default load library. It is tuned for the best performance on the most current, generally-available IBM hardware and operating system.
  • ARCH9.LOAD—If you are running on an older IBM hardware and operating system (prior to z/OS v2.3), you can use this library. It is compiled and linked at architecture level 9 so it can run on IBM zEnterprise 114 or 196 hardware or better.

LOGFREE

Specifies when the CZAZOSLG output log is closed

Enter one of the following values:

  • DAILY—Closes the output log at midnight and opens a new output log
  • EOJ—Maintains a continuous output log until the agent address space is terminated
    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.

SECPFX

Defines the security authorization name prefix for the BMC AMI Datastream for Ops agent address space

We recommend you leave the default value for this parameter.

SOUT

Specifies the SYSOUT class to be assigned to output log files

We recommend you leave the default value for this parameter.


 

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