VPRINT (VP) function

The VPRINT function prints records in vertical formatted mode, presenting the data according to a COBOL or PL/I record layout like the vertical formatted display of online File-AID Browse or Edit.

The VPRINT report output width is 132 characters. The report format includes spaces separating the fields. When the VPRINT output exceeds the report width, File-AID writes the VPRINT DATA TRUNCATION informational message, VP001-Data truncation occurred while processing VPRINT request to the SYSPRINT log. Use the FIELDS parameter to specify which fields to include in the VPRINT output. See FIELDS.

Important

Use File-AID Option 5.1, Print Data File, to print the contents of a data file in vertical format without data truncation.

Example VPRINT output is in VPRINT Request.

The SHOW parameter controls the format of the column headings presented for each layout field. SHOW=FORMAT, SHOW=NUMBER, SHOW=OFFSET, and SHOW=PICTURE are valid options for the SHOW parameter.

Use parameters to control the number, or selection, of records to print. When no limiting parameters are specified, an installation default maximum of 250 records is printed in vertical format mode. This default prevents you from accidentally generating a large volume of print. Use the OUT=n parameter to override the default.

You must supply a DDxxRL DD JCL statement to define a record layout. Use the LAYOUT or MAP parameter to specify the DDxxRL dataset member containing the source record layout.

Example:

$$DD01 VPRINT OUT=20,LAYOUT=EMPLOYEE,FIELDS=(1-3,6,10)

This example prints the first 20 records in vertical formatted mode, using the EMPLOYEE layout from the DD01RL DD. The FIELDS parameter specifies to include only field numbers 1,2,3,6, and 10 in the output.

Important

  • Installations using alternate copy libraries, such as LIBRARIAN and PANVALET, and installations using Hiragana, Katakana, or Kanji character sets are supported only when the appropriate File-AID/Batch configuration parameters are set. For more information, see File-AID/MVS Product Configuration.

  • The VPRINT function does not list redefinitions.
  • File-AID only allows for one OCCURS DEPENDING ON (ODO) in the record layout and it must be the last item in the record layout. Otherwise, File-AID would not be able to produce column headings appropriate for every record.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*