Managing the connector log file

The connector log in the SAP application displays in reverse chronological order all events and errors that relate to the connector, such as Create or Update operations or events that arrive in the event queue. The log file lists the date, time, and event for each log entry. The log file is a good source to start troubleshooting problems.

Setting log options

You can set the global and user settings to the level of detail you want logged in the connector log file, as well as the number of entries and type of data you want displayed. To set the connector logging levels:

  1. Go to the IBM WebSphere InterChange Server Connector Tools window (transaction YXR1)
  2. From the Customizing menu, click Log, and then click Logging Options.
  3. Under Logging Level, select from the levels 0 - 3. The four levels of logging are as follows:
    Note:
    Logging level 0 is not recommended. Logging level 1 is recommended for a production system. Logging level 3 is recommended for a development or debugging system.

Displaying the log

To view recently processed objects and details associated with them, display the connector log. To display the connector log in the SAP application:

  1. Go to IBM WebSphere InterChange Server Connector Tools window (transaction YXR1).
  2. Click the Display Log button, or from the Tools menu, click Display Log (F8).
  3. Click on any arrow to link to SAP's display transaction for that business object.

You can change the amount of detail that is displayed about each event. To change the display level, click the More Details or Fewer Details button depending on the level of detail desired.

Filtering log details

You can change the amount of detail that is displayed about each event. If the amount of data displayed is more than you currently need, narrow the information displayed. For example, you can view business objects by user, name, date, or event number.

  1. Click the Filter Data button.
  2. Populate the appropriate fields to filter the log file.
  3. Click Filter.

In the Logging Options screen, you can set user settings for the number of log entries to display at one time and the default logging display level.

Setting up truncation of the event log

SAP keeps an event log of the connector's activity. This log can, over time, take up a lot of disk space. To save disk space, you can set this log to automatically truncate. When you set automatic truncation, by default SAP prints the truncated entries to the default printer of the user who sets up the job. Therefore, you may also want to control the print options.

To set truncation options:

  1. Go to IBM WebSphere InterChange Server Connector Tools window (transaction YXR1).
  2. Click the Display Log button, or from the Tools menu, click Display Log (F8).
  3. Click the Log Options button or from the Goto menu, click Log Options (F7).
  4. Under Global Settings (for all users), enter the number of log entries you want kept in the log after each truncation. For example, if you specify 1000, then on each log truncation, all entries in the log except for the newest 1000 will be truncated.
  5. To truncate the log immediately, click the Truncate Log button.

Important:
Set up automatic truncation of the event log by scheduling report YXRLOGT. It is recommended that you run this report on a regular basis.

To schedule the YXRLOGT report:

  1. From the System menu, click Services, click Jobs, and then click Define Job (transaction SM36).
  2. Name the job, and specify the class (priority). The target host needs to be filled in only if you have multiple application servers accessing a single database server.
  3. Specify the start date and frequency of the job by clicking the Start Date button.
  4. Specify the frequency with which you would like to run the job. Select the Periodic job check box, click the Period values button, and then select the appropriate button by clicking the Period Values button.
  5. Click the save button twice to get back to the first screen. Define which program is to be run by clicking the Steps button. Schedule ABAP program YXRLOGT. No Variant is needed.
  6. By default, SAP will print the truncated entries in the log to the default printer of the user who sets up the job. If logging is turned high and many events are processed, this printout could be very long (several hundred pages). You can control where the entries will be printed (or whether they are printed at all) by clicking on the Print specifications button.
  7. To deactivate the automatic printing of the truncated log, uncheck the Print immed. check box. This way the printout will be spooled and kept for a default of 8 days, where it could be referenced if necessary, without wasting paper. Now click the Save button twice.
  8. Click the green back arrow.
  9. Click the save button, and then click the green back arrow. Your job is now scheduled.

To view your truncation job:

  1. From the System menu, click Services, click Jobs, and then click Job Overview (transaction SM37).
  2. Type the job name, and then press Enter. If the job is in Released state, it is fine.

Note:
You can access the connector log file by clicking the Connector Log button.

Copyright IBM Corporation 1997, 2004. All Rights Reserved.