17.1 Reporting Considerations

When working with reporting functions with Visual LANSA you should be aware of the following:

• Output for reports will be directed to the printer port specified by the X_RUN parameter PRTR unless the special value PRTR=*PATH is specified.

• If the special value PRTR=*PATH is specified output for reports will be directed to files in the directory specified by the X_RUN parameter PPTH.
  
  The name of each report file will be:
  fffffff.nnn
  
  where
  fffffff is the function name (in a valid filename form)
  nnn is the next consecutive number for this function in this directory. There can be a maximum of 999 report files in the PPTH directory for any one function at any time.

For example, a reporting function named FREPORT might output three reports. Executing this function would produce files FREPORT.001, FREPORT.002 and FREPORT.003 in the PPTH directory. If the same function is executed again it would produce files FREPORT.004, FREPORT.005 and FREPORT.006, and so on until previous FREPORT.nnn files are deleted.

Refer to the topic Using the X_RUN Command for details of the X_RUN parameters PRTR and PPTH.