CA MII Statements and Commands › (MII) GLOBAL Statement-Manage ENQ Requests and Hardware Reserves

(MII) GLOBAL Statement-Manage ENQ Requests and Hardware Reserves

The GLOBAL statement lets you identify ENQ requests that should be propagated and lets you change the way GDIF handles hardware reserves for a specified resource. You can use this statement to override values you specified on the DEFAULT, LOCAL, and GDIINIT statements. The GLOBAL statement is available only with the GDIF of the CA MII component.

This command has the following format:

GLOBAL {JOB=name [PERMANENT={NO|YES}] | RNAME=rname [PERMANENT={NO|YES}]
                                                    [QNAME=qname]
                                                    [RESERVES={CONVERT|KEEP}] }

JOB

Indicates that GDIF should propagate ENQ requests for the resources requested by this job. Specify the name of this job in place of the name variable. You can use the asterisk (*) and pound (#) wildcard characters to match more than one job with this statement.

PERMANENT

(Optional) Determines whether you can use the EXEMPT command to negate this statement dynamically. Specify one of these values on the PERMANENT parameter:

NO

Indicates that this statement is not permanent. You can use the EXEMPT command to negate it.

YES

Indicates that this statement is permanent and you cannot negate it.

Default: PERMANENT=NO

QNAME

Tells GDIF to use this GLOBAL statement only when the QNAME on the ENQ request matches the QNAME specified in place of the qname variable. You can use the pound (#) wildcard character to match more than one QNAME with this statement.

RESERVES

Indicates whether GDIF should change the way it handles hardware reserves for this resource. The value you specify here overrides the values you specified on a QNAME or GDIINIT statement. Specify one of these values on the RESERVES parameter:

CONVERT

Specifies that GDIF should eliminate the hardware reserve.

KEEP

Specifies that GDIF should retain the hardware reserve.

WARNING! Specifying RESERVES=KEEP on a GLOBAL Statement can cause deadlocks and is not recommended.

RNAME

Indicates that GDIF should propagate ENQ requests for the resource with the RNAME specified in place of the rname variable. You can use the asterisk (*), pound (#), and question mark (?) wildcard characters to match more than one RNAME.

The RNAME has a maximum length of 255.

Note: If you place a * before the end of the RNAME, it is replaced by a # (single character).

Usage Notes: GLOBAL Statement

• The GLOBAL statement can be specified only in the GDIEXMPT member of the MIMPARMS data set.
• You can specify more than one GLOBAL statement in the GDIEXMPT member.
• You can specify a QNAME or RNAME in either character or hexadecimal format. For example, you can specify QNAME=A123 or QNAME=X'C1F1F2F3'. If you use character format and the QNAME or RNAME contains embedded blanks, then enclose that QNAME or RNAME in single quotation marks.

Examples: GLOBAL Statement

• To propagate ENQ requests and retain hardware reserves for the SYS1.PROCLIB data set, specify this statement in the GDIEXMPT member:

  GLOBAL RNAME=SYS1.PROCLIB RESERVES=KEEP
  

• To propagate ENQ requests for the SYS1.PROCLIB data set only if the QNAME on the ENQ request is SYSDSN, specify this statement in the GDIEXMPT member:

  GLOBAL RNAME=SYS1.PROCLIB QNAME=SYSDSN
  

• To propagate ENQ requests for jobs that have names starting with the letters HWT, specify this statement in the GDIEXMPT member:

  GLOBAL JOB=HWT*