Data Create Utility panel

You can use the Data Create Utility panel to create and initialize sequential data sets, VSAM data sets, and PDS data sets and members.

Panel and field definitions

Figure 1. Data Create Utility panel
  Process   Options   Help
──────────────────────────────────────────────────────────────────────────────
 Z Data Tools                 Data Create Utility                   Top of data

 Output Partitioned, Sequential or VSAM Data Set, or HFS file:
    Data set/path name  . . . /u/testonly/xxx.txt                             +
    Member  . . . . . . . . . *            (Blank or pattern for member list)
    Volume serial . . . . . .              (If not cataloged)
    Record length . . . . . . 90           Optional record length for RECFM V
    Records . . . . . . . . .              Number of records
    Fillchar  . . . . . . . .              Char or hex value, AN, BIN, or RAND
    Sequence field position .              If sequence field desired
    Sequence field length . . 8            Length from 1 to 9
    Sequence field increment  10           Increment value
    Like data set . . . . . .                                               
 Copybook or Template:
    Data set name . . . . . . 'HFMUSER.TEMPLATE'                            
    Member  . . . . . . . . .              (Blank or pattern for member list)
 Processing Options:
    Disposition       Copybook or template     Enter "/" to select option
    2  1. Old/Reuse   1  1. Above                 Edit template    Type (1,2,S)
       2. Mod            2. Previous              Batch execution
    ISPF Packing         3. None                  Binary mode, reclen      
    1  1. None           4. Create dynamic
       2. Pack
 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel
Data set/path name
Can be a fully-qualified data set name or a pattern, or a HFS file or directory. 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.

Note: This can be the name of a new or existing data set. If it is a new data set, you are asked to allocate the data set when you process the panel.
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.
Record length
The length of the records to be written. For variable record formats, the value specified is used when it is less than the maximum record size. Otherwise, the maximum record size is used and user input is ignored. For fixed record formats, the value is set to the data set record length and user input is ignored. For undefined record formats, the value is set to the block length and user input is ignored.
Records
The number of records to be written to the output data set.
Fillchar
Determines how each byte of each record is to be filled. You can enter:
char
Writes the character char in each byte. Alphabetic characters are translated to upper case.
C'char'
Writes the character char in each byte without case translation.
X'cc'
Writes X'cc' in each byte.
AN
Fills the record with consecutive characters (A to Z, 0 to 9)
BIN
Fills the record with consecutive binary characters (X'00' to X'FF')
RAND
Fills the record with random binary characters (X'00' to X'FF')
Sequence field position
The position (starting with 1) of the sequence field within the output block or record. If omitted, there is no sequence field.

This field is ignored if a template or copybook is used for data creation.

Note:
  1. This differs from the Key position field on the Allocation panel, which measures the position as an offset value. That is, if the Allocation panel defines the Key position as 10, then the field begins in column 11.
  2. Key position and Key length define a unique sequencing field located anywhere in the record, and not necessarily related to the key of a KSDS VSAM data set, as they can be used with any type of data sets.
Sequence field length
The length of the sequence field. The default is 8. The value of [Key position + Key length - 1] must be less than or equal to the record length.

This field is ignored if a template or copybook is used for data creation.

Sequence field increment
The increment value used to increase the number in the sequence field. The default is 10.

This field is ignored if a template or copybook is used for data creation.

Copybook or Template
Data set name and Member name of the template or copybook to be used to format your data.
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.
Disposition
Sets the output data set status:
Old/Reuse
Writes records into the output data set, starting from the beginning of the set and replacing any existing records.
Mod
Appends the records to the end of the output data set.
Like data set
Name of the data set to be used as the model for the output allocation.

Z Data Tools uses the TSO prefix (as defined for your user ID) used as the high-level qualifier for any name that is not enclosed in quotation marks.

If copying data sets, "=" denotes the current input data set.

The model data set must reside on a DASD volume, be cataloged, and SMS must be active.

Copybook or template
Determines whether or not a copybook or template is to be used to format your data.
Above
Z Data Tools uses the template specified on the panel. (If you specified a copybook, Z Data Tools compiles it into a template before use.)
Previous
Z Data Tools uses the last template you used to process this data set. If you have not previously used a template for this data set, Z Data Tools displays a message and processing continues without a template.
None
Z Data Tools does not use a template and therefore does not perform data creation at field level.
Create dynamic
Z Data Tools creates a dynamic template. You can now define fields and field creation attributes.
Edit template
Allows you to edit the template you have requested for processing.
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.

Batch execution
Allows you to edit the JCL to run the function in batch.
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. An I/O exit can only be used to process the data set in which you are creating records. It cannot be used to process the copybook or template that you are using to format the 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

ISPF Packing
Determines whether or not the output records are created in ISPF PACK format.
1 None
The output data set is written without ISPF packing.
2 Pack

Child panels

Equivalent functions

Related tasks and examples