INIT CXX/FXX/IXX/LXX/WXX/Data Area › INIT LXX (Format Log Area) › How to Use

How to Use

Execute the INIT function with the following command format:

►►─ INIT AREA=LXX,BLKSIZE=nnnnnn ─┬─────────────┬─┬─────────────────┬──►
                                  └─ ,BLOCKS=n ─┘ └─ ,TSN=xxxxxxxx ─┘

 ►─┬─────────────────────────┬──┬──────────────┬──────────────────────►◄
   └─ ,VARIABLE= ─┬─ NO ◄ ─┬─┘  └─ ,VOLUMES=n ─┘
                  └─ YES ──┘

Command

INIT

Invokes the function to format areas for CA Datacom/DB use.

Required Keywords

AREA=LXX

Identifies the area to be formatted as the Log Area.

,BLKSIZE=

Must be set as 32760. In the special case where you have the requirement to initialize a Log Area (LXX) with Version 15.0 for use by a Version 14.0 MUF, select the values for the BLKSIZE= and BLOCKS= keywords based upon your CA Datacom Version 14.0 documentation.

Valid Entries:

16384-32760

Default Value:

(No default)

Optional Keywords

,BLOCKS=

For spanned logging, specifies the number of physical blocks per logical block. BLOCKS= may not be 2 or 3 if the LXX is variable. Do not specify when VARIABLE=YES has been set.

Valid Entries:

An integer from 1 to 3

Default Value:

1

,TSN=

Specifies the starting number for transaction sequence numbers (TSNs).

If you are running with more than one MUF against the same data areas, you should specify a different starting sequence number for each MUF to ensure that the sequence numbers are not duplicated.

The DBUTLTY REPORT AREA=LXX and RESTART reports print the highest TSN previously used.

Valid Entries:

A hexadecimal value from 00000000 to FFFFFFFF

Default Value:

00000000

,VARIABLE=

Specifies whether you want to use the variable Log Area (LXX) block size feature (for details see Variable Log Area (LXX) Block Size). Specify YES to use the feature. NO is the default. We recommend VARIABLE=YES.

Valid Entries:

YES or NO

Default Value:

NO

,VOLUMES=n

(z/OS only)The n in VOLUMES=n is the maximum number of volumes to initialize. Without the VOLUMES= option, the number of volumes having specific VOLSER information is initialized. The VOLUMES= option allows more volumes to be catalogued as part of the data set and available to an EXTEND or dynamic EXTEND, while being effectively held in reserve without a specific allocation.

For example, you could specify VOLUMES=3 when using an INIT to initialize an area that needs 3 volumes, intending to only initialize the space on 3 volumes. But the JCL could specify 6 specific volumes, for example:

VOL=SER=(VOL001,VOL002,VOL003,VOL004,VOL005,VOL006)

In this example, volumes 4/5/6 are not allocated or used during the INIT but are available to a dynamic extend. In this case, the extra volumes would not need to be removed before another INIT.

Valid Entries:

the number n of volumes to be catalogued

Default Value:

(No Default)