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.
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.
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.
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.
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.
