Turning tracing on

You turn tracing on by setting the AOPTRACEON environment variable. This section shows how to set the AOPTRACEON environment variable in an STDENV data set that the AOPSTART JCL procedure points to.

Tracing slows performance considerably. You should turn tracing on for only as long as necessary to capture the error.

Tip: To find out if the AOPTRACEON environment 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

:

• 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="".

To turn tracing on:

1. Specify the AOPTRACEON environment variable in the STDENV data set of the AOPSTART JCL procedure:
   1. Create an MVS™ data set, such as TRACE.ENV, with these DCB attributes:
      • RECFM=VB
      • LRECL=255

      _______________________________________________________

   2. In the data set, specify the AOPTRACEON variable. Start in the first column, and do not code any blank characters in the string or at the end of the line:

      AOPTRACEON=1

      _______________________________________________________

   3. Specify the TRACE.ENV data set in the AOPSTART JCL procedure:

      ///STDENV DD DSN=TRACE.ENV,DISP=SHR

   _______________________________________________________

2. (Optional) Change the name of the trace directory in the AOPTRACEDIR environment variable in the aopstart EXEC. The AOPADMIN group must have permission to write to the specified trace directory.

   _______________________________________________________

3. Enter the MVS START command to run the AOPSTOP JCL procedure to stop Infoprint Server:

   START AOPSTOP

   _______________________________________________________

4. Enter the MVS START command to run the AOPSTART JCL procedure to restart Infoprint Server:

   START AOPSTART

   _______________________________________________________

Related information:

• Environment variables for tracing
• Creating an STDENV data set
• Editing the AOPSTART JCL procedure