15 Generating Reports and Logs

See Also

Viewing Library and Device Reports with the Reports Utility

All report output is a static display of information at the time the report is generated. Click Update in the upper right corner to refresh the information.

Note:

Running multiple instances of SLC on the same workstation can cause inconsistent report data. Only one user at a time should produce SLC reports.
  1. In SLC, select Tools > Reports.

  2. In the navigation tree, expand a report folder. Select a report.

    Folder Report Description
    Statistics Drive Events Displays drive events and errors. The report can display up to 70 entries.
    Drive Media Events Displays cartridge error events that have occurred with a drive. The report can display up to 500 entries.
    General Events Displays a summary of library operational events.
    Media Events Displays cartridge errors. The report can display up to 2000 entries.
    Log EventLog Displays a log of events based on severity (see "Severity").
    Status Summary Cartridge Table Lists cartridge location, media type, label, and status information.
    Device Reserve Table Lists elevator, robot, and PTP reservation information.
    Drive Table Lists drive location, type, and serial number information.
    CAP Summary Lists the location of the CAPs.
    Cartridge Summary Lists the location, media type, and label information for all cartridges in the library.
    Drive Summary Lists drive location, type, serial number, code information, and device details.
    Library Information Lists the library physical configuration, code version, and state of the library.
    Robot Summary Lists robot address and state.
    Status Detail CAP/Drive/Robot Details Lists identifying information, code version, and status of the devices.
    Library Details Lists the library physical configuration, code version, and state of the library.
    Versions Hardware Versions Lists the FRU serial number for controller cards, CAPs, robots, and PTPs.
    Software Versions Lists the code version for controller cards, CAPs, elevators, robots, and PTPs.
    Audit Log Feature Audit Log Lists all feature activation activity for the life of the library. To view only the current hardware activation files, see "Displaying Current Hardware Activation Files".

Viewing Active Capacity Reports

The active slot reports only display data saved to the library controller database.

  1. Click Tools > Select Active Cells, and then click the View Reports tab.

  2. Select a report:

    • Cartridge Cell and Media Summary — displays a detailed list of all library resources and their status (active or inactive).

    • Orphaned Cartridge Report — displays a detailed list of all orphaned cartridges.

  3. To save the report as a comma-sperated value (csv) file, click Save to File.

Viewing Partitioning Reports

You can generate reports to assist in partitioning management and design.

  1. Select the Tools > Partitions > Reports tab.

  2. Select a report from the menu:

    • Cartridge Cell and Media Summary — displays a list of all resource partition assignments.

    • Host Connections Summary — displays host-partition connection information.

    • Orphaned Cartridge Report — displays a list of all orphaned cartridges.

    • Partition Details — displays information for a selected partition.

    • Partition Summary — displays summary information for all partitions.

Generating Diagnostic Files for Oracle Support

Your Oracle support representative might request that you capture and transfer the Management Information Base (MIB) or Log Snapshot file.

Transferring the Library MIB File

  1. In SLC, select Tools > Diagnostics.

  2. Select the Library in the device tree.

  3. Click the TransferFile tab.

  4. Select SNMP MIB. Click Transfer File.

  5. Save the file using a .txt suffix.

  6. E-mail the file to your Oracle support representative.

Transferring the Library Log Snapshot File

You must save the log within 15 minutes of generation. The file is encrypted.

  1. In SLC, select Tools > Diagnostics.

  2. Select the Library folder in the device tree.

  3. Click the Transfer File tab.

  4. Select Log Snapshot.

  5. Select either All Devices or Selected Device. If you choose Selected Device, select the device.

  6. Click Generate Log Snapshot on Library.

  7. Click Yes, and then OK.

  8. Click Transfer Log Snapshot To Your Computer.

  9. Save the file using the automatically generated name.

  10. E-mail the file to your Oracle support representative.

Monitoring Library Events

The library controller continually monitors library operations and logs all events. Using the Monitors utility of SLC, you can open an event monitor to display event data or spool it to a file. Event monitors are useful tools for root cause analysis.

Starting an Event Monitor

  1. In SLC, select Tools > Monitors.

  2. Expand the Permanent Monitors folder in the navigation tree.

  3. Click an event monitor type, and then click Open.

  4. Use the Monitor menu to pause, resume, stop, or clear the event monitor. Use the Spool File menu to save the event monitor to a file (see "Saving Event Monitor Data to a File").

    Note:

    To arrange multiple event monitors on one screen, use the Window menu in the upper right corner.

Saving Event Monitor Data to a File

You may need to send the file to your Oracle support representative to assist in diagnosing problems.

  1. Open an event monitor (see "Starting an Event Monitor").

  2. In the event monitor window, select Spool File > Start Spooling.

  3. Select a directory and file name. Click Save.

  4. To stop spooling, select Monitor > Stop Spooling.

Displaying Result Code Definitions

Result codes identify the library event type (result codes are the same as library EventIds).

  1. In SLC, select Tools > Diagnostics. Select the Library in the device tree.

  2. Click the Search tab.

  3. In the Search Type list, select Result Code.

  4. To search for a specific result code, enter the complete code (wildcards or partial codes are invalid)

    To list all result codes, select List All.

  5. Click Search.

Event Monitor Types

There are four types of event monitors: All, Error Warn Info, Error and Warnings, and Errors. Each monitor type logs events based on the severity of the event. For example, the Errors monitor only logs error events (see Severity for a description of the event types).

Each event logged in the event monitor contains the following information:

Time

Identifies when the event occurred.

Device ID

Identifies the library address of the device corresponding to the event.

User

Identifies the user that originated the event. This is "root" for HLI or SCSI host activities.

I / F

Identifies the interface type of the requester. The interface can be hli, scsi, or default (for SLC or CLI requests).

Activity

Identifies the command that was issued, such as "load drive".

Request Identifier

Identifies all host interface requests. Helps track the sequence of log activity resulting from each host request.

Severity

Identifies the significance of the event. Some event data is non-volatile, meaning it persists across system power cycles.

Error — non-volatile data indicating a fault that prevented a request (host or diagnostic) from completing successfully.

Warning — non-volatile data indicating a fault that has not stopped the library's ability to complete requests (host or diagnostic). A warning can identify a loss of performance or a condition that may indicate future irrecoverable errors.

Information — volatile data indicating general device or library information (such as the device state, device added, listener registered, tray serial number updated, and so on). This information may be important to establish a history of activity for the warning or error event.

Trace — volatile data indicating diagnostic activity tracing.

Result Code

Identifies the library event type (result codes are the same as library EventIds). To search for the meaning of the Result Code using SLC, see "Displaying Result Code Definitions" or refer to the SL3000_FRSxxx_JavaErrorCodes.html file included in the library firmware code package.

Result Text

Provides information about the results of the request or event.