Setting Up Gateway Logging

Gateway logging is used to monitor the activities of the gateway. You can configure which gateway actions are logged. They are then written to a log file. The log file is named after its creation time stamp, but you can configure its exact format.

You can set up the logging in profile parameter gw/logging or in the gateway monitor (transaction SMGW ). We recommend the following configuration for the gateway monitor.

1. Call the gateway monitor (from the menu or in transaction SMGW )

2. Choose  Goto  Expert Functions  Logging .

3. Define a name for the log. To do this enter a name in the File Name field where you can set the specified time stamp variables. The default setting is gw_log-%y-%m-%d . The file will then be called gw_log-2007-06-19 .

4. Choose the gateway actions that you wan to log in the log file. You can select the following types of gateway actions:

   Gateway Action	Description (actions logged)	Indicator in the Log File
   Network	Network actions, opening and closing network connections	T
   Start/stop/signals	Receipt of start and stop commands or other (operating system) signals	X
   Security	Security setttings and their changes (reloading files). For more information: Security Settings in the Gateway	S
   Monitor commands	Administration command that the gateway receives from the gateway monitor ( SMGW or externally gwmon)	M
   Create/delete Conversation IDs	Creates new conversation IDs, deletes conversation IDs	V
   Open RFC connection	Creates new RFC connections	O
   RFC actions (open/close/send/receive)	RFC actions: Opens and closes connections, sends and receives data	C
   External Programs	Launching of external programs. For more information: Making Security Settings for External Programs	E
   Registered programs	Registration and deregistration of servers. For more information: Making Security Settings for External Programs	R
   Dynamic parameter changes	Changes profile parameters in productive operation For more information: Parameterization of the Gateway	P

5. Choose the Toggle Criteria (in the lower section of the screen). You can configure the following:

   • Time-Controlled Toggle : You can specify a time period after which a new file is opened. Possible values are no toggle, and toggle after one hour, one day, or one year.

   • Maximum File Size (kByte) : You can set the maximum size of the file (specified in kilobytes). If the log file exceeds this size, the file is closed and a new one opened. A new file name is assigned provided you use the timestamp variables when you name the file (see above).

   • Specify Old File : You select this checkbox to prevent a new file being created. The old file is then overwritten when the time-controlled toggle condition is applied or when the maximum file size is exceeded.

6. Select to accept your settings.

The log file is created, and further files are written depending on the settings. The files can be found in the work directory of the instance.

You can see existing log files at the top next to the name of the log file. To look at the file, choose .

If you select gateway actions Start/Stop/Signals , Security and Dynamic Parameter Changes for logging, and you use the standard setting for the file name, you will get, for example, file gw_log-2007-10-10 with the following content: