Changing the Trace Level in a Productive System: Option -t (toggle trace)

Context

You can use option - t to change the trace level of an active SAProuter. Possible values are 1, 2, or 3.

You can also activate the trace for single connections. For these connections the information is written with trace level 2. The connection is traced using an enhanced syntax of option -t.

You have the following options:

Command

Meaning

saprouter -t "on <id>"

This command activates the trace for this (existing) connection. <id> is the number of the connection. You can see this number when you display the connection information (option saprouter -l).

saprouter -t "off <id>"

Deactivates the trace for connection with number <id>.

saprouter -t "on <IPaddress>"

Activates the trace for all new connections coming from the IP address <IPaddress>. You use this option if the connection is not yet open and you are looking for information to set up the connection.

saprouter -t "off <IP address>"

Deactivates the trace for all new connections coming from the IP address <IPaddress>.

saprouter -t "on <subnet>"

<subnet> specifies a set of IP addresses. The command activates the trace for all new connections coming from this subnetwork.

saprouter -t "off <subnet>"

Deactivates the trace for all new connections coming from this subnetwork.

Procedure

  1. To change the trace level in a productive system, enter option -t in the input field:
    • Windows/Unix: saprouter -t<trace level>
    • IBM i: call saprouter ( '-t' '<trace level>' )
  2. Optional: To activate the trace for single connections, enter option -t in the input field:
    • Windows/Unix: saprouter -t<command>
    • IBM i: call saprouter ( '-t' '<command>' )

Example

You activate the trace for connection number 4 by sending the command saprouter -t "on 4" to the active SAProuter.

Then call saprouter -l (IBM i: call saprouter ( '-l' ) ) to display the connections. You get the following output:

SAP Network Interface Router running on port 3299 (PID = 1576962) Started on: Wed Apr 13 09:00:10 2005 ID CLIENT | PARTNER service ------------------------------+------------------------------- 7 localhost | (no partner) 6 10.18.203.8 | 10.17.74.118 3227 4 *10.18.203.8 | 10.17.74.118 3227 2 10.18.203.8 | 10.17.74.118 3227 Total no. of clients: 7 Working directory : /usr/sap/PRD/work Routtab : ./saprouttab
         

The asterisk (*) is the trace for connection 4.