The VPRINT command prints the current record and any number of subsequent records in a vertical formatted report. You can send output to SYSOUT, a printer, or a data set.

You can specify one of two output formats, TRUNC or NOTRUNC.

The VPRINT TRUNC online report output width is 120 characters. This is the standard form that has been part of the product prior to Release 9.0.1. The report format includes spaces separating the fields. When the VPRINT output exceeds the report width, File-AID displays the VPRINT DATA TRUNCATION informational message, VP001-Data truncation occurred while processing VPRINT request. Unless you have pre-allocated a print data set (see Preallocating a Print Data set), VPRINT TRUNC continues with the Print Parameters Screen Screen where you specify more output options (see Print Parameters Screen).

The VPRINT NOTRUNC output does not truncate data. The report format includes spaces separating the fields. When the VPRINT output exceeds the page width, File-AID prints the record on multiple pages. If the second "page depth" exceeds the print width, another "page depth" will be printed and so on until the entire record has been printed. VPRINT NOTRUNC continues with the Vertical Format Print (VPRINT) JCL Specification Screen where you specify more output options (see Vertical Format Print (VPRINT) JCL Specification).

Use the FIELDS operand to specify exactly which fields to include in the report.

The VPRINT command is available in the Browse and Edit functions in Vertical Formatted mode.

TRUNC

TRUNC processes the VPRINT request online and truncates each print line if the vertically formatted record exceeds the print width. The default is set in Option 0.3 with the Truncate for VPRINT cmd parameter (see Print Parameters). This is the standard form that has been part of the product prior to Release 9.0.1.

NOTRUNC

NOTRUNC processes the VPRINT request in batch and prints multiple pages if the vertically formatted record exceeds the print width. The default is set in Option 0.3 with the Truncate for VPRINT cmd parameter (see Print Parameters).

If there are HIDDEN or HELD fields, then a FIELDS parameter will be generated so that these fields will be excluded or repositioned. However, ifyou specify a FIELDS parameter in the VPRINT command, then it overrides the one that would have been generated.

VPRINT NOTRUNC also honors your current Edit/Browse settings for FILLER and ZERO:

FILLER=ON, filler fields will be printed.
FILLER=OFF, filler fields will not be printed.

ZERO=ON, numeric fields will be printed with leading zeros.
ZERO=OFF, numeric fields will be printed without leading zeros.

VPRINT NOTRUNC carries over the current terminal CCSID when at least one NATIONAL field will be printed.

number

For VPRINT TRUNC, specifies the number of records to print, starting with the current record. The default is 0 or ALL. 0 (zero) prints the current and all subsequent records in the file.

For VPRINT NOTRUNC, specifies the number of records to print, starting with the first record in the file. The default is 0 or ALL. 0 (zero) prints the first and all subsequent records in the file.

ALL

For VPRINT TRUNC, prints the current record and all subsequent records in the file. Prior records are not printed.

For VPRINT NOTRUNC, prints all records in the file.

FIELDS field-list

Specify any combination of field numbers and/or field number range for the specific fields. (Default is fields currently displayed in your Browse/Edit session). Separate each field number specification by a space or a comma. Specify a range with a hyphen between the starting and ending field numbers. You may specify up to nine field number specifications or 60 characters.

Preallocating a Print Data set

If a data set is preallocated with an FAPRINT DD statement in your logon PROC or if you use a TSO command to dynamically allocate one, the output is automatically directed to this data set.

Tip

Pre-allocating a print data set only applies to VPRINT TRUNC.

Use the following TSO commands to allocate FAPRINT:

TSO ALLOC FI(FAPRINT) DA(dataset-name)

To free FAPRINT, use:

TSO FREE FI(FAPRINT)

The data set used for FAPRINT must be created and cataloged with the following attributes:

RECFM: VBA

LRECL: 187

BLKSIZE: 1874 (or larger to be efficient for the device where the file is created).

The Print Parameters screen is displayed, as shown in the following figure, when you issue the VPRINT TRUNC command and File-AID cannot find a preallocated FAPRINT DD. This screen enables you to specify the number of copies and destination of the print. You can direct the output to a data set by specifying the name of a data set in the Print data set name field. If the data set does not exist, you can specify a disposition of NEW to allocate one.

Print Parameters Screen

Field Descriptions

Number of lines/page

Controls when headings are printed. Specify the number of line per page. If you specify 0 (zero), page headings are not printed. The default number of lines per page is 55, including the page headings.

Sysout class

Specify the output category or output device. You must specify a value.

Number of copies

Specify the number of copies you want printed. A valid value is any integer from 1–9999.

Truncate for VPRINT cmd

Specify whether the default for the VPRINT command in Browse/Edit should be truncate (Y) or no truncate (N - print over multiple pages) if the record to be printed exceeds the page width (120characters). See also VPRINT (VP).

Y - (Default) Truncates the record if the output width exceeds 120 characters.

N - If the output width exceeds 120 characters, the data prints on multiple pages.

Enter One of the Following Optional Destinations:

Destination printer

Specify either the name of a remote printer or the system default printer. To specify the default printer, you can leave the field blank, or specify a value of LOCAL or R0.

External JES Node ID

To route the output across JES nodes, specify the symbolic name of an installation-dependent JES node. This field is required.

Target VM/TSO ident

To route the output across JES nodes, specify either a VM or TSO user ID or the symbolic name specified in the External JES Node ID field. This field is required.

Sysout writer name

Specify the name of an installation-dependent external writer.

Print data set name

Specify the name of the data set to which File-AID can write the print output.

Disposition

Specify a disposition for the print data set:

MOD - Modified, add on to end.

NEW - New.

OLD - Old, exclusive serialization.

SHR - Share -- old, share serialization.

If you specified the name of a data set that does not exist, specify the disposition as NEW and File-AID displays the Print Data set Attributes Specification screen.

Volume serial

Specify the volume serial number of the storage device for a non-cataloged or new data set.

Print Data set Attributes Specification Screen

The following figure allows you to specify additional allocation parameters for your print data set. It is displayed when you specify name of a data set that does not exist and a disposition of NEW on the Print Parameters screen (Print Parameters Screen).

Print Data set Attributes Specification Screen

Field Descriptions

Print Data set Allocation Information:

Generic unit

Specify the device type on which the new data set will reside.

Space units

Specify whether the data set is allocated in blocks (BLKS), tracks (TRKS), or cylinders (CYLS).

Primary quantity

Specify the initial number of space units.

Secondary quantity

Specify the number of space units to be allocated for each secondary extent.