Error Analysis 

You can use the following utilities for error analysis:

System Logs

In accordance with the dialog system, the SAP Gateway records system logs for all error situations. You can evaluate the system logs with the usual tools.

Traces

In addition you can record detailed traces. To do this you have to set a trace level in the parameter rdisp/TRACE :

rdisp/TRACE = 0 no trace
rdisp/TRACE = 1 error trace
rdisp/TRACE = 2 complete process trace, short data trace
rdisp/TRACE = 3 complete process trace, short data trace

The traces are to be found in the following files:

Process

Trace File

Gateway read process:

dev_rd

Gateway work process:

dev_wp<No.> (for SNA/DCAM only)

Gateway monitor:

dev_gwmon

All trace lines describing an error begin with ***. All trace lines corresponding to a system log begin with ***LOG, followed by the system log number and the version of the variable parts of the system log.

In BS2000 the traces are written to SYSOUT, providing you have the following parameter setting: bs2/trace to stderr = 1

Return Codes

For troubleshooting purposes, it is often helpful to understand the meaning of the return codes.

The CPI-C return codes and the return codes from the SAP Gateway are explained in the SAP note 63347.

SAP Gateway Memory Problems

Many error messages and trace entries indicate gateway problems as regards memory allocation. For more information about this, see Memory Management of the SAP Gateway and the instructions for changing the following parameters:

Useful SAP Notes relating to the SAP Gateway

Note Number

Short Text

0074141

Resource Management for tRFC and aRFC

0006107

SIDEINFO; Problems after changing the CICS name

0028103

No side info entry for dest ...

0041003

Gateway, Connection reset by peer, errno 232

0047682

Activating the CPIC trace

0063347

List: CPIC error codes

0080474

Automatic start of a gateway instance under NT

0094513

RC=668 R/2 restarted during R/3 R/2 communication

0140616

NiIHostToAddr: Hostname too long

0171073

Dr.Watson in gwhost.exe under Windows NT

0139181

Hanging update because of "stopped CPIC"

0042692

Test tool for RFC connections: sapinfo

0066168

Required documents when analyzing RFC problems

0013903

List of network products supported by SAP

0116051

Checklist: Problems SNA gateways (R/3 ==> R/2)

0110612

Using the secinfo file (gateway ACL)