DATASETNAMEMASKn (DFSMSdss Copies)

Use this keyword to specify the input name mask and output name mask for the cloned datasets. BMC Database Director for IMS uses more than one method to create copies.

Method

Action by Database Director

Additional Information

DFSMSdss copy

Database Director uses this method when either of these conditions exist.

  • Database Director cannot find a licensed copy of FDR.
  • You specify the SET NOFDR command and keyword.

Supports concurrent copy technology

Fast Dump Restore (FDR)

Database Director uses this method as the default if it can find a licensed copy of FDR on your system.

Does not support concurrent copy technology

Use this keyword if you are using DFSMSdss. The dataset name masks are comprised of a pair of mask values:

  • The input name mask
  • The output name mask

You can specify up to 5 dataset name masks for different dataset names. For example, you can specify more than one mask because you are cloning a DBGROUP where there is more than one dataset name standard implemented.

The matching process will be based upon a first-fit criteria. The first mask that matches the input dataset name will be the mask used to create the output dataset name.

When you specify a dataset name mask:

  • Separate the names with a comma.
  • Do not use imbedded blanks.
  • If the input name mask and output name mask require more than 1 line, you must specify the plus sign (+) as the continuation character.

In the mask:

  • A single asterisk (*) represents a single node within a dataset name
  • Double asterisks (**) represent multiple nodes within a dataset name (You cannot begin the mask with double asterisks.)

The following is a valid example.

DATASETNAMEMASK1(PROD.**,TEST.**)

Syntax:

DATASETNAMEMASKn

Uses:

Required on the CLONE Command. You must specify a minimum of DATASETNAMEMASK1. For more information, see 'CLONE Command'.

Synonyms:

For:

  • DATASETNAMEMASK1, you can specify DATASETNAMEMASK, DSNMASK, and DSNMASK1.
  • DATASETNAMEMASKn, you can specify DSNMASKn (For example, for DATASENAMEMASK3, you specify DSNMASK3.)

Values:

Input name mask and output name mask separated by a comma.

Default Value:

None

Example

In the example, the first node of the dataset name is replaced by TEST.

CLONE DBD(dbdname)                  -
  DATASETNAMEMASK1(PROD.**,TEST.**)

The example shows a clone with more than one dataset name mask.

CLONE              -
DBD(dbdname)       -
DATASETNAMEMASK1(   +
   IMST.**,        +
   TEST.IMST.**    -
   )               -
DATASETNAMEMASK2(  +
   TEST.*,         +
   TEST.*.SYSB     -
   )               -

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*