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
- 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
- File Manager uses the template specified on the panel. (If you specified a copybook, then File Manager compiles the copybook into a template before use.)
- Previous
- File Manager 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
- File Manager 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
- File Manager 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
- File Manager 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
- File Manager 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 File Manager 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 (*). File Manager 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 FMNEXEC.
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, File Manager displays a member name list. You can then select the required member by enteringS
in the Sel field.(Also, see Supplying a procedure when using a File Manager 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) orD
(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
- Print Options panel
- Personal Data Set List panel (Current® Data Set List option selected from the Process drop-down menu, or REFL fastpath command entered).
- Personal Data Set Lists panel (Personal Data Set Lists option selected from the Process drop-down menu, or REFD fastpath command entered).