Vertical format print (VPRINT) JCL specification

The following figure is displayed when you select the vertical print format in the Print Data File screen or issued the VPRINT NOTRUNC command in a Browse or Edit session. It enables you to specify additional print options, JOB Statement Information for the File Contents Report and the following primary commands:

JCL

Use the JCL command to display a PDF Edit screen where you can edit the generated JCL before you submit it.

SUBMIT

Use the SUBMIT command to submit the batch job.

END

Use the END command to return to the Print Data File screen without submitting the print job.

VPRINT - JCL Specification Screen

File-AID ---------------- VPRINT - JCL Specification --------------------------
COMMAND ===>

Output Format        ===> P         (P = Print; F = File)
Records to print     ===> ALL       (number to print; ALL)

PRINT - Output Format Options:
  Page Order         ===> 1    (1 = Across then down; 2 = Down then across)
  Even pages per set ===> N    (Y = Yes; N = No)
FILE - Output Format Options:
  Dataset name       ===>
  Disposition        ===>         (NEW; SHR; MOD; OLD)
  Headers            ===> Y       (Y = Yes, N = No)

Specify Batch JCL Information:
  SYSOUT class     ===> *

JOB Statement Information:
  ===> //USERID9A JOB (ACCOUNT),NAME
  ===>
  ===>
  ===>
Use JCL command to edit generated JCL; SUBMIT command to submit batch job
Use END to return to main PRINT panel without submitting job

Field Descriptions

Output Format

Specify the desired output format, Print or File format:

The Print format prints the data on multiple pages if the requested data exceeds the page width (132 characters); data will not be truncated. Print format is available in two different sequences; see Page Order for available options.

The File format prints the record in the length of the output data set. Each record prints on a single line without page breaks. If the length of the output data set is not wide enough to print all of the fields, the data will be truncated.

Records to print

Specify how many records to print:

ALL

ALL prints all records (default).

(n = 0-999999999) Specify the number of records you want printed. Output is limited to the number of records you specify. 0 is treated as "ALL". The Records to print value is only valid when Selection criteria usage is No.

Important

If you entered a VPRINT NOTRUNC command in a Browse or Edit session with a number of records to print parameter and no selection criteria active, this field is prefilled with the records to print value.

PRINT - Output Format Options:

Page Order

The Page Order parameter determines the order in which the continued pages are written.

"Across then down" prints all of the record fields first (across), then continues with the next set of records (down). When, for example, all fields of a record set span 3 pages across, pages 1.1, 1.2, and 1.3 print first, followed by pages 2.1, 2.2, and 2.3 for the the next set of records down, and so on. See File Contents Report — VPRINT Across then Down - Page 1.1 and File Contents Report — VPRINT Across then Down - Page 1.2 for a sample output.

A set of records is as many records as requested in the lines per page parameter. Each line includes however many fields will fit on the line. Next, as many additional pages as are required to print the rest of the fields in those same records will be printed. Once all the sections of the first set of records have been printed, the process will be continued for the next set of records.

""Down then Across" prints the first page of all records first (down), then continues with the second page of all records (acrcoss). When, for example, all fields of a record set span 3 pages across and 3 pages down, pages 1.1, 2.1, and 3.1 print first, followed by pages 1.2, 2.2, and 3.2, then 1.3, 2.3, and 3.3 for the the next set of records down. See File Contents Report — VPRINT Across then Down - Page 1.1 and File Contents Report — VPRINT Across then Down - Page 1.2 for a sample output.

In other words, "Down then Across" prints the first page for a set of records; followed by the first page for the next set of records for as many pages as are required to print the entire file. Next, the second section of every record would be printed and so on until all the sections of every record have been printed.

Even pages per set

This parameter manages output for double sided printing. When set to Yes, a blank page is inserted following the set if the number of pages is an odd number. The meaning of set differs based on the page order chosen for the report.

When “Across then Down” is chosen, a set is all the continued pages required to print the records. For example, if the fields being printed required three pages to print these three pages would be printed consecutively and would be numbered 1.1, 1.2 and 1.3. When EVEN=YES is specified, page four would be left blank and the next group of records would start on page 5. With two sided printing this would cause page 1.2 to be printed on the back of page 1.1 and the blank page would be on the back of page 1.3. Page 2.1 would then be on the front on the next page rather than being on the back of page 1.3.

When “Down then Across” is chosen, a set will be all the pages required to print the first page of all the records (all the pages numbered n.1). When EVEN=YES, a blank page will be inserted if the number of pages is an odd number so that page 1.2 and page 1.3 will start on the front of the print page.

FILE - Output Format Options:

Dataset name

Specify the data set where the File output is to be written. The data set must be sequential with the record format FB, and record length (LRECL) long enough to accomodate all fields including headers and field seperators to be printed.

Important

If LRECL is not long enough to accommodate the fields being printed, the print job completes with MAXCC=8. The records are truncated to the record size of the output file and an error message indicating the minimum LRECL is issued at execution time. To avoid truncation, re-execute and specify the minimum LRECL that was identified in the message.

If the LRECL is longer than the minimum LRECL, the print job completes with MAXCC=4 and an informational message indicating the minimum LRECL is issued. To avoid wasted space, re-execute and specify the minimum LRECL that was identified in the message.

Disposition

Specify a disposition for the print data set. If the data set is NEW the Allocate New Dataset panel displays so you can specify allocation parameters:

MOD

Modified, add on to end.

NEW

New.

OLD

Old, exclusive serialization.

SHR

Share -- old, share serialization.

Headers

The Headers option only applies to the File format. Specify whether the Heading records shall be included as the first records on the file or not.; these headers will only be included once.

Yes outputs the Heading records (field names) as the first records on the file; these headings are only output once at the top of the file.

No eliminates the heading records from the file.

Specify Batch JCL Information:

SYSOUT class

Enter the sysout class for the File Contents Report. Refer to File Contents Report for a description of the report.

JOB Statement Information

Specify your job statement information.

Printing Unicode Data

Use the CCSID parameter when printing Unicode data to specify the code page to be used. Manually add the parameter to the print JCL to override the default CCSID, for example:

$$DD01 VPRINT SHOW=F,LAYOUT=NATL,OUT=0,TRUNC=NO,
FILLER=ON,ZERO=OFF,CCSID=0500