Saving Runtime Information and a Generated PDF Locally 

Use

Form developers and support desk staff can use this function to analyze the causes of any errors that occur when forms are generated. You can save files that contain the following information to your local client:

●      Runtime information (also known as trace information), created by the system when forms are generated

●      PDF with additional information

Once a setting is chosen, the system saves this information for all forms that are generated while the user is logged on.

Integration

You can also get the runtime information directly in the application program that calls the form, using a function module. For more information, see Troubleshooting.

Prerequisites

You have debugging authorization in the system where you want to use this function.

Features

●      Saving runtime information

The system saves the trace information returned by Adobe document services to your local client. This information is a subset of the trace information stored by the J2EE Engine used as a host system for Adobe document services. The detailed trace information is located in the file defaultTrace.trc on the J2EE Engine.

●      Saving the PDF with additional information

The PDF with additional information consists of the generated PDF form or, in the event of errors, an error file. Attached to either of these files are various additional files including, for example, application data (in XML format), sent to the form at runtime, and the runtime information mentioned above. For a detailed description of the information provided by the system, see the section Execution in the problem analysis scenario Adobe Rendering Error (in English only).

●      Saving runtime information and a PDF with additional information for multiple forms

If multiple forms are called in the application program, the information is saved to separate files. An extra sequential number is added to each file, in addition to the existing numbering.

Activities

...

Activating the Function in a Dialog Box

Choose Utilities → Settings.

●      To specify how the runtime information is saved locally, choose an option under Trace Level and enter the name of the file. If you do not specify an extension for the file name, the system saves the runtime information automatically with the extension TXT.

●      To activate the function PDF with Additional Information, proceed as follows:

○       Under Runtime Information → Trace Level, select the option Very Detailed Trace.

○       Select PDF with Additional Information and specify a file name.

When you choose F4 for the file name, you can navigate to your system to choose a file.

Activating the Function in the User Settings

       1.      Call the user profile transaction SU3 or the user maintenance transaction SU01.

Note that you require extra authorizations to maintain other users' profiles.

       2.      Choose the Parameters tab and enter the required parameters and values:

Parameters

Parameter ID	Parameter Value	Meaning
FPTRACELEVEL	04	Sets the trace to the value required for saving runtime information locally and generation of PDFs with additional information.
FPTRACEFILE	<File name>	File for saving runtime information locally (optional)
FPSAVEERRORPDF	X	System creates a PDF with additional information
FPERRORPDFFILE	<File name>	File for saving PDF with additional information locally

This creates a fixed assignment of the values to the user.

You must reset these values after the trace.