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

SCREEN(event_name,[NONE] | [data_name,operand,mask,grp_id])

Controls the CAIENF event creation for a specific event by screening out (excluding) events with certain data field values. Use this control option with care, because all CAIENF listening applications no longer receive the excluded events. The SCREEN command can be useful when presented with certain special performance problem circumstances and is often used based on the advice of CA Technologies Support.

event_name

Any defined event.

NONE

(Optional) Used to remove the existing SCREEN settings. Then new settings can be issued.

data_name

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

operand

(Optional) EQ, NE, GT, NG, LT or NL

mask

(Optional) Masking pattern that can include the * (match any length string).

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

SCREEN(JOBTERM,ACCOUNT,NE,P*) 

Screens out the JOBTERM events where the ACCT field does not start with P (for instance, screen out jobs which do not have a production account number).

SCREEN(DSCLOSE,JOBNUM,EQ,TSU*) 

Screens out the DSCLOSE events where the JOBNUM field starts with TSU (that is, screens out data set activity for TSO users).

SCREEN(DSCLOSE,VOLUME,EQ,MVS*)
SCREEN(DSCLOSE,IOCOUNT,GT,1000) 

Screens out the DSCLOSE events where the VOLSER starts with MVS, or greater than 1000 I/O operations are done.

SCREEN(DSCLOSE,NONE)

All settings to screen out events for DSCLOSE are removed. You can then enter the new SCREEN settings.

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

These statements screen out the 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 is evidenced from these examples, multiple SCREEN statements for the same event can be specified. The event is screened out if the event data matches any of the set criteria.