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 CAIENF event creation for a specific event by screening out (excluding) events with certain data field values. This control option should be used with care, since all CAIENF listening applications will 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.

Options are:

event_name

Can be any defined event.

NONE

(Optional) Used to remove existing SCREEN settings. After executing this option, new settings can be issued.

data_name

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

operand

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

mask

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

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

SCREEN(JOBTERM,ACCOUNT,NE,P*) 

Screens out 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 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 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 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@@@$)

The above statements screen out 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 that have 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.