Defining Functions › Function Types, Message Types, and Function Fields › DFNRPTFMT Device Function

DFNRPTFMT Device Function

The Define Report Format (DFNRPTFMT) function defines a standard report header and footer for your Print File report functions.

A default DFNRPTFMT function is shipped with CA 2E to define standard header/footer formats for device function report designs. You can modify the shipped version or add your own DFNRPTFMT functions for use in specific function report designs. Any new report device function created by CA 2E uses the shipped DFNRPTFMT function by default, unless you nominate a different default. To use your own DFNRPTFMT, you can change the DFNRPTFMT for any report function using the Edit Function Options panel.

The fields that can be included in the design of a DFNRPTFMT function are included in the CA 2E shipped file called *Standard header/footer.

Attach the DFNRPTFMT function to the physical (PHY) file access path of the *Standard header/footer file.

This function type does not allow parameters. It does not have an action diagram.

By default, the header format for the report starts on line one. This value can be changed using the Edit Device Format Details panel.

The shipped standard report page header is for a report that is 132 characters wide. To define a DFNRPTFMT function with a different report width, specify a different value for the PAGESIZE parameter on the overrides to the i OS Create Print File command (CRTPRTF) for the function. You do this using the overrides prompt available from the Edit Function Details panel (F19 function key).

Use the function options for the DFNRPTFMT function to set the default header to be used by newly created report functions.

The fields of the header are shown in this example in two lines (in practice, the header extends beyond the limit of one panel).

Note: Any changes that you want to make to a report header and footer of a report function must be made by modifying the DFNRPTFMT function associated with the function. The header fields of report formats shown on the report function itself are protected.

For more information on the function options available, see Identifying Standard Header/Footer Function Options in the chapter, "Modifying Function Options.".