Editing a copy request

Edit online

You can edit copy requests that have the appropriate statuses from the Tape Optimizer interface.

About this task

To be editable, a copy request must have one of the following statuses:

  • PEND START – A request that has never been started.
  • BUILDCOPY – A request that is in phase 1 of copy processing (tape selection). You can edit a request that has this status only if it has actually terminated. A request can terminate with this status if Tape Optimizer finds no tapes to copy or is performing a trial run. You cannot edit a BUILDCOPY request if it is currently running.
  • ACTIVE – A started copy request that is in phase 2 of copy processing (copying tapes). You can edit a request that has this status only if it has actually terminated. You cannot edit an ACTIVE request if it is currently running.
  • PEND RSTRT – A request that has stopped and is awaiting restart.
  • TEMPLATE – A request that is retained for use by the Tivoli Enterprise Portal (TEP) for TakeActions job submission.
Restriction: You cannot edit a copy request that has the status PEND COMP (a request that has completed).
Restriction: You cannot edit a copy request that has the status TEMPLATE. You cannot change a copy request that has a status of TEMPLATE to another status such as ACTIVE or PEND RSTRT.

For example, you might want to edit an ACTIVE or PEND RSTRT copy request that has stopped because of a tape copy error. You can exclude the problematic tape and then resubmit the copy request. The request will resume copying from the point at which it left off.

You cannot edit all parameters for ACTIVE and PEND RESTRT copy requests that have stopped. For example, you cannot select additional tapes for copying, disable tape stacking, or switch to performing a trial run.

Editing a copy request from the Tape Optimizer interface is preferable to directly editing the JCL for a copy request from the ISPF editor. If you directly edit the JCL, you will not receive feedback about any invalid values that you enter. Also, you will need to save the edited JCL to another file; otherwise, your changes will be overwritten the next time you select the copy request from the Tape Optimizer interface.

To edit a copy request:

Procedure

  1. From the Tape Optimizer Primary Menu, choose option 2 (Copy Requests).
    The Copy Requests panel opens.
  2. In the list at the bottom of the panel, select one or more copy requests that you want to edit by typing a forward slash (/) in the Sel column next to each one and pressing Enter.
    The Request Action window opens, as shown in the following figure:
    Figure 1. Request Action window
    +-----------------------------------------------------------+
|    IBM Tivoli Tape Optimizer on z/OS - Request Action     |
|                                                           |
| OPTION => ______________________________________________  |
|                                                           |
| Select an action for request - 00002                      |
|                                                           |
| 1. Submit the copy request                                |
| 2. Edit the request                                       |
| 3. Delete the request                                     |
|                                                           |
| Enter END to return.                                      |
+-----------------------------------------------------------+
  3. Choose option 2 (Edit the request).
    The Create/Edit Request panel opens and displays the existing information for the copy request from the Request Database, for example:
       Menu      Filters      Options      Help
 ------------------------------------------------------------------------------
      IBM Tivoli Tape Optimizer on z/OS - Create/Edit Request - 00002
 COMMAND ===> __________________________________________________________________

 Specify a tape unit name or storage class (STORCLAS):
   Input Tape Esoteric or Generic Unit Name . . . . . . . . . INCART__ 
   Input Tape SMS Storage Class . . . . . . . . . . . . . . . ________ 

   Output Tape Esoteric or Generic Unit Name. . . . . . . . . OUTCART_ 
   Output Tape SMS Storage Class. . . . . . . . . . . . . . . ________ 
   Output Tape SMS Data Class.. . . . . . . . . . . . . . . . ________
   Output Tape SMS Special Expiration Date. . . . . . . . . . ________

 Stack Input Tape Volumes on Output Tapes . . . . . . . . . . _  "/" to Select

 Enter END to continue or CANCEL to return without saving. 
 
 Specify a list of single TAPE VOLSERs or TAPE VOLSER ranges to be copied.

          - Starting VOLSER -   - Ending VOLSER - 
               C50073                ______ 
               CS*___                ______ 
               ______                ______
               ______                ______
               ______                ______ 
 ******************************* Bottom of data ********************************
  4. Edit any of the following information, as needed:
    • The input and output tape units, SMS storage classes, SMS data classes, or SMS expiration dates.
    • The Stack Input Tape Volumes on Output Tapes option (unless the copy request has the status ACTIVE or PEND RSTRT)
    • The list of volume serial numbers or data set names

    You also can add, change, or delete values for copy options and filtering criteria by using the Filters and Options pull-down menus. If you need assistance, press F1 for online Help or refer to the detailed procedures on filtering and setting copy options.

  5. When you are finished, press F3 (End) to save your changes.
    The JCL for the copy request is displayed and includes your latest changes.
  6. Press F3 (Exit).
  7. If the Request Action window is redisplayed (because you selected multiple copy requests), repeat steps 3 through 6 for each copy request that you want to edit.

Results

When you are finished, the Copy Requests panel is redisplayed.