Administrator

Agentry messages.log File

The messages.log file contains log items that are related to client-server messaging. Each message and response sent between the Agentry component in SAP Mobile Platform Server and Agentry client is one log item. The information in each item includes the date and time of the message, the Agentry client’s IP address, the type of message or response, and other message information.

The messages log persists until one of the following occurs:
  • The log files are rolled by SAP Mobile Platform Server, at which point they are moved to a backup folder named rolled, in a subdirectory named for the date and time. By default, this occurs once every 24 hours, provided SAP Mobile Platform Server is running. With a change to the application configuration, this file may also be moved to a backup location based on file size.
  • SAP Mobile Platform Server is shut down and restarted. In this case, the messages.log file is moved to the backup folder rolled, in a subdirectory named for the date and time.

The messages.log file cannot be disabled.

Messages Log Format

The following is an excerpt from a typical messages.log file.
I,  9,  1, 10, 09/12/2013 17:11:18,   ,  0, 70,      , ANGEL: B0A6D984-C97B-4275-B7E4-AEB8FC9D5210
Q,  9,  1, 10, 09/12/2013 17:11:18,   ,  0, 70, user1, ANGEL: B0A6D984-C97B-4275-B7E4-AEB8FC9D5210
A,  9,  1, 10, 09/12/2013 17:11:18,   ,  0, 70, user1, ANGEL: B0A6D984-C97B-4275-B7E4-AEB8FC9D5210
S,  9,  1, 10, 09/12/2013 17:11:22, 22, 23, 70, user1, ANGEL: B0A6D984-C97B-4275-B7E4-AEB8FC9D5210
C,  9,  1, 10, 09/12/2013 17:11:22,   , 23, 70, user1, >unknown<
  • Message State: A single character indicating the state of the message in relation to SAP Mobile Platform Server.
  • Message Code: A numeric value that identifies the type of message. See Message Codes for more information.
  • Subsystem Code: Either 1 or 20. This is a deprecated value that varies only for older SAP products built on Agentry 2.0 code libraries.
  • Message Number: A number assigned by the Agentry client that increments for each message sent.
  • Date and Time: The date and time the message was received by the SAP Mobile Platform Server. This is always the date and time of the SAP Mobile Platform Server host system.
  • Response Code: A numeric code that indicates the response to the message. The message codes “S” and “R” each have a different set of possible response codes. For all other message codes, the response code column is blank.
  • Data Sent/Data Received: A running total of the amount of data sent and received by the SAP Mobile Platform Server per message, with a value in bytes.
  • User ID: ID of the user to which the message belongs. It is normal for the user ID to remain blank for messages with a message state of “I”.
  • Client Location: IP address of the client device. It is normal for the client location to be unknown for messages with a message state of “C”.
Table 40: Message States—Synchronous Communication
State Name Description
I Incoming Message is being received from the client.
Q Queued Message is decoded, and placed in an SAP Mobile Platform Server work queue; the user is identified.
A Active A previously queued message is being processed by the SAP Mobile Platform Server.
S Sent Response SAP Mobile Platform Server sent information or an acknowledgment to the client.
R Received Response A client response has been received by SAP Mobile Platform Server.
C Complete Message processing is complete.
Table 41: Push Message States—Asynchronous Communication
State Name Description
O Outgoing Message is being sent to the client.
T Trying SAP Mobile Platform Server is attempting to connect to a client
L Linked SAP Mobile Platform Server has successfully connected to a client.
W Waiting SAP Mobile Platform Server failed in an attempt to connect to a client. It will attempt the connection again.
R Received Response SAP Mobile Platform Server has received a client response.
S Sent Response SAP Mobile Platform Server sent information or an acknowledgment to the client.
C Complete Message processing is complete.
X Canceled SAP Mobile Platform Server canceled the message to the client.
F Failed Message failed. SAP Mobile Platform Server will not retry.
Message codes indicate the type of message being processed or sent, and are found in the Message Code column of the messages.log file.
Table 42: Log Message Codes
Code Description
2 Client logout request
5 Logout Notice
8 Public Key Request
7 Client user password change request
9 Client login request
11 Decrypt Key Request
12 Upload E2E Trace Request
13 Password Validation Audit Record Notice
200 Transaction instance sent to SAP Mobile Platform Server from the client
201 Client has made a fetch processing request
202 Client system information message sent to SAP Mobile Platform Server
203 Client has requested an object be reloaded/refreshed
204 Client has requested the definition of an object
205 Client has requested the definition of a fetch
206 Client has requested the definition of a transaction
207 Client has requested the definition of a screen set
208 Client has requested the definition of an action
209 Client has requested the definition of a rule
210 Client has requested the definition of a report
211 SAP Mobile Platform Server has pushed an object or messages to the client
212 Client has sent an enable push message to SAP Mobile Platform Server for the user
213 Client has requested the definition of a style be sent
622 Client has requested that all complex tables be updated
623 Client has requested that all data tables be updated