Print Utility panel

The Print Utility lets you print sequential, partitioned data set members, VSAM files, or HFS files in a selected format.

Panel and field definitions

Figure 1. Print Utility panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Z Data Tools                    Print Utility

 Input 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         
    Print count . . . . . . ALL          number of records to be printed

 Copybook or Template:
    Data set name . . . . .                                                
    Member  . . . . . . . .              (Blank or pattern for member list)

 Processing Options:
    Print Option      Copybook/template/access      Enter "/" to select option
    1  1. Char        3  1. Above                      Edit template    Type (1,2,S)
       2. Hex            2. Previous                   Batch execution
       3. Sngl           3. None                    /  Use proc         
       4. Tabl           4. Physical Blk/CI Access     REXX member selection: P
    ISPF Packing         5. Create dynamic             Advanced member selection
    1  1. Unpack      MQ Processing                   Additional print options
       2. None          Include Descriptors           Binary mode, reclen      
       3. Skip

 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, 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.

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
Specify a volume serial number if the data set is not cataloged.
Start key
The starting key or slot location for a VSAM file
Skip count
The number of records to be skipped before processing begins
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.

Print count
The number of records to be printed
Copybook or Template: Data set name and Member
These fields identify either a copybook or a template to be used to select records and format the print output. If a copybook is specified, it is compiled to create a temporary template that can optionally be saved if edit was requested.
Print Option
The format of the printed output:
CHAR
Records are printed in character format.
HEX
Records are printed in hexadecimal format. The DUMP processing option on the Set Processing Options panel determines how HEX data is printed. See Set Processing Options panel.
SNGL
Single record format (one field on each line of the display). The left-hand side of the printout contains the field or header names. The right-hand side contains the field values formatted according to the field type. A template is required for this option.

In this print format, additional field information (redefined fields, field reference number, field type and length values, picture clause, start location, structure) can be printed depending on the editor options. Numeric fields can be left-justified depending on the options.

TABL
Tabular format (fields printed across the display). The records are displayed in columns with field or heading names as column headers and the data formatted according to the field types. In this format, the display might be truncated depending on the current print width. A template is required for this option.
Copybook/template/access
Use this option to specify if you want to use a template, or how records are to be printed.
Above
Z Data Tools uses the template specified on the panel. (If you specified a copybook, then Z Data Tools compiles the copybook 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, a message is displayed and processing continues without using a template.
None
Z Data Tools does not use a template. SNGL and TABL print formats are not available.
Physical Blk/CI Access
Records are printed by physical block (non-VSAM) or by control interval (VSAM).
Create dynamic
Z Data Tools creates a dynamic template. You can now define fields and field creation attributes.
MQ processing
Include Descriptors
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.

Edit template
Z Data Tools opens the template you have specified for editing, before processing the panel.
Note: For details about using templates, see Creating and editing 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.

Batch execution
Z Data Tools generates JCL to run the function in batch and then displays the JCL for editing. Use Set Batch Job Card Information (option 0.4) to tailor the default JOB card that Z Data Tools uses to generate the JCL. See Set batch job card information (option 0.4).
Use proc
Use this option to specify a procedure to search and change the data, rather than using the Find and Change commands. When you select the option, you can perform either of these actions
  • Choose to create a temporary procedure for one-time use by entering a single asterisk (*). Z Data Tools displays an Edit panel, in which you can create the 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.
Note: If you select this option but leave the Use proc member entry field blank, Z Data Tools displays a member name list. You can then select the required member by entering S in the Sel field.

(Also, see Supplying a procedure when using a Z Data Tools panel.)

REXX member selection
Enter “/” to use a REXX procedure to determine if a member should be copied.

If this option is selected, the Use Proc option must also be selected and a REXX procedure supplied. You can optionally specify the default action to be applied in the event that 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.

Advanced member selection
Enter "/" to specify a range of members to be selected rather than a specific or generic member name.
ISPF Packing
Provided that the data set is a sequential, PDS or PDSE file and an I/O exit routine is not used, one of these options can be used to control the print behavior when processing data that is in ISPF PACK format.
1. Unpack
If the data set is packed, it is unpacked before printing.
2. None
No checking or processing of ISPF packed data occurs. Packed records are processed and printed in packed format. This option is forced if an I/O exit has been used.
3. Skip
If the input data is packed, no processing or printing occurs.
Additional print options
Displays the Print Options panel allowing you to specify additional print options.
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

Related tasks and examples