FPRINT (FP) parameter


The FPRINT parameter prints records in formatted mode, presenting the data according to a COBOL or PL/I record layout, like the formatted display of File-AID. Meanwhile, the primary function continues to process the data set. You must supply a //DDxxRL DD in the JCL, and the LAYOUT or MAP parameter in the control cards, to identify the layout member name to use for the formatted print.

Layout appearance can be controlled with the optional SHOW parameter. SHOW=FORMAT, SHOW=NUMBER, SHOW=OFFSET, and SHOW=PICTURE are valid options for the SHOW parameter.


Important

Do not use the FPRINT parameter with the DUMP, LIST, PRINT, FPRINT, or VPRINT function.

The syntax of the FPRINT parameter is:

FPRINT={number}

number

Number from 0 (zero) to 999999999 specifying the number of records to print. Printing of records can be based on one or more data selection parameters. Use FPRINT=0 to print all selected records in formatted mode.

Example FPRINT output is shown in FPRINT Request.

Example:

$$DD01 COPY FPRINT=15,MAP=SMFA,SHOW=OFFSET

This example copies the input dataset while printing the first 15 records, formatted according to the record layout in the SMFA member in the DD01RL DD.


Note

  • If the DDxxXR is present to identify a File-AID XREF member, each record type is automatically formatted using the record layout in the DDxxRL member as specified in the XREF logic.
  • 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 installation options are set as described in the Installing and Configuring.

  • The FPRINT function does not list redefinitions.

 

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