LANSA for Windows Printing Enhancement to direct output to a file

Date: 2 May 1997
Product/Release: LANSA for Windows
Abstract: LANSA for Windows reports can be directed to a file rather than just to a printer
Submitted By: LANSA Technical Support
Last Review: November 2010

The ability to keep the results of printing a report in an RDML function in a file, instead of them being simply sent to the printer port is commonly required. This allows subsequent modification by a word processor, or backup after printing etc.

In Release 6.5 and earlier, LANSA-produced reports were created in a temporary file, then copied to the printer port specified in the PRTR= parameter of the X_RUN command when the report was closed. The temporary file was then deleted. What was required was a way to keep this temporary file for subsequent modification.

From Release 7.0, this is implemented by doing the following:

  • Use the special value in the X_RUN PRTR= parameter of *PATH. This indicates that reports are to be directed to a file rather than to a printer port.
  • Use the new X_RUN argument PPTH= which is the fully qualified directory for printer files when PRTR=*PATH. The default for this parameter would be x_lansa\x_ppp on the DRIV= path where ppp = current partition.
  • When the printer file is opened, if PRTR=*PATH, rather than creating a temporary file to hold the report details, it opens a new file in the PPTH= directory. The name of the file will be fffffff.nnn where fffffff = function name (valid file name form and lowercase) and nnn = next consecutive number for this function.

For example, an RDML function called PCXDEMO1 might have three reports. These reports would produce files called PCXDEMO1.001, PCXDEMO1.002 and PCXDEMO1.003 in the PPTH= directory. If the same function was run again it would produce reports called PCXDEMO1.004, PCXDEMO1.005 and PCXDEMO1.006 in the PPTH= directory.