Previous Topic: RELEASE CommandNext Topic: STOP Command


SET Command

The SET command modifies the operating parameters of the CA CPM server.

This command has the following format:

SET  [,AUTOAdd=aaopt{No|Yes}]
     [,AUTOPrune=apopt{Yes|No}]
     [,CCIApplname={CpmServer|name}]
     [,CCIRecvsize={32768|size}]
     [,CCISendsize={32768|size}]
     [,CHECKPOINTFile=(list)]
     [,CHECKPOINTInterval={600|secs}]
     [,FLOWLatepercent={100|pct}]
     [,FLOWOverduepercent={110|pct}]
     [,FLOWWarnpercent={90|pct}]
     [,JOBLongpercent={110|pct}]
     [,LOGFile={DD:cpmlog|fname]
     [,MAXCalcdelay={300|secs}]
     [,MAXDepth={1000|count}]
     [,MAXPaths={10000|count}]
     [,MAXSENDerrors=count]
     [,MINAlerttime={0|secs}]
     [,MINCAlcdelay={0|secs}]
     [,MINCCidelay={0|msecs}]
     [,MINJoblongtime={60|secs}]
     [,PURGedelay=secs]
     [,RELOADcheckpoint={Yes|No}]
     [,RESTARttime=timestamp]
     [,RUNOpt={trap(off)|opts}]
     [,STORagesize={131072|bytes}]
     [,TIMERinterval={60|secs}]
     [,TRACE=(optlist)]
     [,USERid=uname]
AUTOAdd

Controls whether jobs should automatically be added to a workflow if a flow event for the job is detected. Specify Yes or No. The default is No.

AUTOPrune

Controls whether to remove jobs from a workflow when they do not appear on any complete path from the start job to the end job. Specify Yes or No. The default is Yes.

CCIApplname

name is the application name for CAICCI communication. The default is CpmServer. If None is specified, the CAICCI communication task is not started.

CCIRecvsize

size specifies the maximum size for an incoming CAICCI message. The minimum value is 512 and the maximum is 32768. The default is 32640.

CCISendsize

size specifies the maximum size for an outgoing CAICCI message. The minimum value is 200 and the maximum is 32768. The default is 32640.

CHECKPOINTFile

list is a list of 1 to 4 file specifications for the checkpoint files. Each specification can be a ddname reference of the form DD:ddname, the name of a file within a mounted HFS, or the name of an MVS data set of the form //'datasetname'. This name can be abbreviated as CKPTF.

CHECKPOINTInterval

secs is the minimum number of seconds between automatic checkpoints. The minimum value is 30 and the maximum is 86400. The default is 600 (10 minutes). This name can be abbreviated as CKPTI.

FLOWLatepercent

pct specifies how long a flow must be running, as a percentage of the difference between the required completion time and the actual start time, before a flow late alert is sent. The minimum value is 50 and the maximum is 10000. The default is 100. This name can be abbreviated as FLP.

FLOWOverduepercent

pct specifies how long a flow must be running, as a percentage of the difference between the required completion time and the actual start time, before a flow overdue alert is sent. The minimum value is 50 and the maximum is 10000. The default is 110. This name can be abbreviated as FOP.

FLOWWarnpercent

pct specifies how long a flow must be running, as a percentage of the difference between the required completion time and the actual start time, before a flow almost late alert is sent. The minimum value is 50 and the maximum is 10000. The default is 90. This name can be abbreviated as FWP.

JOBLongpercent

pct specifies how long a job must be running, as a percentage of the historical runtime for the job, before a job running long alert is sent. The minimum value is 50 and the maximum is 10000. The default is 110. This name can be abbreviated as JLP.

LOGFile

fname specifies the name for the CA CPM log file. The default is DD:cpmlog.

MAXCalcdelay

secs is the maximum time, in seconds, between evaluation/calculations for a flow, even if no events related to the flow have been received. The minimum value is 1 and the maximum is 3600. The default is 300 (5 minutes).

MAXDepth

Maximum depth for a path; paths that exceed MAXDepth are not included in the analysis of the critical path. The minimum value is 1 and the maximum is 100000. The default is 1000.

MAXPaths

Maximum number of paths that are examined while determining the critical path. The minimum value is 1 and the maximum is 1000000. Default is 10000.

MAXSENDerrors

Maximum number of CCI errors for a registered LISTENER. If count is exceeded, the LISTENER is removed. The minimum value is 1 and the maximum is 1000000. The default is 10. This name can be abbreviated as MAXSEND.

MINAlerttime

secs is the minimum time, in seconds, between alerts for the same job or workflow. The minimum value is 0 and the maximum is 3600. The default is 0.

MINCAlcdelay

secs is the minimum time, in seconds, between calculations for a workflow. If events for a flow arrive more rapidly, internal control blocks are updated, but analysis of critical path and projected completion time are delayed. This situation can reduce overhead significantly when there are many short-running jobs. The minimum value is 0 and the maximum is 3600. The default is 0.

MINCCidelay

msecs is the minimum time, in milliseconds, between outgoing CAICCI messages. This setting is necessary on some platforms to avoid CAICCI errors caused by sending messages too quickly. The minimum value is 0 and the maximum is 3600. The default is 0.

MINJoblongtime

secs is the minimum elapsed time, in seconds, which must pass before a Job running long alert is issued. This setting prevents alerts for short-running jobs. The minimum value is 60 and the maximum is 3600. The default is 60.

PURGedelay

secs is the time, in seconds to retain completed flows in the CA CPM environment. The minimum value is 0 and the maximum is 86400. The default is 300.

RELOADcheckpoint

Controls the use of checkpoint data at CA CPM restart. If Yes is specified, CA CPM reloads the environment from the most recently written checkpoint file. If NO is specified, all checkpoint data is ignored. This is normally specified in the PARM field for the CA CPM server, not in a CPMPARMS data set. The default is YES.

RESTARttime

Overrides the time from which flow events should be requested from CAIENF. This timestamp is in the form of yydddhhmmssth. Default is N/A, which means that the restart time is taken from the checkpoint file, or current time if no checkpoint is reloaded. This is normally specified in the PARM field for the CA CPM server, not in a CPMPARMS data set.

RUNOpt

Specifies a string of runtime options to pass to all subtasks. This value is useful only on MVS systems. The default is "trap(off)".

STORagesize

Specifies the amount of storage, in bytes, to acquire whenever additional storage is needed. CPM subdivides each acquired block as needed. The default is 131072, which is the minimum amount that can be specified. The maximum is 268435456.

TIMERinterval

Specifies the length, in seconds, of the timer that periodically awakens time-driven CA CPM components. The minimum value is 1, and the maximum value is 600. The default is 60.

TRACE

Specifies any combination of the following:

OFF

Logs no trace messages. The current list of trace options is retained.

ALL

Logs all trace messages.

CCI

Includes CAICCI trace messages.

CALCulations

Includes messages for flow calculations.

CHECKpoint

Includes messages for the checkpoint read/write routines.

COMMands

Includes messages for the operator command processor.

CONTROLblocks

Includes formatted control blocks. This value can be abbreviated as 'CB'.

DATa

Includes formatted data buffers.

ENF

Includes messages for CAIENF processing.

ENTRy

Includes messages for module/function entry.

EVENTs

Includes messages for event processing.

EXIT

Includes messages for module/function exit.

FLOWstatus

Includes messages for flow status processing.

JOBstatus

Includes messages for job status processing.

RETURNcodes

Include messages for all non-zero return codes. This value can be abbreviated as 'RC'.

SCHEDapi

Includes messages for calls made to the scheduler flow API.

Note: To turn off individual trace options, prefix the option name with NO. For example, SET TRACE=(ALL,NOCCI,NOJOB) turns on all tracing options, except for CCI and JOBstatus.

USERid

Specifies the user name/ID passed to the scheduling products in the FLOW API.