Default language.

Copying and moving datasets or members

Users can copy or move the following:

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 datase

    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.

    Important

    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.

Important

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


Important

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 datase

    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.

    Important

    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.

Important

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


Important

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 PDS

  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 datase

    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.

    Important

    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.

    Important

    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.

Important

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


Important

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 datase

    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.

    Important

    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.

Important

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


Important

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.

    Important

    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.

    Important

    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.

    Important

    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. 

    Important

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

    Important

    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.

Copying and Moving Files Between z/OS and Windows

Users can copy or move PDS and sequential datasets between z/OS and Windows.

Copying from Windows to z/OS

To copy a Windows file to an existing sequential dataset
1. In Host Explorer, right-click the Windows file and select Copy.


Important

UTF-8 encoding is assumed for the local files and will be translated using the host code page specified at login.

2. In Host Explorer, right-click the existing sequential dataset into which to copy the Windows file and select Paste. The Copy to Dataset dialog box appears with the source and target filenames populated.

Important

If any source file name is too long or is invalid, a message appears. Click Rename to change the file name.

3. On the Options tab, select one of the following buttons to indicate how the paste action should affect existing data:

  • Overwrite existing data
  • Append to existing data

4. Optionally, select the Copy data even when dataset attributes do not match check box to truncate the record if the Windows file is longer than the LRECL of the mainframe dataset. Additionally, from the Pad character list, select the type of character to be used for padding if the Windows file is shorter than the LRECL of the mainframe dataset.
5. Click Copy to perform the copy action. If desired, click Details to see information about the results of the copy operation.

Important

At any point, if desired, do the following:

  • To remove a source/target combination from the dialog box, select the applicable line and click Remove.
  • To clear all dialog box selections including rename, click Restart.

To copy a Windows file to an existing PDS folder or PDS member

1. In Host Explorer, right-click the Windows file and select Copy.

Important

UTF-8 encoding is assumed for the local files and will be translated using the host code page specified at login.

2. In Host Explorer, right-click the existing PDS (folder) or PDS member into which to copy the Windows file and select Paste. The Copy to Dataset dialog box appears with the source and target filenames populated.

Important

If any source file name is too long or is invalid, a message appears. Click Rename to change the file name.

3. On the Options tab, do one of the following buttons to indicate how the paste action should affect like-named members:

  • To overwrite an existing member with the same name, select the Replace existing like-named members check box.
  • To be notified that an existing member has the same name, clear the Replace existing like-named members check box. An error message will indicate the name conflict so action can be taken before copying.

4. Optionally, select the Copy data even when dataset attributes do not match check box to truncate the record if the Windows file is longer than the PDS/PDS member. Additionally, from the Pad character list, select the type of character to be used for padding if the Windows file is shorter than PDS/PDS member.
5. Click Copy to perform the copy action. If desired, click Details to see information about the results of the copy operation.

Important

At any point, if desired, do the following:

  • To remove a source/target combination from the dialog box, select the applicable line and click Remove.
  • To clear all dialog box selections including rename, click Restart.


To copy a single Windows folder or multiple Windows files from a single folder to an existing PDS folder

Important

When copying a Windows folder, subfolders are ignored and must be copied separately.

1. In Host Explorer, right-click the Windows folder or files and select Copy. All files must be from a single folder.

Important

UTF-8 encoding is assumed for the local files and will be translated using the host code page specified at login.

2. In Host Explorer, right-click the existing PDS (folder) into which to copy the Windows folder/files and select Paste. The Copy to Dataset dialog box appears with the source and target filenames populated.

Important

 If any source file name is too long or is invalid, a message appears. Click Rename to change the file name.

3. On the Options tab, do one of the following buttons to indicate how the paste action should affect like-named members:

  • To overwrite an existing member with the same name, select the Replace existing like-named members check box.
  • To be notified that an existing member has the same name, clear the Replace existing like-named members check box. An error message will indicate the name conflict so action can be taken before copying.

4. Optionally, select the Copy data even when dataset attributes do not match check box to truncate the record if the Windows file is longer than the PDS/PDS member. Additionally, from the Pad character list, select the type of character to be used for padding if the Windows file is shorter than PDS/PDS member.
5. Click Copy to perform the copy action. If desired, click Details to see information about the results of the copy operation.

Important

 At any point, if desired, do the following:

  • To remove a source/target combination from the dialog box, select the applicable line and click Remove.
  • To clear all dialog box selections including rename, click Restart.

To copy a sequential dataset to an existing Windows folder

1. In Host Explorer, right-click the sequential dataset and select Copy.

Important

Alternatively, the sequential dataset can be dragged and dropped into the desired location.

Important

UTF-8 encoding is assumed for the local files and will be translated using the host code page specified at login.

2. In Host Explorer, right-click the existing Windows folder into which to copy the sequential dataset and select Paste. The Move/Copy dialog box appears with the source and target populated.
3. Optionally, select the Replace check box to overwrite existing data with the copied data.
4. Optionally, click Rename to change the sequential dataset name.
5. Click Copy to perform the copy/paste action. The file is given an extension based on the z/OS dataset mapping definitions; if no definition exists for the file type, the file is given a .data extension. The Results column shows information about the results of the operation.

To copy a PDS member to an existing Windows folder

1. In Host Explorer, right-click one or more PDS members and select Copy.

Important

Alternatively, the PDS members can be dragged and dropped into the desired location. Note: UTF-8 encoding is assumed for the local files and will be translated using the host code page specified at login.

2. In Host Explorer, right-click the existing Windows folder into which to copy the PDS members and select Paste. The Move/Copy dialog box appears with the source and target populated.
3. Optionally, select the Replace check box to overwrite existing data with the copied data.
4. Optionally, click Rename to change the PDS member name. This option is disabled when copying more than one PDS member.
5. Click Copy to perform the copy/paste action. A parent folder matching the name of the PDS parent folder is created and the copied files reside within that folder. The files are given an extension based on the z/OS dataset mapping definitions; if no definition exists for the file type, the file is given a .data extension. The Results column shows information about the results of the operation and if any failures occur, no files are copied.

To copy a PDS folder to an existing Windows folder

1. In Host Explorer, right-click the PDS folder and select Copy. Note: Alternatively, the PDS folder can be dragged and dropped into the desired location.

Important

 UTF-8 encoding is assumed for the local files and will be translated using the host code page specified at login.

2. In Host Explorer, right-click the existing Windows folder into which to copy the PDS folder and select Paste. The Move/Copy dialog box appears with the source and target populated.
3. Optionally, select the Replace check box to overwrite existing data with the copied data.
4. Optionally, click Rename to change the PDS name.
5. Click Copy to perform the copy/paste action. The PDS (with its members) is copied to the target Windows directory location. The files are given an extension based on the z/OS dataset mapping definitions; if no definition exists for the file type, the file is given a .data extension. The Results column shows information about the results of the operation and if any failures occur, no files are copied.


 

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