Generic entrynames

RESTORING › Optional Statement: Cluster Names › Generic entrynames

Generic entrynames

A generic entryname is composed of select and skip characters. The following table explains how to read the generic entrynames:

Example	Explanation
CLUSTER=AP++++C	Skip characters are represented by a plus sign (+) and do not take part in the compare process. This example includes these clusters: CLUSTER=AP1000C CLUSTER=AP2145C
CLUSTER=++C	Generic names can be padded to the right with plus signs (+) up to 44 bytes, so that names of unequal lengths compare equally. This example includes these clusters: CLUSTER=ABC CLUSTER=ABCDE

Optional Parameters

Other than CLUSTER, the cluster name statement can include the following optional parameters:

CLUSTER

►►─ CLUSTER ─┬────────────────┬─┬──────────┬──────────────────────────────────►
             └─ /*Comments*/ ─┘ └─ ADDHLQ ─┘

 ►─┬─────────────────────────────┬────────────────────────────────────────────►
   └─ DBD=dbdname ─ DDN=ddnname ─┘

 ►─┬─────────────────────────────────────┬─┬─────────────────────┬────────────►
   └─ DEFINED DDNAME=ddnname(/password) ─┘ └─ DISP= ─┬─ SHR ◄ ─┬─┘
                                                     └─ OLD ───┘

 ►─┬────────────────────┬─┬──────────┬─┬───────────┬──────────────────────────►
   └─ EXCLUDEentryname ─┘ └─ NODATA ─┘ ├─ PRIME ───┤
                                       └─ NOPRIME ─┘

 ►─┬────────────────────────┬─┬────────────────────┬─┬─────────────┬──────────►
   └─ REUSE DDNAME=ddnname ─┘ └─ UEXIT=membername ─┘ └─ XTNDOFF=n ─┘

 ►─┬────────┬─┬───────────────┬───────────────────────────────────────────────►◄
   └─ *AMS ─┘ └─ parameter() ─┘

Usage Rules

The following usage rules apply to cluster name statements:

Any number of cluster name statements can be included after a RESTORE method.
The auto-define process may be bypassed and the restore directed to a previously defined or reusable cluster or alternate index.
Whenever the name or master password of a base cluster is changed using the *AMS parameter, all associated alternate indexes and paths reflect the change. Do not alter PATHENTRY and RELATE.
When using *AMS overrides for alternate indexes and paths, the cluster statement must be specified as:
- CLUSTER= (or CL=) name of cluster to be restored
- AIX=name of alternate index to be restored
- PATH=name of path to be restored
Cluster records can be processed from a restore.
Clusters can be restored by a user exit.
A cluster name statement can be continued by coding a hyphen (-) as the last nonblank character on the statement:
```
   CL=entryname
   REUSE -
   DDNAME=ddname

   CL=entryname
   UEXIT=exit
   *AMS -
   ...AMS input ...
```