LOAD (Build CXX or Data Area) › LOAD CXX (Build CXX) › How to Use

How to Use

Multi-User mode is required to execute this command. Prior to version 12.0, either Single User mode or Multi-User mode could be used, but the LOAD function with AREA=CXX that uses a DBID is now executable in Multi-User mode only. This requirement prevents the execution of the function with the database open. It also ensures that the MUF is always in control and has knowledge of all information in the CXX to a CXX.

Execute the LOAD function using the following command format:

►►─ LOAD AREA=CXX,DEVICE= ─┬─ DISK ─┬─ ,DTFNAME=d ────────────────────────────►
                           ├─ TAPE ─┤
                           └─ Snnn ─┘

 ►─┬────────────────────────────┬─┬──────────────────────┬────────────────────►
   └─ ,DBID=n ─┬──────────────┬─┘ └─ ,REWIND= ─┬─ NO ──┬─┘
               └─ ,NEWDBID=n ─┘                └─ YES ─┘

 ►─┬───────────────────────┬──────────────────────────────────────────────────►◄
   └─ ,LABEL= ─┬─ YES ◄ ─┬─┘
               └─ NO ────┘

Command

LOAD

Invokes the function to build or restore an area.

Required Keywords

AREA=CXX

Identifies the area to be loaded as the Directory.

,DEVICE=

Specifies the device type for the input data set.

If DEVICE=TAPE is specified, the system logical unit (SYS) number must be 5 (SYS005).

Use the Snnn entry to specify a specific SYS number (for tape only).

Valid Entries:

DISK, TAPE, Snnn (Certain values from previous versions are still accepted but are treated as DISK.)

Default Value:

(No default)

,DTFNAME=

Specifies the z/VSE JCL TLBL/DLBL name for the input data set. If DEVICE=TAPE, this name must match the name which you code in your z/VSE JCL TLBL statement. If not, this name must match the name you code in your z/VSE JCL DLBL statement.

Valid Entries:

Any name valid to z/VSE JCL specifications

Default Value:

(No default)

Optional Keywords

,DBID=

Identifies the database selected for loading a specific database to the Directory.

Valid Entries:

DATACOM-ID of the database

Default Value:

(No default)

,LABEL=

If DEVICE=TAPE (either TAPE or the Snnn form), specifies whether tape labels are processed. We recommend that you always use labeled tapes.

Note: LABEL= has no effect when DEVICE=DISK.

Valid Entries:

NO or YES

Default Value:

YES

,NEWDBID=

Specifies a new DBID for the data to be loaded.

Note: Do not use this parameter for databases accessed by SQL or CA Dataquery. These products must have the correct DBID to reference additional information from CA Datacom/DB about the production database. If the NEWDBID= parameter is used for a database accessed by CA Ideal, the corresponding ASSIGN DBID or ALTER DBID command must be run before running the application. See CA Ideal documentation for details.

Valid Entries:

Valid DATACOM-ID for a database

Default Value:

(No default)

REWIND=

If DEVICE=TAPE (either TAPE or the Snnn form), YES indicates that the tape is to be rewound before OPEN and after CLOSE. NO indicates no rewind before OPEN or after CLOSE. If omitted, the tape is rewound before the OPEN and rewound with unload after the CLOSE.

Note: REWIND= has no effect when DEVICE=DISK.

Valid Entries:

NO or YES

Default Value:

The tape is rewound before the OPEN and rewound with unload after the CLOSE.