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:
- Go to the IBM WebSphere InterChange Server Connector Tools window (transaction
YXR1)
- From the Customizing menu, click Log, and then click Logging
Options.
- Under Logging Level, select from the levels 0 - 3. The four
levels of logging are as follows:
- 0 -- Off
- 1 -- Log only warnings and errors
- 2 -- Log every event with minimal information
- 3 -- Log each event in detail, including every attribute
of every business object
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:
- Go to IBM WebSphere InterChange Server Connector Tools window
(transaction YXR1).
- Click the Display Log button, or from the Tools menu, click
Display Log (F8).
- Green--indicates a successful event
- Yellow--indicates a warning message
- Red--indicates an error
- White--indicates an archived object
- Magenta--provides information on the beginning and end
of the event.
- 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.
- Click the Filter Data button.
- Populate the appropriate fields to filter the log file.
- 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:
- Go to IBM WebSphere InterChange Server Connector Tools window
(transaction YXR1).
- Click the Display Log button, or from the Tools menu, click
Display Log (F8).
- Click the Log Options button or from the Goto menu, click Log
Options (F7).
- 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.
- 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:
- From the System menu, click Services, click Jobs, and then click
Define Job (transaction SM36).
- 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.
- Specify the start date and frequency of the job by clicking
the Start Date button.
- 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.
- 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.
- 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.
- 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.
- Click the green back arrow.
- Click the save button, and then click the green back arrow.
Your job is now scheduled.
To view your truncation job:
- From the System menu, click Services, click Jobs, and then click
Job Overview (transaction SM37).
- 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.
