MODIFY command

czagentName | taskName

Defines the name of the BMC AMI Defender job or started task specified on the START command or in the JCL

For a description of how this name is determined and specified, see "MODIFY command" in the "MVS system commands reference" section on the IBM Knowledge Center website.

This parameter is required.

BACKLOG(Send)

Causes BMC AMI Defender to display message CZA0386 with queue utilization data on the console and in the listing on CZAPRINT

If Send is specified, then a BACKLOG syslog message is transmitted to the BMC Defender Server or another syslog console as a syslog message. SEND might be abbreviated as S. For more information about the BACKLOG syslog message, see BACKLOG-statement.

CLOCKmsg

Causes BMC AMI Defender to transmit the Clock message CZA0352I to the SIEM server, and display the message on the console and in CZAPRINT

Display(...)

Causes BMC AMI Defender to display the currently active settings for the indicated parameters

The values are displayed on the console (except for Display(APF)) and in CZAPRINT in the following format:

LOCal(REOPen)

Specifies that BMC AMI Defender is to close and re-open the LOCAL syslog data set

Before using this command, you should consider the effect of the use or absence of system variable symbols in the specified data set name, and the use or absence of MOD.

PARMs

PARMs( datasetSpecification )

Specifies a data set from which BMC AMI Defender takes new operating parameters

Because the parameter file is an input file, a specification of * (SYSOUT) is invalid, and the output variable symbols are not supported. z/OS command processes uppercase, unquoted command operands, so you can specify a zFS file as follows: 

This file is described in Parameter-file-statements.

Parameter processing starts over each time you read in a parameter file with MODIFY CZAGENT,PARMS with the exception of OPTIONS TRACE, SUBSYS, and QUEUE. Every parameter assumes its default value except for the three parameters named. OPTIONS QUEUE and SUBSYS are ignored during MODIFY processing; to change their values, you must stop and restart BMC AMI Defender; to change the setting of TRACE you must explicitly specify TRACE. So if BMC AMI Defender is running with a LOCAL data set, FORMAT(ALL), and an SMF 119 statement, and you read in a new parameter file with FORMAT, LOCAL, and SMF 119 omitted, then FORMAT assumes its default value of ERGONOMIC, the LOCAL data set is closed, and no further SMF 119 records are formatted and transmitted.

SET(APF)

Causes BMC AMI Defender to re-initialize the table of APF-authorized data sets

The table is refreshed from the current APF list and the defined LNKLST sets. BMC AMI Defender updates this table automatically in most circumstances so this command is superfluous unless one or more of the following situation occurs:

• You are running a release of z/OS below V2R2
• SMF 90 subtype 37 is not enabled for BMC AMI Defender processing
• You have added non-APF-listed files to the active LNKLST

For more information, see "Other Limitations" under APF status enrichment in the "SMF record enrichment" topic. Use caution with SET(APF) as it freezes SMF record processing for about one second, depending on the number of APF-authorized data sets and the speed and processor load of your system.

SET(CICS(NEWMCT))

Requires BMC AMI Defender, for performance reasons, to cache any DFHMCT customization on a per-CICS-applid basis

If you re-customize and stop and start a CICS subsystem you can force BMC AMI Defender to purge and refresh its CICS DFHMCT customization cache with the command SET(CICS(NEWMCT)).

SET(DB2(STArt))

Causes BMC AMI Defender to re-issue any relevant START TRACE commands for DB2

See STArt in the SMF-Db2-statement .

SET(SERVER(RECONnect))

Causes BMC AMI Defender to attempt to reconnect to the active syslog server

This command is only valid if the syslog server is disconnected (due to an error) and using TCP/IP or SSL/TLS transport. This command would be suitable for use when a previously disconnected communication link is restored.

SET(SERVER(USEALT( number )))

SET(SERVER(USEPRImary))

Causes BMC AMI Defender to change the active syslog server to the primary or the specified alternate

For more information, see Multiple-syslog-server-support.

USEPRIMary and USEALT(0) are equivalent.

STATs

STATs(RESET,Send)

Causes BMC AMI Defender to display message CZA0215I with counts of SMF records processed and similar statistics on the console and in the listing on CZAPRINT

In addition, counts by SMF record subtype are displayed only in the CZAPRINT listing. If RESET is specified then the various statistical counters are reset to zero after being displayed. If Send is specified then the statistics (not including the subtype counts) are also transmitted to the BMC Defender Server or another syslog console as syslog messages. Send can be abbreviated as S. For more information about various statistics except the subtypes, see Counters. See Messages CZA0300 through CZA0399 for information about the subtype statistics in messages CZA0323I through CZA0327I.

TRACE( traceSpecification )

Requires BMC AMI Defender to output additional diagnostic messages of the specified type in the CZAPRINT data set

TRACE can be useful for diagnosing certain problems.

If TRACE is completely omitted or specified as TRACE(), it defaults to the previous state of TRACE. If TRACE(-ALL) is specified, all tracing is turned off.

Specify zero or more of the trace types described in Using-the-TRACE-facility (in any order). Prefix any of the specifications with -  (a minus sign or hyphen) to indicate negation. The specifications are processed left to right. For instance, TRACE(ALL -XL -ENV) indicates all TRACE output except related to translation and the operating environment.

After processing TRACE, BMC AMI Defender displays the trace specifications in effect. To simply display the current trace specifications, enter F CZAGENT,TRACE().

For more information, see Using-the-TRACE-facility.

czagentName | taskName

Defines the name of the BMC AMI Defender for z/OS job or started task, as specified on the START command or in the JCL

For a description of how this name is determined and specified, see "MODIFY command" in the "MVS system commands reference" section on the IBM Knowledge Center website.

This parameter is required.

Display(...)

Causes BMC AMI Defender for z/OS to display the currently active settings for the indicated parameters

DAM(SESSions)

Causes BMC AMI Defender for z/OS to display a summary list of all active DAM sessions

The sessions are displayed in session-unique order. The first twenty or fewer sessions are displayed on the console and in CZAPRINT. Any sessions beyond twenty are displayed only in CZAPRINT. The display has the following format:

DAM(SESSions(id))

Displays details for the specified session ID. Enter one or more leading hex digits of a session-unique from the summary session display (or the DAM console)

You must enter enough hex digits to uniquely identify the session.