Tracing Infoprint Server

The service representative in the IBM® Support Center might ask you to run a trace to aid in diagnosing a problem. If so, the representative will tell you how and where to send the trace information. You do not have to interpret the trace. Send it to your service representative.

These z/OS UNIX System Services environment variables control tracing:

AOPTRACEON

Set this variable to any value to turn tracing on. Unset this variable to turn tracing off.

Tip:

Setting this variable to any value, even to Off, turns tracing on.

Examples:

AOPTRACEON=1
AOPTRACEON=ON

If AOPTRACEON is turned on, Infoprint Server traces all daemons that were started after the variable was set. Tracing Infoprint Server daemons explains how to limit the trace to a specific Infoprint Server daemon.

Depending on the Infoprint Server component you are using, you can add these environment variables to scale the size of the trace:

AOPTRACEON_DATA

Includes socket data in the trace. The default is off.

AOPTRACEON_FILTER

Includes IP PrintWay™ extended mode filter data in the trace. The default is off.

AOPTRACEON_MSGLOG

Includes message logging data in the trace. The default is off.

Examples:

AOPTRACEON=1 AOPTRACEON_DATA=1
AOPTRACEON=ON AOPTRACEON_FILTER=1
AOPTRACEON=ON AOPTRACEON_MSGLOG=ON

AOPTRACEBYTES

Specify the maximum size of the trace file. This environment variable is optional. The default is 50 MB. If the size of the trace file exceeds the maximum size you specified, Infoprint Server creates a new trace file.

Example: AOPTRACEBYTES=25

AOPTRACEDIR

Specify the directory where trace files are created. This environment variable is optional, except if you are tracing Infoprint Central. If this variable is not defined, trace files are created in default directory /var/Printsrv/trace/.

The requirements are:

Except for Infoprint Central

The AOPADMIN group must have permission to write to the specified trace directory.

For Infoprint Central

The user ID of the user who starts the z/OS® HTTP Server must have permission to write to the specified trace directory, and the trace directory must exist.

Example: AOPTRACEDIR=/mydirectory/trace

AOPTRACEMAXFILES

Specify the number of trace files to be kept for each instance of a process. This environment variable is optional. The default is 2 per process. If the number of trace files exceeds the number you specified, Infoprint Server deletes the oldest file. Each time you stop and restart Infoprint Server, it resets the number of trace files for each daemon.

Example: AOPTRACEMAXFILES=5

Tips:

• Tracing slows performance considerably. Turn tracing on for only as long as necessary to capture the error.
• If you want all trace files to be created in the same directory, either do not specify the AOPTRACEDIR variable (all trace files are created in the default directory), or specify the same directory in both the aopstart EXEC and any other process you are tracing.
• To find out if the AOPTRACEON variable is set in the z/OS UNIX shell, use the z/OS UNIX export and grep commands to look at the value of the AOPTRACEON variable:

  export | grep AOPTRACEON
   

  Results:
  • If AOPTRACEON is not set, the export and grep commands do not return any output.
  • If AOPTRACEON is set, the export and grep commands return the AOPTRACEON value or AOPTRACEON="".