Preparing to upgrade Cloud Data Sets from version 3.3.00

You must complete the following tasks before upgrading Cloud Data Sets (CDSs).

To allocate a larger z/OS volume catalog

While CDS version 3.x.xx required approximately 60,000 tape VOLSERS, CDS version 4.0.01 requires approximately 243,000 tape VOLSERs. You must delete the previously allocated VOLCAT, reallocate a larger one, and redefine the VOLSERs to accommodate additional tapes.

Warning

During this process, CDS jobs fail. This process might take approximately 30 minutes.

Delete the old catalog

//DELETE   EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
DELETE <catalog_name> -
        PURGE FORCE USERCATALOG
/*

Important

The delete job issues a WTOR and does not complete until you reply.

Define the new catalog

In the following example of defining a VOLCAT for BMC AMI Cloud CDS tape volumes, replace the x with the starting character of the volume entries. For example, for volumes starting with MAxxxx, the VOLCAT should be hlq.VOLCAT.VM.

hlq should match the hlq of hlq.VOLCAT.VGENERAL. For more information about VOLCAT naming conventions, see "Defining Names for a Tape Volume Catalog" in the IBM documentation.

Best practice
The recommended size of the volume catalog is 1,000 cylinders to allow for future growth. The minimal size of the volume catalog is 450 cylinders.

//DEFVCAT JOB ...
//STEP1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=A
//SYSIN DD *
DEFINE USERCATALOG -
(NAME(hlq.VOLCAT.Vx) -
VOLCATALOG -
VOLUME(volser) -
CYLINDERS(1000 0))
/*

To redefine dummy tape volumes

Important

You must use the job provided with the version 4.0.01 installation.

Use CDSVLENJ to define the volume entries. Supply the volume prefix (PREFIX) and tape library (MTLNAME) defined in the previous steps.

Make sure that the first letter of the prefix matches the last letter of the specific VOLCAT defined in the previous steps.

For example, if you selected MA for volume prefix and M9MTL for the tape library, then use the following script:

// SET PREFIX=MA
// SET MTLNAME=M9MTL
// SET STARTALI=''
// SET STARTVER=''

The script defines volume entries 'MAAA00' up to 'MAZZ9Z'. The volume names are in this format ppaavv:

pp—2 alphabetical characters representing the volume prefix
aa—2 alphabetical characters representing the alias
vv—2 alphanumeric characters representing the version

Use the following parameters to start the script at a customized point:

STARTALI (start alias)—Defines the starting alias point for the script. For example, STARTALI='BB' sets the script to define volumes from 'MABB00' to 'MAZZ9Z'.
STARTVER (start version)—Defines the starting version point for the script. For example, STARTALI='BB'; STARTVER='77' sets the script to define volumes from 'MABB77' to 'MAZZ9Z'. Version '77' is used once. After reaching volume 'MABB9Z', the script defines 'MABC00', that is version '00' (the default starting point).

To upgrade CDS

See Performing the Cloud Data Sets upgrade from version 3.3.00.