Invokes a Control‑M/Analyzer rule to be executed.
| Additional information | Description | |
|---|---|---|
| Usage | Optional | |
| Variable Support | None | |
| Alternate names | 
 | |
| Alternate formats | ||
| Control‑M/EM Utilities | DOCTBRULE contains the following sub-parameters. | |
| NAME | Name of the Control‑M/Analyzer rule that is to be executed. | |
| PAR | Arguments | |
| Sub-parameters | ||
| name | Text box. Name of the Control‑M/Analyzer rule that is to be executed. The Control‑M/Analyzer rule contains all balancing specifications to be performed. Mandatory. | |
| Length | 1 through 8 characters | |
| Case Sensitive | Yes | |
| Invalid Characters | Blanks; non-English characters | |
| ARG | Text box. Arguments that are passed to the Control‑M/Analyzer rule. Separate multiple arguments by commas. Optional. | |
| Length | 1 through 45 characters | |
| Case Sensitive | Yes | |
| Invalid Characters | Blanks; non-English characters | |
When Control-M Analyzer is specified, balancing is performed by the Control-M/Analyzer Runtime environment according to the specified rule definition and using the specified arguments. The Control-M/Analyzer Runtime environment is invoked once for each Control-M Analyzer statement in the job scheduling definition.
If Control-M Analyzer is specified under ON PGMST ANYSTEP, the Control-M/Analyzer Runtime environment is invoked only once.
When Control-M calls a Control-M/Analyzer rule, Control-M/Analyzer System variable SYSOPT contains the value CTMWORK. This variable can then be tested within the Control-M/Analyzer rule definition to determine if Control-M invoked the Control-M/Analyzer Runtime environment.
When the Control‑M/Analyzer Runtime environment is invoked by Control‑M, that is, Control‑M/Analyzer System variable SYSOPT is set to CTMWORK, Control‑M/Analyzer can analyze and balance SYSDATA. For more information about invoking Control‑M/Analyzer rules from Control-M job scheduling definitions, see the discussion of the interface to Control-M in the Control-M/Analyzer User Guide.
This parameter is available only for Control‑M for z/OS jobs at sites using Control‑M/Analyzer.
EXAMPLE: Execute a Control‑M/Analyzer rule when a job ends OK
If the job ends OK, execute Control-M/Analyzer balancing rule GOVTBAL.
JOB: GOVTREPT LIB CTM.PROD.SCHEDULE FOLDER: BACKUP
COMMAND ===> SCROLL===> CRSR
+--------------------------------------------------------------------------+
TIME: FROM UNTIL PRIORITY DUE OUT SAC CONFIRM
TIME ZONE:
===========================================================================
OUT FINANCE-GOVTREPT-OK ODAT +
AUTO-ARCHIVE Y SYSDB Y KEEP ACTIVE FOR MAXIMUM RERUNS
RETENTION: # OF DAYS TO KEEP 030 # OF GENERATIONS TO KEEP
Output OP (C,D,F,N,R) FROM
MAXIMUM RERUNS RERUNMEM INTERVAL FROM
STEP RANGE FR (PGM.PROC) . TO .
ON PGMST ANYSTEP PROCST CODES OK A/O
DO CTBRULE = GOVTBAL ARG DOREPORT,10,%%ODATE
DO
ON PGMST PROCST CODES A/O
DO
NOTIFY WHEN NOTOK TO TSO-M44 URGN R
MS JOB GOVTREPT ENDED "NOT OK"
NOTIFY WHEN TO URGN
MS
======= >>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<< ======
COMMANDS: EDIT, DOC, PLAN, JOBSTAT 11.17.00
| Parent Topic |