Previous Topic: (MII) EXEMPT Command-Modify Exempt ListNext Topic: (MII) GLOBAL Statement-Manage ENQ Requests and Hardware Reserves


(MII) GDIINIT Statement-Set GDIF Initialization Values

The GDIINIT statement lets you set initialization values for the GDIF.

This command has the following format:

GDIINIT [EXEMPT={name|NONE}]
        [MISMATCHQNAME={ACCEPT|QUIT} ]
        [NMCOUNT=number]
        [PROCESS={ALLSYSTEMS|SELECT} ]
        [RESERVES={CONVERT|KEEP} ]
        [TEMPORARYDSN={NO|YES} ]
EXEMPT

(Optional) Identifies the member of the CA MIM parameter data set that contains the GDIF exempt list. This member provides GDIF with supplemental and more specific information on how to process ENQ requests, hardware reserves, or both for resources.

By default, GDIF uses the member named GDIEXMPT. To use a different member, specify its name in place of the name parameter. If you do not want to exempt anything, then specify the statement

GDIINIT EXEMPT=NONE.

Default: EXEMPT=GDIEXMPT

MISMATCHQNAME

(Optional) Tells CA MII how to handle discrepancies between the QNAME list read from parmlib and the QNAME list used by other systems of the MIMplex. The discrepancies are discovered during a CA MII restart. We recommend that you do not specify this parameter and allow it to take the default; this parameter will be eliminated in a future version of CA MII.

Note: MISMATCHQNAME affects only the system executing the GDIINIT statement.

ACCEPT

If CA MII discovers a QNAME list mismatch during a CA MII system restart, it discards the QNAME list read from parmlib and uses the QNAME list already in use other systems in the MIMplex. CA MII produces informational messages about the mismatch and restarts successfully. We recommend using MISMATCHQNAME=ACCEPT, as this will be the only mode of operation in a future version of CA MII.

QUIT

If CA MII discovers a QNAME list mismatch during a CA MII system restart, it issues fatal error messages, issues a U0095 user abend, and will not successfully restart. This mode of operation will be eliminated in a future version of CA MII, and is discouraged by CA.

Default: MISMATCHQNAME=ACCEPT

NMCOUNT

(Optional) Specifies the maximum number of displayable non-managed resources on the DISPLAY COUNTS command. Specify a number from 1 to 255. If this parameter is not specified, the default value is 255.

Default: 255

PROCESS

(Optional) Indicates whether GDIF should propagate certain requests by default or only the requests that you designate. Specify one of these values on the PROCESS parameter:

ALLSYSTEMS

Specifies that GDIF should propagate all requests that have a scope of SYSTEMS, plus any other requests that you designate through the QNAME list. When SCOPE=SYSTEMS, ENQ and RESERVE requests are dynamically added to the QNAME list.

SELECT

Specifies that GDIF should propagate only the requests that you designate.

Important! With GDIINIT PROCESS=SELECT, administrators currently must monitor ENQ activity to ensure that the ENQs were properly defined to avoid integrity exposure for ENQs with SCOPE=SYSTEMS. Because of the much lower maintenance requirements associated with GDIINIT PROCESS=ALLSYSTEMS mode, and the elimination of multi-systems data integrity exposures with this mode, we recommend that you use GDIINIT PROCESS=ALLSYSTEMS.

Notes:

Default: PROCESS=SELECT

RESERVES

Indicates whether GDIF should eliminate hardware reserves when propagating a RESERVE request to other systems. Specify one of these values on the RESERVES parameter:

CONVERT

Specifies that GDIF should convert (that is, eliminate) the hardware reserve.

KEEP

Specifies that GDIF should retain the hardware reserve.

You can override this value for a class of resources (through a QNAME statement) or for a specific resource (through a GLOBAL statement).

Default: RESERVES=CONVERT

TEMPORARYDSN

Indicates whether GDIF should propagate ENQ requests for temporary data sets. Specify NO or YES on this parameter. Do not specify the statement GDIINIT TEMPORARYDSN=NO if any job on the local system scratches undeleted temporary data sets on volumes that other systems are using.

Default: YES

Usage Note: GDIINIT Statement

Example: GDIINIT Statement

To tell GDIF to use the member MYEXMPT to obtain its exempt list, specify this statement in the initialization member:

GDIINIT EXEMPT=MYEXMPT