RESTORE/RECOVER › RESTORE Command Syntax › Parameters for VSAM Data Components Without DEFER

Parameters for VSAM Data Components Without DEFER

Specify one or more of the following parameters only if you want to change a particular value for the cluster from that which is found on the archive medium. If a value is given at both the cluster and component level (for example, ALLOC= and DALLOC=), the value specified at the data or index level will take precedence over the cluster value, just as IDCAMS does when you issue a DEFINE. See the IBM publication Access Method Services Reference for a more complete description of the following parameters.

DNAME=

This parameter specifies a new data component name. You can specify either an explicit data set name, or a symbolic name that starts with a "$". A "$" instructs CA Disk to use the cluster name as a base name, and to append to it the string following the "$". A second "$" causes the string ".DATA" to be appended to the cluster name.

For example with a cluster name of VSAM.CLUSTER:

• If DNAME=VSAM.CLSTR.DATA.COMP, the data component name will be VSAM.CLSTR.DATA.COMP.
• If DNAME=$$, the data component name will be VSAM.CLUSTER.DATA.
• If DNAME=$.DATA.COMP, the data component name will be VSAM.CLUSTER.DATA.COMP.
• If DNAME=$DATA.COMP, the data component name will be VSAM.CLUSTER.DATA.COMP.

DALLOC=

This parameter allocates space for the data component by type, primary amount and secondary amount. The format is DALLOC=(TYP,PA,SA).

Where:

TYP CYL (cylinders), TRK (tracks), or REC (records)

PA Primary allocation amount — must be from 1 to 99999999

SA Secondary allocation amount — must be from 0 to 99999999

Note: CA Disk will specify the values you request, but IBM's catalog management can change it and give absolutely no warning that it has done so. Combinations of attributes that it does not like usually cause this.

DCISZ=

Specify the size of the control interval in the data component. The largest CI size is 32768. If this parameter is specified and BUFFERSPACE is not, CA Disk will zero out the buffer space value passed to catalog management so that a new buffer space amount can be calculated, based on the new control interval size. If a value of 0 is specified, Access Method Services will calculate a new control interval size.

Caution should be used when restoring an ESDS cluster that belongs to IMS or CICS—changing the CI size on these clusters can destroy internal RBA pointers and cause corruption of the database.

DMASTERPW=

Specify the new master level password of the data component.

DCONTROLPW=

Specify the new control interval level password of the data component.

DUPDATEPW=

Specify the new update level password of the data component.

DREADPW=

Specify the new read level password of the data component.

DATTEMPTS=

Specify the number of attempts (0 to 7) for entering a password for the data component.

DOWNER=

Specify the new owner ID of the data component. It is 1 to 8 alphanumeric or special characters.

DSHROPTIONS=

Specify how the data component can be shared among users. The format is DSHROPTIONS=(CR,CS).

Where:

CR Cross-region options are 1 through 4

CS Cross-system options are 3 through 4

DVOLSERS=

Specify a list of from one to twenty volumes on which the data component is to be allocated. Non-MVS accounts are limited to a total of five volumes.

DORDER

This parameter indicates the volume(s) are to be used in the order listed.

DUNORDER

This parameter indicates the volume(s) are to be used in any order.

DWRITECHK

This parameter indicates a check is to be issued after every write.

DNOWRITECHK

This parameter indicates a check is not to be issued after every write.