Copy To panel

You use the Copy To panel to specify the data set to which you want your copy to be made. This panel comes in three versions, depending on whether or not you have specified a template in the Copy From panel and requested that the output be in an external format.

Panel and field definitions

Figure 1. Copy Utility: “To” panel (no copybook or template in Copy From panel)
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Copy from USERID.FMDATA(DATA1)

 To Partitioned, Sequential or VSAM Data Set, or HFS file:
    Data set name . . . . . FMDATA                                          +
    Member  . . . . . . . . DATA2   
    Volume serial . . . . .       

 Processing Options:
    Disposition             Execution "/" options          ISPF Packing
    1  1. Old or Reuse         Replace members             1  1. Asis
       2. Mod                  Binary mode, reclen            2. Pack
    Stats Option                                              3. Unpack
    1  1. Off                                                 4. None
       2. Force                                               5. Skip





 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel
Copy from
Lists the data set, HFS file (directory), WebSphere® MQ queue name, or a CICS® resource from which you are copying data.
To data set/file: Data set/path name
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.

To 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 is to contain the copied data set. Required for data sets which are not cataloged.
Disposition
The To data set status:
Old/Reuse
Writes copied records into the output data set, starting from the beginning of the set and replacing any existing records.
Mod
Appends the input records to the end of the data set unless the data set is a VSAM KSDS data set. In this case, the records are positioned in the data set using the key value in the input record. MOD is invalid for a member of a partitioned data set.
Replace members
Replace like-named members in an output partitioned data set.
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

Stats
Determines whether ISPF statistics (if present) for the PDS members being processed are updated:
Blank
Update ISPF statistics.
1 Off
Do not update ISPF statistics.
2 Force
Always update or create ISPF statistics.
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 copybook or template that you are using to format the data set.
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, one of these options can be used to control the copy behavior when processing data that is in ISPF PACK format.
1. Asis
If the input data set is packed, it is unpacked before any processing. The output is written in packed format only when the input is packed.
2. Unpack
If the input data set is packed, it is unpacked before processing. The output is always written in unpacked format.
3. Pack
If the input data set is packed, it is unpacked before processing. The output is always written in packed format.
4. None
No checking or processing of ISPF packed data occurs. This option is forced if an I/O exit has been used.
5. Skip
If the input data is packed, no processing or copying occurs.

When you have specified a template in the Copy From panel, the Copy To panel contains additional fields, so that you can choose to specify a template for the output data set.

Figure 2. Copy Utility: “To” panel (copybook or template specified in Copy From panel)
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Copy from HFMUSER.EXPORT                                           Top of data

 To Partitioned, Sequential or VSAM Data Set, or HFS file:
    Data set/path name  . . 'HFMUSER.DATX'                                  +
    Member name (or mask) .         
    Volume serial . . . . .       

 To Copybook/Template From:  HFMUSER.DATA(TEMPA)
    Data set name . . . . .                                               
    Member  . . . . . . . .                (Blank or pattern for member)

 Processing Options:
   Copybook/template usage   Disposition          Enter "/" to select option
   2  1. Above               1  1. Old or Reuse      Replace members
      2. None                   2. Mod               Edit template mapping
      3. Create dynamic      Stats Option            Edit template source
   ISPF Packing              1  1. Off               Binary mode, reclen      
   1  1. Asis                   2. Force
      2. Pack
      3. Unpack
      4. None
      5. Skip
 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=CRetriev  F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel                                           
Copybook/Template From
Lists the copybook or template specified in the Copy From panel, if applicable.
To Copybook or Template: Data set name
Data set name of the template or copybook to be used when mapping fields from the From Copybook or Template. This template does not affect the record selection or field format of the copied data. The 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.
To 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.
Edit template mapping
Specifies that you want to change the mapping of input fields to output fields or the data creation patterns for new fields.
Edit template source
Specifies that you want to edit the copybook used to generate the template.

If you selected the Export mode option on the Copy From panel, the Copy To panel contains additional fields specific for external format that allow you to customize the result of copy.

Figure 3. Copy Utility: “To” panel (Export mode specified in Copy From panel)
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Copy from HFMUSER.FMDATA

 To Partitioned, Sequential or VSAM Data Set, or HFS file:
    Data set/path name  . . 'HFM.FMDATA'                                    +
    Member name (or mask) .         
    Volume serial . . . . .       

 Processing Options:
   Disposition           Execution "/" options         Non-print. characters
   1  1. Old or Reuse       Replace members            2  1. Asis
      2. Mod                Binary mode, reclen           2. Hex
   ISPF Packing             Include fillers               3. Replace with .     
   1  1. Asis               Include redefines             4. Skip
      2. Pack               Convert to Unicode         Special characters
      3. Unpack             Split output line          1  1. Escape
      4. None                                             2. CData
      5. Skip               Stats Option                  3. Hex
   Format                   1  1. Off                     4. Replace with *     
   1  1. XML                   2. Force                Invalid data
                            Indent step 1              1  1. Hex
                                                          2. Replace with *     
                                                          3. Skip
 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel
Disposition
1. Old or Reuse
Copies from the beginning of the existing data set.
2. Mod
Appends the input records to the end of the data set. MOD is invalid for a member of a partitioned data set.
ISPF Packing
Provided an I/O exit routine is not used, one of these options can be selected to control the copy behaviour when considering data that is in ISPF packed format. (Note that packed options do not apply to VSAM input.)
1. Asis
If the input data set is packed, it is unpacked before any processing. The output is written in packed format if the input was packed.
2. Pack
If the input data set is packed, it is unpacked before processing. The output is written in packed format.
3. Unpack
If the input data set is packed, it is unpacked before processing. The output is written in unpacked format.
4. None
No checking or processing of ISPF packed data occurs. This option is forced if an I/O exit has been used.
5. Skip
If the input data is packed, no processing or copying occurs.
Format
Specifies an external format to be used for the output.
1. XML
The output is generated in XML format.
Execution "/" options
Replace members
Replace like-named members in an output partitioned data set.
Binary mode
Data in an HFS file is processed without record delimiters (in binary mode).

reclen: The logical record length used to deblock data into fixed records (default: 80).

Include fillers
Indicates whether fillers (unnamed items), defined in the input template (COBOL copybook or PL/I include), are to be represented in the output or ignored.
Include redefines
Indicates whether redefinitions of data items, specified in the input template (COBOL copybook or PL/I include), are to be represented in the output or ignored.
Convert to Unicode
Indicates whether the output is to be converted to Unicode, or not.
Split output line
Indicates whether the output lines resulting from processing an input record are to be spanned contiguously over multiple output records. If so, the output records will not match output lines. If not, each output line must fit (as the only line) into a single output record, otherwise Z Data Tools truncates the output, ends processing, and reports an error.
Use I/O exit
Activates the specified exit routine which handles a compressed or encrypted data set. Specify the name of the exit routine unless the default exit is in effect and can be used.
Indent step
Defines the number of blanks used to indent each level of XML tag nesting (each nested level in the template, COBOL copybook, or PL/I include causes an increase in indentation by the specified number of blanks). Valid range: 0–9 (default:1).
Non-print. characters
Indicates how non-printable characters are to be represented in the output.
1. Asis
Non-printable characters appear unchanged in the output.
2. Hex
A value with one or more non-printable characters is substituted by its hexadecimal representation.
3. Replace with replacing-character
Each non-printable character is substituted with a replacing character, or each substring of non-printable characters is converted to its hexadecimal representation and surrounded by nested <HEX> and </HEX> tags. The set of allowable replacing characters is limited to printable characters with the exception of special characters.
You can specify the replacing character in one of the following forms:
char
Each non-printable character is replaced with a character, such as "?". Default character: "." (dot).
C'char
Each non-printable character is replaced with a character without case translation.
X'cc'
Each non-printable character is replaced with a character defined by its hexadecimal value.
HEX
If you specify HEX instead of a replacing character, each substring of consecutive special characters is replaced by its hexadecimal representation, tagged by <HEX> and </HEX>, and nested into the content of the element. In other words, each string of consecutive special characters is represented by:
<HEX>hex-representation-of-nonprintable-char-string</HEX>
nested in the content of the element.
4. Skip
Value is skipped if it contains any non-printable characters.
Special characters
Indicates how special characters are to be represented in XML output.
1. Escape
Special characters are converted into escaped strings:
  • "&gt;" for ">"
  • "&lt;" for "<"
  • "&apos;" for "'"
  • "&quot;" for "'"
  • "&amp;" for "&"
2. CData
The string containing special characters is left unchanged. It is enclosed in the CDATA section.
3. Hex
A value with one or more special characters is substituted with its hexadecimal representation.
4. Replace with replacing-character
Each special character is substituted with a replacing character, or each substring of special characters is converted to its hexadecimal representation and surrounded by nested <HEX > and </HEX > tags. If a replacing character is specified or defaulted, each special character is substituted with the replacing character. The set of allowable replacing characters is limited to printable characters with the exception of special characters.
You can specify the replacing character in one of the following forms:
char
Each special character is replaced with a character, such as "?". Default character: "_" (underscore).
C'char'
Each special character is replaced with a character without case translation.
X'cc'
Each special character is replaced with a character defined by its hexadecimal value.
HEX
If you specify HEX instead of a replacing character, each substring of consecutive special characters is replaced by its hexadecimal representation, tagged by <HEX> and </HEX>, and nested into the content of the element. In other words, each string of consecutive special characters is represented by:
<HEX>hex-representation-of-special-char-string</HEX>
nested in the content of the element.
Invalid data
Indicates how invalid data is to be represented in the output.
1. Hex
Any invalid value is substituted by its hexadecimal representation.
2. Replace with replacing character
Any invalid value is replaced with a string of replacing characters for the length of the value. The set of allowable characters is limited to printable characters with the exception of special characters.
You can use:
char
The value is replaced with a string of characters, such as "?". Default character: "*" (asterisk).
C'char'
The value is replaced with a string of characters without case translation.
X'cc'
The value is replaced with a string of characters, each character being defined by its hexadecimal value.
3. Skip
Any invalid value is skipped.

Parent panels

Child panels

Equivalent functions

DSC (Data Set Copy)