Statements and parameters for GRSRNLxx

QNAME(name): Specifies the major name of the resource.

RNAME(name): Specifies the minor name of the resource.

RNL  {(INCL)}
     {(EXCL)}
     {(CON) }

Specifies the RNL in which the resource name entry is to be placed.

CON: Indicates the RESERVE conversion RNL.
EXCL: Indicates the SYSTEMS exclusion RNL.
INCL: Indicates the SYSTEM inclusion RNL.

The RNLs on all systems in the complex must be the same. Every RNL on each system must contain the same resource name entries, and that these resource name entries must appear in the same order.

TYPE   {(GENERIC) }
       {(SPECIFIC)}
       {(PATTERN)}

Specifies the type of resource name entry that is being defined in the RNL.

GENERIC

Indicates that this entry may match multiple resources. End of change

If RNAME is omitted, this entry matches a resource with the specified QNAME and any RNAME.
If RNAME is provided, this entry matches a resource with the specified QNAME and an RNAME that is either the same as the provided RNAME or begins with the provided RNAME.
QNAME must match exactly.

There is an equivalent TYPE(PATTERN) RNL definition for a TYPE(GENERIC) RNL definition. End of change

TYPE(GENERIC) QNAME(q) with RNAME omitted is equivalent to TYPE(PATTERN) QNAME(q) RNAME(*).
TYPE(GENERIC) QNAME(q) RNAME(r) is equivalent to TYPE(PATTERN) QNAME(q) RNAME(r*).

Processing of TYPE(GENERIC) RNL entries is a little faster than processing the equivalent TYPE(PATTERN) RNL entries. End of change

PATTERN

Indicates that the resource name in the RNL entry is a pattern that must fit the resource name that is specified on the ENQ request. You can use wildcard characters (* or ?) in either part of the resource name.

*: Allows matching for a substring of any characters for any length, including zero.
?: Allows matching for any single character.

For example:

RNLDEF RNL(EXCL) TYPE(PATTERN)
QNAME(SYSDSN)
RNAME(SYS1.*.PARMLIB)

You can convert all hardware RESERVEs to global ENQ with the following specification:

RNLDEF RNL(CON) TYPE(PATTERN)
QNAME(*)

Note: This is recommended only on systems that are using GRS Star.

SPECIFIC

Specify a QNAME (major name) and an RNAME (minor name) for the resource.