Passing information to and from the exit routine

To format the data returned from the database, QMF calls your edit exit routine and passes information through fields of the interface control block. Information is also passed to and from the exit routine using the input and output areas, which contain the database data to be formatted and information about where to put the formatted result.

The data to be formatted can be a column value, the result of a built-in function, a defined column, a calculation, or a value represented by a variable in a heading, a footing, or a final-summary line.

Upon receiving control for formatting, your edit routine takes the parameters in the following list.

• The interface control block.
• The value of ECSINPT, the data from the input area to be formatted.
• The value of ECSRSLT, the output area containing the formatted result. ECSRSLEN contains the amount of storage actually passed to this output area on each call. The result cannot be column wrapped.

  Important: Do not use more memory in the output area than is indicated in the ECSRSLEN field, or you will see QMF error DSQ60439 - User edit program memory overwrite.

  User edit programs may require modifications. To correct this application error, do one of the following:

  • Increase the WIDTH of the COLUMN by modifying the edit code in the FORM to the correct length expected on the report.
  • Check the length of ECSRSLEN to determine if your program should PAD or TRUNCATE the results passed back to QMF.

  ECSINPT, ECSRSLT, and ECSRSLEN are fields of the interface control block, explained in Table 69.