(Optional) rsecomm.properties, the RSE tracing

This customization task does not require assistance, special resources, or special customization tasks.

z/OS® Explorer supports different levels of tracing the internal program flow for problem-solving purposes. RSE, and some of the services called by RSE, use the settings in rsecomm.properties to know the required initial detail level in the output logs.

Attention: Changing these settings can cause performance degradations and should be done only under the direction of the IBM® support center.

rsecomm.properties is located in /etc/zexpl/, unless you specified a different location when you customized and submitted FEK.SFEKSAMP(FEKSETUP) job. For more details, see Customization setup. You can edit the file with the TSO OEDIT command. RSE must be restarted for the changes to take effect.

The following code sample shows the rsecomm.properties file, which can be customized to match your tracing needs. Comment lines start with a number sign (#) when using a US code page. Data lines can have only a directive and its assigned value; comments are not allowed on the same line. Line continuations are not supported.

Figure 1. rsecomm.properties - Logging configuration file

# Logging level
# 0 – Log error messages
# 1 – Log error and warning messages
# 2 – Log error, warning and info messages
debug_level=1
#USER=userid
#USER=(userid,userid,…)

debug_level

Detail level for output logs. The default is 1, which logs error and warning messages. The debug_level detail controls the detail level of multiple services and, thus, multiple output files. Increasing the detail level will cause performance degradations and should be done under only the direction of the IBM support center. For more information about which logs are controlled by this directive, see "RSE tracing" in the Host Configuration Reference Guide (SC27-8438).

Table 1. Detail level for output logs
Value	Detail level
0	Log error messages only
1	Log error and warning messages
2	Log error, warning, and informational messages

Note: debug_level can be changed dynamically for specific log files with the modify rsecommlog, modify rseserverlog, and modify rsedaemonlog operator commands, as described in Operator commands.

USER

Set debug level 2 (log error, warning, and informational messages) for the specified user IDs during server startup. The debug level for all other users is the default as specified in the debug_level directive. The USER directive alters the trace detail level for RSE server (rsecomm.log) and the MVS™ data set services (lock.log and ffs*.log), and is equivalent to issuing the modify trace user operator command.