Using Tools
The Resident Security Server (RSS) Tools utility enables authorized users to display basic information about RSS, issue commands, and perform trace actions. After an RSSTSO REXX environment is created, you can also use the Tools dashboard to drive REXX routines.
The following sections of this topic describe the Tools utility:
System information
The top of the Tools dashboard displays basic information about the RSS instance to which you are connected:
- Job name
- Job user
- Address space ID (ASID)
RSS Commands – Display Commands
From the RSS Commands menu, select one of the following Display Commands. The output appears in the dashboard.
Command | Description |
|---|---|
Active Applications (APPS) | List of the active RSS applications |
Active Servers (SERVERS) | List of active servers, including their ID, name, IP address, port number, and status |
Active Sessions (SESS) | List of users currently signed in to RSS, including their IP address and login, activity, and keepalive times |
Active TSO Address Spaces (TSO) | List of any active TSO address spaces |
RSS CSA (CSA) | Lists the jobs with access to the RSS instance |
Hash Table Statistics (HASH) | Lists the address of the RSS hash table |
Checkpoint Data Set Status (CHKPT) | Lists the activation and size information for the Checkpoint data set |
Master Dataspace Status (DS) | Lists details about the RSS master data space |
SMF Exit Information (SMF) | Lists information about the SMF exit, where available |
RSS Main Tasks Status (TASKS) | Lists the status of key RSS tasks |
RSS Commands – Actions
From the RSS Commands menu, select one of the following Actions. The output appears in the dashboard and is added to the SYSLOG.
Set a Message Level (SETMSG)
Use this option to set a new message-level trace.
To set a message-level trace:
- Click Set a Message Level (SETMSG).
A dialog box appears with a list of options. - Click the down arrow and choose a trace command.
- Click Submit.
You can choose from the following trace commands:
Trace | Description |
|---|---|
APPTrace | Enables application-specific tracing |
BufTrace | Traces data in all traced exchanges as well as protocol information |
DATATrace | Traces detailed data buffers during communication Use this trace with caution because sensitive data might be reported. |
DLLTrace | Traces DLL calls |
DSTrace | Traces data space activity |
Error | Traces output error messages |
HTTPTrace | Traces HTTP traffic generated by user interactions with the RSS browser interface |
Info | Traces output information messages |
JSONTrace | Traces JSON streams over the REST API |
MUTEXTrace | Traces mutex operations |
RACFTrace | Traces all RACF commands and their output responses |
REXXTrace | Traces REXX activity and allows the called REXX execs to write additional trace data |
SQLTrace | Traces SQL application calls |
TCPTrace | Traces all TCP communications including SSL exchanges when using HTTPS protocol |
XCFTrace | Traces data sent and received across XCF communications |
Remove a Message Level (RESETMSG)
Use this option to reset a previously set message-level trace. This is especially useful if you experience issues with RSS and you need to switch on or off one or more of the trace message levels.
To remove a message-level trace:
- Click Remove a Message Level (RESETMSG).
A dialog box appears with a list of options. - Click the down arrow and choose a trace command.
- Click Submit.
The list of trace commands for this action are the same as those for Set a Message Level (SETMSG).
Custom Command
Use this option to enter a custom command.
To enter a custom command:
- Click Custom Command.
A dialog box appears where you can enter a custom command. - Enter the desired command and click Submit.
REXX
You can use the REXX option to enter REXX commands available in your RSSTSO REXX environment.
- Click REXX on the bar at the top of the screen.
A dialog box appears where you can enter a REXX command. - Enter the desired REXX member name and click Submit.
The command output is displayed in the dashboard.
Related topics