VPRINT (VP)
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.
Use the following TSO commands to allocate FAPRINT:
TSO ALLOC FI(FAPRINT) DA(dataset-name)
To free FAPRINT, use:
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).
Print Parameters Screen
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
COMMAND ===>
Number of lines/page ===> 55 (0 = Suppress page headings)
Sysout class ===> A
Number of copies ===> 1
Truncate for VPRINT cmd ===> Y (Y or N)
Enter One of the Following Optional Destinations:
Destination printer ===> (Local or remote printer)
- - - OR - - -
External JES Node ID ===> (Predefined JES Node and symbolic ID
Target VM/TSO ident ===> of intended receiver of output)
- - - OR - - -
Sysout writer name ===> (Installation assigned output writer)
- - - OR - - -
(DSORG=PS; RECFM=VBA; LRECL=187)
Print dataset name ===>
Disposition ===> OLD (NEW; SHR; MOD; OLD)
Volume serial ===>
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 .
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 Dataset Attributes Specification Screen
COMMAND ===>
Print Dataset Allocation Information:
Generic unit ===>
Space units ===> (BLKS; TRKS; CYLS)
Primary quantity ===> (In above units)
Secondary quantity ===> (In above units)
Use ENTER to print, END to cancel
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.