Copying without a template

When you are copying data sets and do not use a template, all data in an input data set record is copied to the output data set. You can limit the number of records selected by using the Start key, Skip count and Copy count fields on the Copy Utility (option 3.3) panel (for example, you can specify the number of records to be copied).

If you are not using a template for your copy, use the Copy Utility panel (see Figure 1) as follows:

  1. From the Primary Option Menu panel, select option 3. Utilities and then option 3. Copy.

    The Copy Utility panel is displayed.

  2. Perform either of these actions
    • Specify the data set that contains the data you want to copy, using a combination of the Data set name, Member, and Volume serial entry fields as appropriate.
    • To select a range of members based on selection criteria, specify the data set name or name pattern for a PDS(E) data set, optionally the member name or pattern, and select the Advanced member selection option.
      Note: If you enter details in the Member field and select the Advanced member selection option, Z Data Tools populates the Member name field on the subsequent Advanced Member Selection panel with the same value.
  3. Set your record-level selection, using the following entry fields on the Copy Utility panel:
    Start key
    If required, specify a Start key for the data (VSAM only). Copying starts at the first record with a key or slot number greater than or equal to the specified value. If the key contains lowercase characters, blanks, or commas, enclose it in quotation marks. Keys may also be in hexadecimal format (e.g. X'0102').
    Skip count
    If required, specify a Skip Count for the data. Copying starts after skipping the number of records specified in the field.
    Include
    If required, specify the number of physical records that to be included in a repeating sample from a data set. Both Include and Repeat Skip fields must have non-zero values for sampling to take effect.
    Repeat skip
    If required, specify the number of physical records to be skipped in a repeating sample from a data set. Both Include and Repeat Skip fields must have non-zero values for sampling to take effect.
    Copy count
    Specify the number of records to be copied. Enter ALL to copy all records.
    Note: The Start key and Skip count fields are mutually exclusive.
  4. Select 2. None in the Copybook/template usage field.
    Note: When this field is set to None, data in the Copybook or Template Data set name and Member fields is ignored.
  5. Select the processing options that you want:
    Batch execution
    Select this option when you want to generate the JCL needed to run the function in batch. The generated JCL is displayed in an Edit session.
    Use proc
    Select this option when you want to run a REXX procedure or DFSORT statements in conjunction with your copy action, and then specify the procedure name in the adjacent field.

    To create a temporary procedure for one-time use enter an asterisk (*). Z Data Tools displays an Edit panel that you can use to create a new procedure.

    To use an existing procedure, specify the name of the member containing the procedure you want to use. The member must belong to the PDS allocated to ddname HFMEXEC. You can enter the name of the member or a member name pattern (other than *). If you specify a pattern, the Member Selection panel for the PDS is displayed when you press Enter. You can then select the required member by entering an S in the Sel field.

    Ignore length mismatch
    Select this option when you want to include records in the copy process that are shorter than the matching template structure length.
    Use I/O exit
    Select this option when you want to run a user I/O exit that processes the “From” (input) data set in conjunction with the copy action. If selected, specify the exit name in the adjacent field.
    Note: This option is only available when Z Data Tools is installed with the option USEIOX=ENABLE, and the Exit enabled field in the Set System Processing Options panel is set to YES. If a default is specified with either of those options, it is displayed in the field to the right of Use I/O exit.

    Do not select this option if you plan to use the ISPF Packing option on the next panel.

    Skip member selection list
    Select this option when you have either used a generic name in the Member field or specified Advanced member selection, and want to copy all members that match the name or range of names, without further refining the member list. This option is ignored if errors are found whilst copying.
    Directory integrity
    Forces an override of the default PDS(E) member processing method which allows for faster PDS directory access.

    This option has significant performance impact. When selected, the members are processed in a way which allows concurrent directory updates as Z Data Tools accesses the members using current directory information.

    When not selected, the member processing is performed faster, but may be affected by PDS(E) directory updates, possibly causing I/O errors if the data set is updated concurrently.

    Report PDS record counts
    Select this option when you want the count of records for copied PDS(E) members to be displayed (online) or printed (batch).
  6. Press Enter. The Copy To panel is displayed.
  7. Type the “To” data set details. Use a combination of the Data set name, Member, and Volume serial entry fields (the volume serial is only required for data sets which are not accessible via the system catalog) to specify the data set (and PDS(E) member if appropriate) to which you want to copy the data.

    If the output data set does not exist, Z Data Tools displays the Allocation panels to help you create a new data set.

  8. Select the processing options for the Copy To panel:
    DISP
    Determines the disposition of the “To” (output) data set. Specify OLD or MOD.
    1. OLD
    Select this option when you want the copied records to be placed into the “To” data set, starting from the beginning of the data set and overwriting any existing records.
    2. MOD
    Select this option when you want the copied records to be appended to the end of an existing output data set.
    Note: You cannot append records to a PDS or PDSE member or to a packed sequential data set. You also cannot append packed records to a non-packed sequential data set. You must use the OLD option to replace these records.
    Note: SMS might modify the allocation of new data sets on your system. For details, contact your SMS Administrator.
    Replace members
    Select this option when you want to replace like-named members in an output partitioned data set.
    Use I/O exit
    Select this option when you want to run a user I/O exit that processes the “To” (output) data set in conjunction with the copy action. If selected, specify the exit name in the adjacent field.

    If you specify an I/O exit, you cannot use the ISPF Packing option.

    ISPF Packing
    Provided that the output data set is a sequential, PDS or PDSE file, an I/O exit routine is not used and the DISP is set to OLD, select one of these options to control the copy behavior when processing data that is in ISPF PACK format.
    1. Asis
    Select this option when you want Z Data Tools to write the output in the same format (packed or unpacked) as the input records. If the input data is packed, it is unpacked for the processing operation, and then written out in ISPF PACK format.
    2. Unpack
    Select this option when you want Z Data Tools to write the output in unpacked format, regardless of the format of the input records. If the input data is packed, it is unpacked for the processing operation, and then written out without the ISPF PACK format.
    3. Pack
    Select this option when you want Z Data Tools to write the output in ISPF PACK format, regardless of the format of the input records. If the input data is packed, it is unpacked for the processing operation, and then written out in the ISPF PACK format.
    4. None
    Select this option when you do not want Z Data Tools to check for packed records or unpack records for processing. If the input data is packed, any processing actions operate on the records in their packed format.

    This is the only option allowed when an I/O exit has been specified, when the Disposition is set to MOD or when the Copy To data set is not a sequential file or PDS(E) member.

    5. Skip
    Select this option when you want to halt the copying or processing actions, if the input data is packed.
  9. Press Enter.

    If you selected the Advanced member selection option, Z Data Tools displays the Advanced Member Selection panel:

    1. Specify the selection criteria to select the members you want to copy and press Enter.
    2. If you have left the Member name field on the Advanced Member Selection panel blank or have entered an asterisk (*) or a mask, (and you did not select the Skip member name list on the Copy From panel), Z Data Tools displays the Member selection panel. In this case, select the members you want to copy (either by typing an "S" in the Cmd field, or with the SELECT primary command) and press Enter.

    Z Data Tools copies the selected data in the “From” data set to the “To” data set.

Care must be taken when attempting to combine the Use proc, Use I/O exit and ISPF Packing options. You cannot use an I/O exit and the ISPF Packing option at the same time. You can provide a procedure and use an I/O exit or the ISPF Packing option but you cannot include *Fastproc DFSORT statements in your procedure.

Related topics