Using Tools


The BMC AMI 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:

  1. Click Set a Message Level (SETMSG).
    A dialog box appears with a list of options.
  2. Click the down arrow and choose a trace command.
  3. 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:

  1. Click Remove a Message Level (RESETMSG).
    A dialog box appears with a list of options.
  2. Click the down arrow and choose a trace command.
  3. 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:

  1. Click Custom Command.
    A dialog box appears where you can enter a custom command.
  2. Enter the desired command and click Submit.

REXX

You can use the REXX option to enter REXX commands available in your RSSTSO REXX environment.

  1. Click REXX on the bar at the top of the screen.
    A dialog box appears where you can enter a REXX command.
  2. Enter the desired REXX member name and click Submit.
    The command output is displayed in the dashboard.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*