CA MII Statements and Commands › (MII) LOCAL Statement-Manage Local ENQ Requests

(MII) LOCAL Statement-Manage Local ENQ Requests

The LOCAL statement lets you identify ENQ requests that should not be propagated by GDIF. You can use this statement to override values you specified on the DEFAULT and GLOBAL statements. The LOCAL statement is available only with the GDIF of the CA MII component.

Note: Local statements may not apply to RESERVE requests, depending on the value of the SETOPTION GDIF EXEMPTRESERVES command.

This command has the following format:

LOCAL {JOB=name} [PERMANENT={NO|YES}] | RNAME=rname [QNAME=qname]
                                                    [PERMANENT={NO|YES}]}

JOB

Indicates that GDIF should not 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 name with this statement.

PERMANENT

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 LOCAL statement only when the QNAME on the ENQ request matches this QNAME. Specify the QNAME in place of the qname variable. You can use the pound (#) wildcard character, which is described in Usage Information for EXEMPT, to match more than one QNAME with this statement.

RNAME

Indicates that GDIF should not 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, which are described in Usage Information for EXEMPT to match more than one RNAME with this statement.

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: LOCAL Statement

• The LOCAL statement can be specified only in the GDIEXMPT member of the MIMPARMS data set.
• You can specify more than one LOCAL 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.
• For more information, see the description of the SETOPTION GDIF Command.

Examples: LOCAL Statement

• To prevent GDIF from propagating ENQ requests for the SYS1.PROCLIB data set, specify this statement in the GDIEXMPT member:

  LOCAL RNAME=SYS1.PROCLIB
  

• To prevent GDIF from propagating ENQ requests for the SYS1.PROCLIB data set when the QNAME on the request is SYSDSN, specify this statement in the GDIEXMPT member:

  LOCAL RNAME=SYS1.PROCLIB QNAME=SYSDSN
  

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

  LOCAL JOB=HWT*