SMHSMUTL—DFSMShsm control data set batch utility

The SMHSMUTL batch program reads DFSMShsm migration and backup control data sets, selects data set entries (based on your specifications), and generates TSO DFSMShsm commands to delete migration and backup entries and associated data sets.

You can select data sets for deletion based on data set name (full name or name mask), MainView SRM pool membership, or any of four aging criteria, with or without non-working day adjustment by the MainView SRM calendar.

Member JCLHSMUT in ?prefix.BBSAMP contains sample JCL for SMHSMUTL. SMHSMUTL keywords are as follows:

 SMHSMUTL keywords

Parameter

Purpose

Syntax

DELETE

Identifies a new specification

This must be the first operand on a control card set for SMHSMUTL. Each DELETE keyword starts a new specification.

DELETE

BAKDAYS

Specifies the age (number of days since last backup) at which the backup data set (and BCDS entry) is deleted

This parameter is required if CDS=BCDS. This parameter is not allowed if CDS=MCDS or CDS=BOTH.

See also the KEEPBACKV parameter.

BAKDAYS=nnnn

The variable nnnn is a number in the range 0-9999.

CAL

Specifies whether the DFSMShsm management class migration days value should be adjusted to account for the non-working days in the MainView SRM calendar

CAL=YES|NO

CDS

Specifies the type of DFSMShsm control data set to be affected

This parameter is required.

CDS=xxxx

The variable xxxx is a value as follows:

  • BCDS-backup control data set

  • MCDS-migration control data set

  • BOTH-backup and migration control data sets

CREDAYS

Specifies the age (number of days since creation of the original pre-migration data set) at which the migrated data set (and MCDS entry) is deleted

If CDS=MCDS or CDS=BOTH, one of the following parameters must be specified: CREDAYS, MIGDAYS, REFDAYS.

If CDS=BCDS, this parameter is not allowed.

CREDAYS=nnnn

The variable nnnn is a number in the range 0-9999.

DSN

Specifies a data set name or name mask. All MainView SRM name masking parameters can be used

This parameter is required.

DSN=xxxxxxxx. . . .

The variable xxxxxxxx specifies a data set name up to 44 characters.

KEEPBACKV

Specifies the number of backup versions of a data set that should be kept

If not specified, all backup copies are deleted. Use this parameter only if CDS=BCDS.

KEEPBACKV=nnnn

The variable nnnn is a number in the range 0-255.

MIGDAYS

Specifies the age (number of days since migration of the data set) at which the migrated data set (and MCDS entry) is deleted

If CDS=MCDS or CDS=BOTH, one of the following parameters must be specified: CREDAYS, MIGDAYS, REFDAYS.

If CDS=BCDS, this parameter is not allowed.

MIGDAYS=nnnn

The variable nnnn is a number in the range 0-9999.

POOL

Specifies the name of a single MainView SRM pool

  • Name masking cannot be used.

  • If you specify the POOL parameter, only data sets from the specified pool are selected. This parameter is optional.

  • If you do not specify the POOL parameter, data sets are selected for processing without regard to pool membership.

POOL=xxxxxxxx

The variable xxxxxxxx is a pool name from the SMPOOL xx member.

REFDAYS

Specifies the age (number of days since the original pre-migration data set was last referenced) at which the migrated data set (and MCDS entry) is deleted

  • If CDS=MCDS or CDS=BOTH, one of the following parameters must be specified: CREDAYS, MIGDAYS, REFDAYS.

  • If CDS=BCDS, this parameter is not allowed.

REFDAYS=nnnn

The variable nnnn is a number in the range 0-9999.

Was this page helpful? Yes No Submitting... Thank you

Comments