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 the CAIENF event logging (recording on the CAIENF database) for a specific event.

event_name

Any defined event.

data_name

Must be a data name that is associated with the specified event.

operand

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

mask

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

grp_id

(Optional) Value that is used to group commands with AND logic. The number of commands that can be grouped is not limited. The number of groups that can be designated is also not limited. 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 the 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 the 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 the 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@@@$)

These 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 screen out STEPTERM events for jobs with names that start with the characters PRD and have a jobclass of M or where the stepname is FTP@@@$.

As evidenced by these examples, multiple SELECT statements for the same event can be specified.

Note: The event is logged if the event data matches any of the above criteria.