Specifying criteria for renaming tape data sets

Edit online

You can specify criteria for renaming tape data sets as they are copied to output tapes.

About this task

Before you do so, review the topic Criteria for renaming tape data sets. This topic explains how to specify renaming criteria, including the use of wildcards, and provides examples.

To specify criteria for renaming tape data sets:

Procedure

  1. From the Tape Optimizer Primary Menu, choose option 2 (Copy Requests).
    The Copy Requests panel opens.
  2. Perform one of the following actions:
    • If you are defining a new copy request, type a forward slash (/) next to the Create a new tape copy request by VOLSER field or the Create a new tape copy request by data set name or mask field, and press Enter.
    • If you are editing a pending copy request, type a forward slash (/) in the Sel column next to the request, and press Enter.
    The Create/Edit Request panel opens.
  3. From the Options pull-down menu, choose option 3 (Rename Options).
    The Copy Request Data Set Rename window opens, as shown in the following figure:
    Figure 1. Copy Request Data Set Rename pop-up window
    +-----------------------------------------------------------------------------+
|     IBM Tivoli Tape Optimizer on z/OS - Copy Request Data Set Rename        |
| COMMAND => ___________________________________________________________      |
|  Type "/" to Select                                                         |
|   / Recatalog the New Data Set Name if already cataloged.                   |
|                                                                             |
| Enter END to save changes or CANCEL to return without saving.               |
|                                                                             |
| Specify From and To pairs that are to be renamed.                           |
|      From: ____________________________________________                     |
|      To  : ____________________________________________                     |
| ----------------------------------------------------------------------      |
|      From: ____________________________________________                     |
|      To  : ____________________________________________                     |
| ----------------------------------------------------------------------      |
|      From: ____________________________________________                     |
|      To  : ____________________________________________                     |
| ----------------------------------------------------------------------      |
|      From: ____________________________________________                     |
|      To  : ____________________________________________                     |
| ----------------------------------------------------------------------      |
|      From: ____________________________________________                     |
|      To  : ____________________________________________                     |
+-----------------------------------------------------------------------------+
  4. In the Recatalog the new data set name if already cataloged field, type a forward slash (/) if you want Tape Optimizer to record the renamed data sets that are on the output tapes in the system catalog even though they were already cataloged to the input tapes.
    If you do so, both the original data set names and the new data set names will appear in the catalog.

    This option is ignored if you select the Copy tape without recataloging option in the Copy Options pop-up window.

  5. Specify pairs of "From" and "To" values as criteria for renaming tape data sets.
    You can specify as many pairs, as needed.
    1. In the From field, type a mask that you want Tape Optimizer to match against existing input data set names to identify the data sets to rename.
      In the mask, you can include one or more data-set-name qualifiers, the asterisk (*) wildcard, the percent sign (%) wildcard, or a combination thereof. This value can be up to 44 characters in length. If you specify the asterisk (*) wildcard, also specify one or more qualifiers that occur in the input data set names. You can place the asterisk (*) at the beginning or end of the mask or in both locations. If the asterisk (*) is at the beginning, the mask will match the data set names that contain the qualifier value anywhere within them. To use the percent sign (%) wildcard, specify the percent sign (%) by itself or with a trailing qualifier value (a specific qualifier string or a mask that includes the asterisk wildcard). If you specify only the percent sign (%), all input data sets will be renamed through an append operation. If you specify the percent sign (%) with a qualifier value, only the input data set names that match the qualifier value will be renamed.
      Restriction: Tape Optimizer does not rename generation data sets that have a relative generation number in their names. Do not specify a relative generation number in a From field.
    2. In the corresponding To field, specify criteria for generating new data set names.
      This value can be up to 44 characters in length. If you are performing a "find and replace" type of renaming operation (that is, you specified the asterisk (*) wildcard with a qualifier value in the From field), type the qualifier string that is to replace the existing qualifier string that is specified in the From field. If you are performing an "append" type of renaming operation (that is, you specified the percent sign (%) wildcard in the From field), type the percent sign (%) either followed by the qualifier string that you want to add to the end of the data set names or preceded by the qualifier string that you want to add to the beginning of the data set names.
  6. Press F3 (End) to save your entries.

Results

When you run the copy request, Tape Optimizer will use the specified renaming criteria to rename the tape data sets.