Previous Topic: (MII) SETOPTION ECMF Command-Set ECMF Operating ValuesNext Topic: (MII) SETOPTION GDIF Command-Set GDIF Operating Values


(MII) SETOPTION EDIF Command-Set EDIF Operating Values

The SETOPTION EDIF command lets you set operating values for the EDIF.

Scope: Local

This command has the following format:

SETOPTION EDIF [EDIFDUMP={NO|YES}]
               [MEMBER[=name]]
               [PLISTDUMP={NO|YES}]
               [PLISTMSG={NO|YES}]
               [RESETPRINT=(options)]
               [RESETTRACE=(options)]
               [REVERSEAUTH={NO|YES}]
               [SETPRINT=(options)]
               [SETTRACE[={ALL |
                         [CLOSE]
                         [ENQDEQ]
                         [OPEN]
                         [REGS={NO|YES}]
                         [SVC19]
                         [SVC20]
                         [SVC22]} ]]
               [STATCOLLECT={ALL| NONE | NOSUBTYPE=(list) | SUBTYPE=(list)}]
               [STATCYCLE=seconds]
               [STATINTERVAL=minutes]
               [STATUS={ACTIVE|INACTIVE}]
               [SVCDUMP={NO|YES}]
EDIF

Tells CA MIM that you are setting operating values for EDIF rather than for any other facility. Because SVCDUMP is the name of both a CA MIM operand and an EDIF operand, you must specify the EDIF operand before the SVCDUMP operand to distinguish it from the CA MIM version of this operand. Also specify the EDIF operand if you want to truncate an operand in a way that may be ambiguous with operands for other facilities.

Because EDIF is a positional operand, you must specify it before any other operand.

EDIFDUMP

(Optional) Provides additional restrictions for the SVCDUMP operand. When SETOPTION EDIF SVCDUMP=NO is specified and an abend occurs due to a violation of EDIF rules such as incorrect attribute specification, a user address space dump is still produced. To prevent that dump from being produced, issue the command SETOPTION EDIF EDIFDUMP=NO. If you specify EDIFDUMP=YES, then you will receive a user address space dump whenever EDIF rules are violated, even if you specified SVCDUMP=NO.

Default: NO

MEMBER

(Optional) Tells EDIF to reexamine its processing statements to obtain more up-to-date information.

You can dynamically modify the EDIF processing list in these ways:

Note: You can use this command only if EDIF=ON was specified when you started CA MIM.

To refresh the current EDIF processing list so that any changes you have made to it take effect immediately, you could issue the SETOPTION MEMBER command.

To tell EDIF to use a different processing list, you need to specify the name of the new member on the MEMBER parameter.

PLISTDUMP

(Optional) Indicates whether to generate an SVC dump when an invalid address is encountered by EDIF during OPEN or CLOSE processing of the program parameter list. To generate the SVC dump, issue the command SETOPTION EDIF PLISTDUMP=YES. To prevent the SVC dump from being generated, issue the command SETOPTION EDIF PLISTDUMP=NO.

Default: NO

PLISTMSG

(Optional) Indicates whether the message MIM4012 is issued when EDIF encounters an invalid address in an OPEN or CLOSE parameter list provided by a user program. To suppress the message MIM4012, issue the command SETOPTION EDIF PLISTMSG=NO. To allow the message to be displayed, issue the command SETOPTION EDIF PLISTMSG=YES.

Default: YES

RESETPRINT

(Optional) Allows you to turn off trace event printing for the specified trace option or all options. For an explanation of options, see the SETTRACE operand.

RESETTRACT

(Optional) Allows you to turn off tracing for the specified option or for all options. For an explanation of options, see the SETTRACE operand.

REVERSEAUTH

(Optional) Reverses the manner in which two authorized lists are processed. The two lists are created with the ACCESSLIST and AUTHORIZED parameters. These parameters create the lists on DATASET, DSORG, PREFIX, and other EDIF statements. When you set this option to REVERSEAUTH=YES, the following processing occurs for the ACCESSLIST and AUTHORIZED parameters:

ACCESSLIST--Defines programs that are not authorized to read the data set. ACCESSLIST is available with:

AUTHORIZED--Defines programs that are not authorized to update the data set. AUTHORIZED is available with:

Note: Typically, the program or utility statement lists, created by the ACCESSLIST and AUTHORIZED parameters, define the programs that are authorized to read the data set or update the data set, respectively.

Available options for the REVERSEAUTH parameter are:

NO

Do not reverse processing for the ACCESSLIST and AUTHORIZED parameters. EDIF processes as it usually does.

YES

Reverse Processing for the ACCESSLIST and AUTHORIZED parameters. This processing will define programs that are not authorized to read the data set (in the case of ACCESSLIST) or update the data set (in the case of AUTHORIZED).

Default: REVERSEAUTH=NO

SETPRINT

(Optional) Turns on the print function for the specified trace event options. For an explanation of the available options, see the SETTRACE operand.

Note: The REGS option is only valid on the SETTRACE parameter.

SETTRACE

(Optional) Turns on the trace feature for the specified trace event options. You can specify one or more options:

ALL

Activates trace for all SETTRACE options.

CLOSE

Activates trace for all CLOSE processing.

ENQDEQ

Activates trace for enqueue/dequeue processing.

OPEN

Activates trace for all OPEN processing.

SVC19

Activates trace for SVC19 processing.

SVC20

Activates trace for SVC20 processing.

SVC22

Activates trace for SVC22 processing.

REGS

Specify YES to include the register contents. The default is NO.

Job name filtering is available through the command SET MIM TRACE=(JOBNAME=jjjjjjjj).

STATCOLLECT

(Optional) Controls the creation of statistical records for the EDIF reports. Specify one of the following values:

ALL

Turns on statistical record collection for all record subtypes.

NONE

Turns off all statistical record collection.

NOSUBTYPE

Specifies the record subtypes for which statistical recording is turned off.

SUBTYPE

Specifies the record subtypes for which statistical recording is turned on.

The record subtypes for EDIF reports are:

DC-EDIF statistical count data record subtype

DD-EDIF data set record subtype

Default: STATCOLLECT=NONE

STATCYCLE

(Optional) Specifies how often, in seconds, statistical data is sampled for the EDIF reports.

Default: STATCYCLE=60

STATINTERVAL

(Optional) Specifies how often, in minutes, statistical data samples are recorded for use in the EDIF reports.

Default: STATINTERVAL=15

STATUS

(Optional) This parameter changes the status of EDIF. Specify ACTIVE to activate EDIF or INACTIVE to deactivate EDIF. You can use this operand only if you specified EDIF=ON on a MIMINIT statement, on the PARM parameter of the startup procedure, or on the z/OS START command for CA MIM.

If you specify STATUS=INACTIVE, then you still can issue commands to change the operating values of EDIF. However, EDIF will not perform any type of update, attribute, or read verification for data sets, nor will it issue notification messages.

Default: STATUS=ACTIVE

SVCDUMP

(Optional) Indicates whether EDIF should request an SVC dump of a user address space if an error occurs with EDIF.

If the SVCDUMP parameter is set to YES, then you then can stop EDIF from generating SVC dumps by specifying SETOPTION EDIF SVCDUMP=NO. You must specify EDIF (or a shortened form) to distinguish this parameter from the SVCDUMP parameter that is used by the entire CA MIM product.

Important! Some EDIF rule violations such as read access errors can still produce a user address space dump when SVCDUMP=NO. To ensure that you do not receive any dumps due to EDIF rule violations, you must also issue the command SETOPTION EDIF EDIFDUMP=NO. The default is EDIFDUMP=YES, which allows user address space dumps.

Default: SVCDUMP=YES

Usage Notes: SETOPTION EDIF Command

Example: SETOPTION EDIF Command

To reactivate EDIF, issue the following command:

SETOPTION EDIF STATUS=ACTIV