Saving Your Report Output


The following commands extract and save report output in a variety of file formats:

Tip: When saving or holding output files, it is recommended to have an Allocation in place for the file. This is not applicable for PCHOLD files.

Naming and Storing Report Output Files

During a session, a report output file remains usable until it is erased or overwritten. A subsequent output file created during the same session replaces the initial version, unless you give it another name by using the AS phrase.

A FILEDEF command is automatically issued when you create an output file. The ddname used to identify the file is the same as the name of the report output file (HOLD, SAVE, or SAVB, or the name in the AS phrase), if not already allocated.

By default, report output files created with HOLD, SAVE, or SAVB are written to temporary space. When the session ends, these files are no longer available unless you save the output to a specific location.

To save report output files to a specific location, use an ALLOCATE or FILEDEF command. For details, see Saving and Retrieving HOLD Files. You can dynamically allocate an output file using the DYNAM ALLOCATE or TSO ALLOCATE command in z/OS.

For details, see the Developing Reporting Applications manual.

When you create a HOLD file using the syntax ON TABLE HOLD AS name, the name can contain up to the maximum number of characters supported by your operating system. For information, see the section Naming a Master File in the Describing Data With WebFOCUS Language manual.

While a numeric name or a name beginning with a number is valid on many operating systems, such names are discouraged because they:

  • Cause errors (FOC14069) when a request attempts to access data using a SUFFIX=EDA synonym that points to a file starting with a number. (Note that a SUFFIX=EDA synonym is created by the Adapter for Remote Servers.)
  • May cause problems when an external application (such as an API application) that does not accept files starting with numbers interacts with a SUFFIX=EDA synonym that points to a file starting with a number.
  • May be problematic to a third party application that does not work with numeric file names or with file names that begin with numbers.