FPRINT (FP)
The FPRINT command prints the current record and any number of subsequent records formatted according to the current display setting. You can send output to SYSOUT or a data set.
The FPRINT command is available in the Browse and Edit functions in Formatted mode.
number
Specifies the number of records to print. The default is 1 (one). 0 (zero) prints the current and all subsequent records in the file.
ALL
Prints the current record and all subsequent records in the file. For example, use the following command sequence to print fields 5, 7, and 8 in all records:
- SHOW NUMBER (to number each field)
- DISPLAY 5 7 8 ONLY
- BACK M
- FPRINT ALL.
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 following figure is displayed, when you issue the FPRINT 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 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
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.