FPRINT (FP) function

The FPRINT function prints records in formatted mode, presenting the data according to a COBOL, Assembler or PL/I record layout like the formatted display of online File-AID Browse or Edit. Use the SHOW parameter to control the format of the information presented for each layout field. SHOW=FORMAT, SHOW=NUMBER, SHOW=OFFSET, and SHOW=PICTURE are valid options for the SHOW parameter. Example FPRINT output is in FPRINT Request.

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 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. Optionally, if you want to use a File-AID XREF member to automatically select layouts to format the data, include the DDxxXR DD JCL statement identifying the XREF dataset and member to use. The DDxxRL is still required when using an XREF and it must identify a valid source library not an explicit member.

Example:

$$DD01 FPRINT OUT=20,LAYOUT=EMPLOYEE,SHOW=FORMAT

This example prints the first 20 records in formatted mode, using the EMPLOYEE layout from the DD01RL DD.

Important

  • 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 Installing.

  • The FPRINT function does not list redefinitions.

 

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