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

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

Related topics

STOP-command

START-command

MODIFY-command


//CZAGENT  PROC RUNMODE=,INSTALL=,VERBOSE=,TRACE=,DEFINES=CZDEFINE,
//   INSTANCE=*,SET=,TYPERUN=,
//   SECPFX='AMIZOS.AGT', AMI API1 security resource prefix for DATASET
//   SECCLS='DATASET',    AMI API1 security resource class (RACF)
//*  SECCLS='APPL',       AMI API1 security resource class (ACF2)
//   LEOPTS=CZALEOPT,     CEEOPTS member
//   PARMS=CZAPARMS,
//   LPAUPD=COND,         Add exits to LPA COND/FORCE
//   ZIIP=YES,            Enable zIIP $AGENT task
//   TCPNAME='        ',  TCP stack for ZIIP=YES
//   ZADVPR=NO,           Disable zAdviser interface processing
//   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 Datastream
//*
//*  You must edit 'amihlq' below to your installed
//*  high level qualifier
//*
//*  If you make changes to this JCL note that AMI Datastream *must*
//*  be loaded from STEPLIB, not from JOBLIB or the link pack area
//*
//*  If you use the DB2 "START" facility to allow AMI Datastream 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.
//*
//*  If you use the SRCC Parmlib/Proclib change tracking
//*  you must add the ASMFSUPC LOAD 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
// SET $LPA=&LPAUPD
// SET $ZIIP=&ZIIP
// SET $ZADVPR=&ZADVPR
// SET $TCPNAME=&TCPNAME
// SET $SECCLS=&SECCLS
//*
//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),LPA(&$LPA),
ZIIP(&$ZIIP),ZADVPR(&$ZADVPR),TCPNAME(&$TCPNAME),SECCLS(&$SECCLS)
/*
//STEPLIB  DD  DSN=amihlq.LOAD,DISP=SHR
//*        DD  DISP=SHR,DSN=DB2.SDSNLOAD
//*        DD  DISP=SHR,DSN=ASM.SASMMOD2
//CZAPARMS DD  DSN=amihlq.PARM,DISP=SHR
//SYSEXEC  DD  DSN=amihlq.EXEC,DISP=SHR
//CZADIAG  DD  SYSOUT=&$SOUT
//CEEOPTS  DD  DISP=SHR,DSN=amihlq.PARM(&LEOPTS)
//BMCPSWD  DD  DISP=SHR,DSN=amihlq.BMCPSWD
//CZAIJCL  DD  SYSOUT=(A,INTRDR)
//         PEND

Important

  • amihlq represents the high-level qualifier that you assigned to your BMC AMI Datastream for z/OS 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.PARM but not amihlq.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 BMC AMI z/OS subsystem  

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

If no value is specified, the default, CZAS is used.

Tip

If you do not specify a value for AMISSID and accept the default instead, BMC AMI Datastream can dynamically generate subsystem IDs. If the default is in use, for every address space after it, the fourth character in the default name is altered so that it is unique. 

For example, when the first address space starts, it takes the default ID, CZAS. If a second address space starts, it takes the name CZA1. A third address space takes the name CZA2, and so on from 0 through 9.

Dynamically generated subsystem IDs prevent AMISSID collisions when using the default subsystem ID for multiple agent address spaces on the same LPAR.

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

LOAD

Deprecated

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

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.

LPAUPD

Installs, updates, or replaces SMF, API0, API1, Logstream, and BMC AMI DatastreamConsole exits without stopping or restarting the BMC AMI Datastream for z/OS agents running on the LPAR

Enter one of the following values:

  • COND—Installs SMF and console exits during address space initialization only if they are not already installed.
  • FORCE—Updates or replaces SMF and console exits during address space initialization regardless of their current status.
    If the console exits are already installed, the existing exits are disabled and removed from the LPA before installing the new members.

If no value is specified, the default is COND.

SECCLS

(SPE2307)

Defines the security authorization class used by SAF for the BMC AMI Datastream agent address space

SECCLS can be one of the following values:

  • DATASET—Uses the SECPFX prefix for the DATASET resource
  • APPL—(Required for ACF2 users) Uses the four-character AMISSID name for the APPL resource

SECPFX

Defines the security authorization name prefix for the BMC AMI Datastream agent address space for the DATASET security class (see SECCLS)

We recommend that you leave the default value for this parameter.

SOUT

Specifies the SYSOUT class to be assigned to output log files

TCPNAME

(SPE2307)

Specifies the name of the TCP/IP stack, other than the default, that you want to use for your connection

Available to zIIP enabled customers with multiple TCP/IP stacks and a requirement that BMC AMI Datastream and CZASEND use a specific stack that is not the default stack. Most customers should not need to specify this parameter.

If this parameter is used (zIIP is enabled), the TCPname parameter in the OPTIONS-statement is ignored.

If zIIP is enabled and this parameter is not used, the default TCP/IP stack is used.

ZADVPR

(SPE2304)

Enables and disables BMC AMI zAdviser interface processing

  • YES—BMC AMI Datastream sends statistics and usage information to zAdviser.
  • NO—BMC AMI Datastream does not send statistics and usage information to zAdviser.

If no value is specified, the default is NO.

For more information about BMC AMI zAdviser, see BMC AMI zAdviser.

ZIIP

Enables IBM z Systems Integrated Information Processor (zIIP)

YES—BMC AMI Datastream Uses zIIP for environments that are zIIP enabled.

NO—Makes no change to performance.  

Important

ZIIP=YES cannot be used with following OPTIONS-statement parameters:

  • IPASYNCDisable—Enables asynchronous IP client data
  • USSENRICH—Specifies whether to collect information on z/OS Unix System Services (USS) superuser privileges

 

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