IAM_copying and moving datasets or members

Users can copy or move the following:

  • PDS members to another PDS
  • Data from one sequential dataset or PDS member to another sequential dataset or PDS member
  • Data from a sequential dataset to a PDS
  • Data from a VSAM dataset to another VSAM dataset
  • Data from a IAM dataset to another IAM dataset
  • PDS, sequential, VSAM, or IAM datasets to the same z/OS host or a different z/OS host

To copy or move PDS members to another PDS

  1. Select the PDS members to copy or move.
  2. Copy or move the members by following one of these operations:
    • Right-click the selection and select Copy or Cut (move). Then right-click the target dataset and select Paste.
    • Press Ctrl+C (to copy) or Ctrl+X (to cut/move). Then select the target dataset and press Ctrl+V.
    • Drag the selection and drop it on the target dataset.
      The Copy or Move dialog box appears, listing the source and target members involved in the copy or move.
  3. If like-named members exist in the target dataset, in the Options box, select or clear the Replace existing like-named members check box.
  4. If File-AID is installed and the source host is at the correct PTF level, complete the Selection Criteria tab to use selection criteria. Refer to the File-AID/Eclipse User Guide for detailed information.
    Note: Datasets can only be copied when using selection criteria; they cannot be moved.
  5. Click Copy or Move. The status of each member copy or move appears in the Status column.
    • Hover over the Status column to get detailed information on the status. Alternatively, click Details to open the Details dialog box, which displays a summary of the results without the need to hover.
    • If any operations fail (for example, if the resource to move is in use), attempt to resolve the reason for the failure, then click Restart to try again. In certain circumstances, an opportunity is given to remove the successfully completed results before retrying the operation.

Note: If there are any differences in the format of the source and target datasets, a warning appears giving an option to proceed or cancel.

Note: Previous executions can be opened from the Event History view. Refer to Using Event History to View Results or Rerun a Copy or Move.


To copy or move data from one sequential dataset or PDS member to another sequential dataset or PDS member

  1. Select a sequential dataset or PDS member to copy or move.
  2. Copy or move the data by following one of these operations:
    • Right-click the selection and select Copy or Cut (move). Then right-click on the target dataset and select Paste.
    • Press Ctrl+C (to copy) or Ctrl+X (to cut/move). Then select the target dataset and press Ctrl+V.
    • Drag the selection and drop it on the target dataset.
      The Copy or Move dialog box appears, listing the source and target dataset involved in the copy or move.
  3. If the target dataset exists, in the Options box, select the option to either overwrite or append existing data.
  4. If File-AID is installed and the source host is at the correct PTF level, complete the Selection Criteria tab to use selection criteria. Refer to the Topaz Workbench File-AID/Eclipse User Guide for detailed information. Note: Datasets can only be copied when using selection criteria; they cannot be moved.
  5. Click Copy or Move. The status of each member copy or move appears in the Status column.
    • Hover over the Status column to get detailed information on the status. Alternatively, click Details to open the Details dialog box, which displays a summary of the results without the need to hover.
    • If any operations fail (for example, if the resource to move is in use), attempt to resolve the reason for the failure, then click Restart to try again. In certain circumstances, an opportunity is given to remove the successfully completed results before retrying the operation. 

      Note: If there are any differences in the format of the source and target datasets, a warning appears giving an option to proceed or cancel. 

      Note: Previous executions can be opened from the Event History view. Refer to Using Event History to View Results or Rerun a Copy or Move

To copy or move data from a sequential dataset to a PD

  1. Select a sequential dataset to copy or move to a PDS. In the case of a move, the sequential dataset will be deleted after the data is copied.
  2. Copy or move the data by following one of these operations:
    • Right-click the selection and select Copy or Cut (move). Then right-click on the target dataset and select Paste.
    • Press Ctrl+C (to copy) or Ctrl+X (to cut/move). Then select the target dataset and press Ctrl+V.
    • Drag the selection and drop it on the target dataset.
      The Copy or Move dialog box appears, listing the source dataset and target dataset’s members involved in the copy or move.
  3. If the member exists in the target dataset, in the Options box, select or clear the Replace existing like-named members check box. Note: The target member is named from the last qualifier of the source dataset.
  4. If File-AID is installed and the source host is at the correct PTF level, complete the Selection Criteria tab to use selection criteria. Refer to the File-AID/Eclipse User Guide for detailed information. Note: Datasets can only be copied when using selection criteria; they cannot be moved.
  5. Click Copy or Move. The status of each member copy or move appears in the Status column.
    • Hover over the Status column to get detailed information on the status. Alternatively, click Details to open the Details dialog box, which displays a summary of the results without the need to hover.
    • If any operations fail (for example, if the resource to move is in use), attempt to resolve the reason for the failure, then click Restart to try again. In certain circumstances, an opportunity is given to remove the successfully completed results before retrying the operation. 

      Note: If there are any differences in the format of the source and target datasets, a warning appears giving an option to proceed or cancel. 

      Note: Previous executions can be opened from the Event History view. Refer to Using Event History to View Results or Rerun a Copy or Move.

To copy or move data from one VSAM or IAM dataset to another

  1. To copy or move IAM datasets, ensure that the IAM service is running on all LPARs being used.
  2. Select a VSAM or IAM dataset to copy or move to another VSAM IAM dataset.
  3. Copy or move the data by following one of these operations:
    • Right-click the selection and select Copy or Cut (move). Then right-click on the target dataset and select Paste.
    • Press Ctrl+C (to copy) or Ctrl+X (to cut/move). Then select the target dataset and press Ctrl+V.
    • Drag the selection and drop it on the target dataset.
      The Copy or Move dialog box appears, listing the source and target dataset involved in the copy or move.
  4. If the target dataset exists, in the Options box, select the option to either overwrite or append existing data.
  5. If File-AID is installed and the source host is at the correct PTF level, complete the Selection Criteria tab to use selection criteria. Refer to the Topaz Workbench File-AID/Eclipse User Guide for detailed information. Note: Datasets can only be copied when using selection criteria; they cannot be moved.

  6. Click Copy or Move. The status of each member copy or move appears in the Status column.

    • Hover over the Status column to get detailed information on the status. Alternatively, click Details to open the Details dialog box, which displays a summary of the results without the need to hover.
    • If any operations fail (for example, if the resource to move is in use), attempt to resolve the reason for the failure, then click Restart to try again. In certain circumstances, an opportunity is given to remove the successfully completed results before retrying the operation.

    Note: If there are any differences in the format of the source and target datasets, a warning appears giving an option to proceed or cancel. 

    Note: Previous executions can be opened from the Event History view. Refer to Using Event History to View Results or Rerun a Copy or Move.

To copy or move PDS, sequential, VSAM, or IAM datasets from one z/OS host to the same or a different z/OS host

  1. To copy or move IAM datasets, ensure that the IAM service is running on all LPARs being used.
  2. Ensure that an OMVS segment is defined for the current user.
  3. Select the datasets to copy or move.
  4. Copy or move the datasets by following one of these operations:
    • Right-click the selection and select Copy To or Cut (to move).
    • Press Ctrl+C (to copy) or Ctrl+X (to cut/move). Then select the target dataset and press Ctrl+V.
    • Drag the selection and drop it on the z/OS hosts node or z/OS Datasets node within Host Explorer.
      The Copy to Host dialog box appears, listing the resources to be copied or moved. Note: Datasets cannot be copied into themselves. To resolve this, rename the target dataset or, to move datasets to another z/OS host, choose a different target host.
  5. Do one of the following:
    • Optionally, if there are multiple hosts, from the Target host list, select the target host.
    • Optionally, click Configure to configure a host.
  6. If necessary or desired, rename the target datasets. By default, the target names are the same as the source names, however, they can be renamed by doing one of the following:
    • Select the target and click Rename. The Rename Target Dataset dialog box appears. Type a name for the target resource and click OK.
    • Click Rename All. The Rename All dialog box appears. In the Find field, type the characters to be replaced, and in the Replace with field type the replacement value. Click OK.
  7. In the Options box, select the option to be applied. Available options vary by resource type:
    • Prompt me before copying each dataset: Displays the Dataset exists dialog box before performing the copy operation for each dataset that already exists. This dialog box allows users to set options individually for each dataset. This option is not available if the Run in background check box is selected.
    • Copy the data>Sequential & VSAM (for sequential, VSAM, or IAM datasets)
    • Overwrite existing data
    • Append to existing data
    • Copy the data>PDS members
    • Replace existing like-named members
    • Copy data even when dataset attributes do not match: If certain attributes, such as record length, do not match, attempt to force the copy. In this stated case, from the Pad character list, select Null or Space as necessary to achieve a successful copy.
    • Delete and allocate target dataset before copying: First delete the target dataset and then allocate it exactly like the source dataset before copying.
    • Skip the dataset: Allows the selected resource to be skipped during processing.
    • When allocating target datasets, use the SMS parameters of the source dataset: When allocating the target, apply the same SMS Parameters as the source; otherwise, let the system decide.
    • Run in background: Runs the copy operation in the background to allow for other foreground processing. When processing is finished or canceled, a dialog box appears with a link to the Copy to Host dialog box with summary results.
  8. If File-AID is installed and the source host is at the correct PTF level, complete the Selection Criteria tab to use selection criteria. Refer to the Topaz Workbench File-AID/Eclipse User Guide for detailed information.
    Note: Datasets can only be copied when using selection criteria; they cannot be moved.
  9. Click Copy. Processing can be suspended by clicking Pause and then option settings can be changed. The Progress view shows the status if the operation is running in the background.
    • The status of each dataset copy or move appears in the Status column. Hover over the Status column to get detailed information on the status. Alternatively, click Details to open the Details dialog box, which displays a summary of the results without the need to hover.

    • When copying multiple resources and some are not successful, consider selecting the successful resources and clicking Remove to remove them from the display, then make any corrections to the remaining resources and click Restart to attempt the copy operation again. In certain circumstances, an opportunity is given to remove the successfully completed results before retrying the operation. 

      Note: If a volume on the target host is required during allocation of the dataset, the Specify Volume dialog box appears. Enter the volume to be used for all VSAM files in the list and click OK to submit the copy operation. Clicking Cancel terminates the copy request and the status column shows Skipped on any remaining datasets. 

      Note: If there are any differences in the format of the source and target datasets, a warning appears giving an option to proceed or cancel. 

      Note: Previous executions can be opened from the Event History view. Refer to Using Event History to View Results or Rerun a Copy or Move.

Using Event History to View Results or Rerun a Copy or Move

The Event History view displays the results as do copy or move operations.

To view prior copy or move results

Open the Event History view. The following statuses may appear:

  • Success indicates that the involved resources were copied/moved without errors.
  • Skipped indicates that the copy/move was not performed due to user intervention such as canceling the copy/move.
  • Failed indicates a failure to complete any portion of the copy/move action.

Other notes

Any copy/move actions of datasets/PDS members outside of Host Explorer are not supported. Both drag and drop actions can occur within the tree pane of Host Explorer.

 

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