Managing Message Logging

Message logging records the following information for messages that pass through the integration gateway:

Time and date.
Message description.
Content of the passed message object.
Message level.

The default location of the integration gateway message log is <PIA_HOME>\webserv\<DOMAIN>\applications\peoplesoft\PSIGW.war\msgLog.html.

Change the location of the log in the integrationGateway.properties file.

Message Logging in Target Connectors

Message logging in a target connector occurs:

Before delivering the request to the external system.

The connector logs the request in the format in which the external system delivered it. For example, an HTTP target connector logs the exact HTTP output stream request. The PeopleSoft target connector logs the MIME request to be sent to the integration engine.
After it receives a response from the external system.

The connector logs the response in the format in which it receives it. For example, an HTTP target connector logs the exact HTTP input stream response. The PeopleSoft target connector logs the MIME response that it received from the integration engine.

Message Logging in Listening Connectors

Message logging in a listening connector occurs:

At the point where the request enters the system.

The connector logs the request in the format in which the sending system delivers it. For example, the HTTP listening connector logs the exact HTTP input stream request. The PeopleSoft listening connector logs the MIME request that it received from the integration engine.
Following the delivery of a response to the requestor system.

The connector logs the response in the format in which it was delivered. For example, the HTTP listening connector logs the exact HTTP output stream response. The PeopleSoft listening connector logs the MIME response that it sent back to the integration engine.

Message Logging Methods and Parameters

Invoke the logMessage method for integration gateway message logging:

logMessage(String Description, Object message, int MessageLevel)

Use the following parameters:

Parameter	Description
Description	Specify a description as a string.
Object	Specify the message object. Typically this object is an IBRequest or IBResponse. If another object is passed, the toString method is invoked for the object, and the result is logged.
MessageLevel	Set the relative importance of the information that you are logging. The ig.log.level property setting in the integrationGateway.properties file determines the log level that is currently in effect. If the MessageLevel value that is passed here is less than or equal to the ig.log.level property setting, the message is written to the log file. Values are: 3: Important information. 4: Standard information. 5: Low-importance information. The ig.messageLog.filename property in the integrationGateway.properties file determines the log file location.

Parameter

Description

Specify a description as a string.

Object

Specify the message object. Typically this object is an IBRequest or IBResponse. If another object is passed, the toString method is invoked for the object, and the result is logged.

MessageLevel

Set the relative importance of the information that you are logging. The ig.log.level property setting in the integrationGateway.properties file determines the log level that is currently in effect. If the MessageLevel value that is passed here is less than or equal to the ig.log.level property setting, the message is written to the log file.

Values are:

3: Important information.
4: Standard information.
5: Low-importance information.

The ig.messageLog.filename property in the integrationGateway.properties file determines the log file location.