CAIENF Control Options › Control Options Summary - CAIENF › SELECT(event_name,data_name,operand,mask,[grp_id])

SELECT(event_name,data_name,operand,mask,[grp_id])

Controls CAIENF event logging (recording on the CAIENF database) for a specific event. Options are listed and described as follows:

event_name

Can be any defined event.

data_name

Must be a data name associated with the specified event.

operand

Can be EQ, NE, GT, NG, LT, or NL.

mask

A masking pattern that can include the * (match any length string) and ? (match single character.)

grp_id

(Optional) A value used to group commands with AND logic. There is no limit to the number of commands that can be grouped, and there is no limit to the number of groups that can be designated. However, grouping is done separately for each event type. That is, you cannot group different types of event statements in a single group.

Examples

Command examples are as follows:

SELECT(JOBTERM,ACCOUNT,EQ,P*)

Logs only JOBTERM events where the ACCT field starts with P (for instance, logs only jobs with production account numbers).

SELECT(DSCLOSE,JOBNUM,NE,TSU*)

Logs only DSCLOSE events where the JOBNUM field does not start with TSO (for instance, does not log data set activity for TSO users).

SELECT(DSCLOSE,VOLUME,NE,MVS*)
SELECT(DSCLOSE,IOCOUNT,GT,1000)
SELECT(DSCLOSE,DSN,EQ,SYS1.*)

Logs DSCLOSE events where the VOLSER does not start with MVS, or greater than 1000 I/O operations are done, or the data set name starts with “SYS1.”.

SELECT(DSCLOSE,VOLUME,EQ,VSE*,GP0) 
SELECT(DSCLOSE,IOCOUNT,GT,500,GP0)
SELECT(DSCLOSE,VOLUME,EQ,MVS*,GP1) 
SELECT(DSCLOSE,IOCOUNT,GT,1000,GP1)
SELECT(STEPTERM,JOBNAME,EQ,PRD*,GP1)
SELECT(STEPTERM,CLASS,EQ,M,GP1)
SELECT(STEPTERM,STEPNAME,EQ,FTP@@@$)

The above statements cause logging of DSCLOSE events where the VOLSER starts with VSE and greater than 500 I/O operations are done or where the VOLSER starts with MVS and greater than 1000 I/O operations are done.

The statements also cause logging of STEPTERM events for jobs that have names that start with the characters PRD and have a jobclass of M or where the stepname is FTP@@@$.

As evidenced by the examples above, multiple SELECT statements for the same event can be specified. It should be noted that the event is logged if the event data matches any of the above criteria.

SETCCP([restart_max,][pause_time])

Sets the parameters for managing CAICCI spawned services. SETCCP can be issued at any time.

restart_max

(Optional) Sets the restart limit. This limit prevents CAICCI from repeatedly restarting failed services. The default limit is 3.

Once a service has reached its restart maximum, it will no longer be automatically restarted by CAIENF/CAICCI, but can be reenabled using the STARTCCP command.

pause_time

(Optional) Sets the time to pause after a z/OS STOP before a z/OS CANCEL is issued. The default is 10 seconds.

At CAIENF termination, the CAICCI spawn service (CASNMVSR) checks to see if an active service is to be terminated using the z/OS STOP command (the preferred method), or dropped using the z/OS CANCEL command (designated as the "default" method to maintain compatibility with previous CAIENF implementations).

If CASNMVSR issues a z/OS STOP command against the service's started task, then pauses for pause_time seconds. If the task is still active after the pause, a z/OS CANCEL command is issued to force removal of the service from the system.

Note: pause_time is a system-wide specification that applies to ALL services spawned by CAICCI. Each service however, can be configured with its own individual pause time by using SPNPARMS or the CASNESVC module that preempts the default or system-wide setting.

Example:

SETCCP(5,20)

Sets the system-wide restart limit to 5 and sets the system-wide pause-time to 20 seconds.