CARTS-DS Disk Stacker is an optional CARTS component that migrates sequential datasets from disk and stacks them to tape. It selects datasets to be off-loaded to tape based on their name, SMS characteristics, and residency time on disk.
A separate Disk Stacker Control file includes parameters that specify how datasets are migrated from disk to tape. In addition, some Disk Stacker processing is controlled by statements set within the CARTSDS job.
Editing the Disk Stacker Control File
The Disk Stacker Control file is modified with the same screens used to edit the CARTS-TS
Control file. Refer to “ Changing Stacking Conditions” on page 28 for information about
changing Control file parameters with these screens.
1. Access the CARTS Main Menu and select a Disk Stacker Control file.
If the Disk Stacker Control file is not listed, add it to the list, and then select it. The name of the Control file is listed on the Disk Stacker IVP report.
2. Update the values set from the menu options of the Rules menu.
The following list shows recommendations for the Disk Stacker Control file.
• Carefully change option fields of the Dataset Names screen. Disk Stacker off-loads all
files that meet your include criteria. Include only the names of those datasets you want off-loaded. Exclude all other datasets with a statement like the following:
EXC *
Do not prepare a Disk Stacker Control file with a single exclude statement that only excludes a portion of the datasets available on the target disks. Using this Control file parameter, Disk Stacker could potentially off-load most or all of your disk files because all of the remaining datasets are included in the stacking by default.
• Leave the VOLSER Ranges at the maximum possible: AAAAAA to 999999.
3. Edit the JCL shown on the Job Cards screen to submit Disk Stacker jobs rather than CARTS-TS jobs.
4. Save your changes to the Control file.
Using a New Control File
The DSCNTL parameter of the CARTSDS procedure specifies the Disk Stacker Control file. Edit CARTSDS and include the dataset name of the Control file you want to use with Disk Stacker. CARTSDS is a member of the CARTS JCLLIB dataset.
To create new Control files, make copies of existing Disk Stacker Control files and catalog them.
Preparing the CARTSDS Procedure
CARTS TMS User Guide ▼ 105
Preparing the CARTSDS Procedure
The CARTSDS procedure was configured initially when Disk Stacker was installed. However, you must update CARTSDS parameters to select the candidate disk volumes, dataset residency requirements on disk, and their retention on tape after they are stacked.
You can select candidate disk volumes by their volume serial or their SMS characteristics. The following procedure shows both methods. If you wish to select volumes by their volume serial, leave the SMSPARMS parameter blank and complete steps 3 and 4 of the procedure. Complete the SMSPARMS parameter and omit steps 3 and 4 if you want to select volumes by their SMS characteristics.
1. Edit the CARTSDS member of the CARTS JCLLIB dataset. 2. Change the following parameters of the CARTSDS procedure:
AGE Minimum number of days that datasets must remain on disk after their
creation date. This number can range from 0 to 99999. Disk Stacker bypasses all datasets this number of days or less. For example, if you specify AGE=50, Disk Stacker bypasses all datasets 50 days old or less. Only datasets 51 days or older are off-loaded.
KEEPFOR {020|nnn|CATL|PERM}
nnn Number of days retention for all off-loaded datasets.
This number can range from 1 to 99999. For example, if you specify KEEPFOR=30, all off-loaded datasets will be retained 30 days after they are off-loaded. The default is 020.
CATL Disk datasets are stacked on tape and retained
according to TMS catalog control expiration.
PERM Disk datasets are stacked on tape and retained by
permanent expiration date.
If a disk file has an expiration date set in the VTOC, this expiration date supersedes the KEEPFOR value.
SMSPARMS={'MANAGEMENT=class|,STORAGE=class|,DATA=class'}
Optional parameter to select disk datasets for stacking by their SMS characteristics. Datasets that meet all SMS selection criteria are stacked to tape by Disk Stacker.
CARTSDS selects disk datasets for stacking based solely on their SMS characteristics if the SMSPARMS parameter is included. When
SMSPARMS is included, CARTSDS does not use DD volume statements to select volumes whose datasets can be stacked, as shown in Step 4 of this procedure.
Up to three SMS class sub-parameters can be included with
SMSPARMS. Each sub-parameter must be separated by a comma. All sub-parameters are enclosed within a single set of quotes.
MANAGEMENT1-30 character alphanumeric string that identifies disk
datasets by their SMS management class.
STORAGE 1-30 character alphanumeric string that identifies datasets by their SMS storage class.
DATA 1-30 character alphanumeric string that identifies disk datasets by SMS data class.
If SMSPARMS is specified with multiple sub-parameters, datasets are selected on the basis of a Boolean AND operation. A dataset must meet all specified SMS criteria to be selected for stacking.
Examples of SMSPARMS Usage
• SMSPARMS='MANAGEMENT=TEMP'
Only disk datasets belonging to the TEMP SMS management class can be stacked to tape by Disk Stacker.
• SMSPARMS='MANAGEMENT=TEMP,STORAGE=STANDARD'
Only datasets belonging to both the SMS TEMP management class and the STANDARD storage class can be stacked to tape by Disk Stacker.
The remaining two steps of this procedure can be omitted if you included the SMSPARMS parameter to select the target datasets. Complete steps 3 and 4 if you want to select datasets from target DASD volumes identified by their volser instead of their SMS characteristics.
3. Find the ddname DDVOL1 statement within CARTSDS.
4. Include the volsers of all DASD volumes whose datasets you want stacked to tape by Disk Stacker.
A separate DD statement must be included for each DASD volume. Add as many DD statements as required.
DDVOL1 DD UNIT=SYSDA,VOL=SER=MVS345,DISP=SHR DDVOL2 DD UNIT=SYSDA,VOL=SER=MVS154,DISP=SHR DDVOL3 DD UNIT=SYSDA,VOL=SER=MVS234,DISP=SHR
Some names are reserved and cannot be specified as DD names. Do not include the following DD names:
JOBLIB SYSUDUMP
SYSABEND SYSOUT
SYSIN SYSPRINT
STEPLIB VTOCLIST
Running Disk Stacker
Execute the CARTSDS procedure of the CARTS JCLLIB dataset to run Disk Stacker. CARTSDS generates JCL to off-load qualifying disk datasets to tape similar to the CARTS-TS procedure. The job is sent directly to JES for execution.
CARTS TMS User Guide ▼ 107