Copy From panel

You use the Copy From panel to specify the data set from which you want to copy records, the number of records to be copied, whether or not a template is to be used and various other processing options.

Panel and field definitions

Figure 1. Copy Utility: “From” panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Z Data Tools                     Copy Utility

 From Partitioned, Sequential or VSAM Data Set, or HFS file:
    Data set/path name  . . 'HFMUSER.EXPORT'                                +
    Member  . . . . . . . .                (Blank or pattern for member list)
    Volume serial . . . . .              (If not cataloged)
    Start key . . . . . . .                                key or slot
    Skip count  . . . . . .              Include           Repeat skip              
    Copy count  . . . . . . ALL          number of records to be copied
 From Copybook or Template:
    Data set name . . . . . 'HFMUSER.DATA'                                
    Member  . . . . . . . . TEMPA          (Blank or pattern for member)
 Processing Options:
    Copybook/template    Enter "/" to select option
    2  1. Above             Batch execution           Advanced member selection
       2. None              Use proc                  Skip member name list
       3. Create dynamic    Ignore length mismatch    REXX member selection: P
       Edit template        JCL Source format         Directory integrity
       Type (1,2,S)         MQ Include descriptor     Report PDS record counts
       Export mode          MQ Get destructive        Binary mode, reclen      
                            Use I/O exit
 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel
From data set/file: Data set/path name
Specify the data set to be copied. Can be a fully-qualified data set name or a pattern, an HFS file or directory, a WebSphere® MQ queue name, or a CICS® resource.

For information about specifying a WebSphere MQ queue name, see Specifying an MQ manager or queue.

For information about specifying a CICS resource, see Specifying a CICS resource.

The data set name may include a member name or name pattern in parenthesis. If the member is specified here, the associated Member field must be empty.

When you specify an HFS file or directory, you must enter a full path name. If the path name is longer than the displayed entry field, press the Expand function key (F4) to display a pop-up window in which you can enter a longer name.

From Data Set: Member
If you specified the name of a partitioned data set (PDS) without including a member name or name pattern in parenthesis in the Data set name field, then you can use this field to specify the member name or a member name pattern.
Volume serial
Serial number of the volume which contains the data set to be copied. Required for data sets which are not cataloged.
Start key
Specifies the start position for the records to be copied (VSAM data sets only). Copying starts either at the first record with a key or slot number greater than or equal to the specified value in the Start key field, or after skipping the number of records specified in the Skip count field. 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').

The Start key and Skip count fields are mutually exclusive.

Skip count
Number of logical records to be skipped from the beginning of the file. By default processing begins with the first record in the file.

Range: 0-99999999. Default: 0.

Include
Represents 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.

Range: 0-9999999. Default: 0.

Repeat skip
Represents 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.

Range: 0-9999999. Default: 0.

Copy count
Specify the number of logical records to be copied.

Range: 1-99999999, ALL. Default: ALL.

From Copybook or Template: Data set name
Data set name of the template or copybook to be used to select and format the data to be copied. This field is ignored when the Copybook/template usage field is set to 2. None.
Note: In the case of a copybook, this can be the name of a CA-Panvalet library, or a library accessed using the Library Management System Exit.
From Copybook or Template: Member
If you specified the name of a partitioned data set (PDS) or CA-Panvalet or other external library in the Data set name field, then use this field to specify the member name or member name pattern. This field is ignored when the Copybook/template usage field is set to 2. None.
Copybook/template usage
Indicates if you want to use a template to format and select your data.
1. Above
Use the template specified on the panel (or compile the specified copybook into a template, and use that).
2. None
No logical view is to be used by the function.
3. Create dynamic
Create a dynamic template.
Edit template
Indicates that you want to edit the template before use. You edit the template when you need to change format, selection, data create attributes, and reformatting information for output copy templates.
Type (1,2,S)
The type of editing you want to perform.
You can specify one of the following values:
1
Edit the Record Identification Criteria by field first
2
Edit the Record Selection Criteria by field first
S
Edit the source definition for a template using the advanced copybook selection facility.

This option is ignored when editing a dynamic template.

Export mode
Indicates that the input dataset (file) is to be copied into the output dataset (file) in an external format.
Batch Execution
Allows you to edit the JCL to run the function in batch.
Use proc
Allows you to specify a procedure (containing REXX or DFSORT statements or both) to run in conjunction with the Copy action.

This option has two fields. To select the option, enter “/” in the field to the left of Use proc. With this selected, you can then specify which procedure to use in the field to the right of the field label (the proc name field). In the name field you can perform either of these actions:

  • Enter a temporary procedure for one-time use, by entering a single asterisk (*). Z Data Tools displays an Edit panel that you can use to create a new 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 any of the following:
    • The name of the member.
    • A member name pattern (other than a single *) to list all matching members. You can then select the required member by entering an S in the Sel field. A member name pattern can consist of any characters that are valid in a member name and the following two special pattern characters:
      asterisk (*)
      Represents any number of characters. As many asterisks as required can appear anywhere in a member name. For example, if you enter *d*, a list of all members in the data set whose name contains “d” is displayed.
      percent sign (%)
      A place-holding character representing a single character. As many percent symbols as necessary can appear anywhere in a member name. For example, if you enter %%%%, a list of all members in the data set whose name is four characters in length is displayed.
Ignore length mismatch
Indicates that you want to ignore length mismatches with the template. If you do not specify this, records that are shorter than the matching structure length in the template are not selected for processing. If you select Ignore length mismatches, then "from" fields that span the record boundary in the input data set record have their corresponding fields on the output record initialized, with the exception of alphanumeric fields where a partial copy is done for the portion of the field that exists on the input record.
JCL Source format
Indicates the file or PDS(E) members being copied contain JCL, the syntax of which is to be maintained during the copy process. You can only use this option if you have selected the Use proc option.
Note: Use of this option may affect the copy performance due to the processing overhead involved in verifying the syntax of the JCL.
MQ Include descriptor
If this is selected (with the / character), the message descriptor data returned by the GET MQ API is added as a prefix to the record data, allowing this data to be examined in conjunction with the message data.

Otherwise only the message data is available for processing.

MQ Get destructive

If this is selected (with the / character), the input messages queue (if an MQ queue is specified) is opened in SHARE mode and the MQ API GET destructively reads each message.

Otherwise the queue is opened in BROWSE mode and messages are not removed from the queue. This is only effective for the DSC (Copy) function.

Use I/O exit
Allows you to specify a user I/O exit for compressed or encrypted data sets.

This option has two fields. To select the option, enter “/” in the field to the left of Use I/O exit. With this selected, you can then specify which exit to use in the field to the right of the field label.

Note:
  1. The field only displays if 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.
  2. I/O exits can only be used to process the data sets that you are using. They cannot be used to process the copybooks or templates that you are using to format the data sets.
Advanced member selection
Enter "/" to specify a range of members to be selected rather than a specific or generic member name.
Skip select member panel
Enter “/” to run without showing the member selection list. This option is ignored if errors are found whilst copying (for example, duplicate member names when renaming members).
REXX member selection
Enter “/” to use a REXX procedure to determine if a member should be copied.

If this option is selected, then the Use Proc: option must be selected, a REXX procedure must be supplied and you can (optionally) specify the default action to be applied in the event the nominated procedure fails to determine if a member in the input data set should be copied.

The default action is determined by entering a P (PROCESS MEMBER) or D (DROP MEMBER) in the adjacent field. If no default is provided, P is assumed.

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
The count of records for copied PDS(E) members and sequential/VSAM data sets is printed in the processing listing in batch. Copy progress counts are displayed on screen while processing in online mode.
Note: This option affects PDS(E) processing ONLY. For sequential/VSAM data sets, the record counts are always provided. When the option is selected, it prevents the use of IEBCOPY for PDS(E) processing, which may affect the copy performance.
Binary mode
When processing an HFS file, allows you to specify binary mode (selected) or text mode (unselected).
reclen
When processing an HFS file and the Binary mode option is selected, records are derived based on the fixed record length specified. The default is 80.

Can be in the range: 1–32760

Child panels

Equivalent functions

DSC (Data Set Copy)