Using Logs › Display a Transient Log

Display a Transient Log

The transient log provides a real-time view of the activity associated with a particular resource. You can display the transient log from your monitor. This log and the activity log contain messages and other information associated with a resource. The logs help you diagnose problems (for example, resource failure).

To display the transient log

1. Enter L beside a resource on the monitor.

   The Transient Log Browse panel appears for the selected resource. The panel displays messages in chronological order.

2. (Optional) Enter L beside a message in the transient log to access the activity log to see what was happening in the system at that time.

Set Criteria to Display Logged Messages Selectively

When you access the transient log of a resource, you are profiled to view all messages logged for that resource. You can limit the number of messages you see in the current session by profiling for certain criteria.

To set profile values

1. Enter the PROFILE command at the prompt.

   A panel appears displaying the current profile setting.

2. Change the settings, as required.

   Note: For information about the settings, see the online help.

You can also supply the profile values directly by using the command operands. The syntax of the PROFILE command is:

PROFILE [[SEV={1|2|3|4|5|6}]
         [NCLID=ncl-process-identifier]
         [PROC=ncl-procedure-name]] | 
        [RESET=YES]

You can profile messages according to the following:

• SEV

  Determines how critical the messages are. For example, specify SEV=1 to see only the most critical messages or SEV=4 to see the messages of severity levels 1 through 4.

• NCLID

  Specifies the ID of the NCL process that issued the messages you want to see. The NCL processes are created when NCL procedures are executed. The region creates NCL processes when performing automation tasks.

  Each NCL process has a unique ID, so you can use the NCLID operand to differentiate between executing copies of the same NCL procedure if, for example, the same NCL procedure was run more than once in a given period.

  The region processes resources asynchronously, and a number of NCL processes for the resource may be active at the same time. Messages raised by these NCL processes intermingle in the transient log. You can use the NCLID operand to view the messages raised by a particular NCL process (that is, to view the messages for a particular task).

• PROC

  Specifies the name of the executing NCL procedure that issued the messages you want to see.

  You can use the asterisk (*) wildcard character to include more than one NCL procedure. The wild card represents any single character except at the end of a string when the wild card represents one or more characters.

• RESET

  Specify RESET=YES to reset the profile to view all available messages.

Display User-defined Log Messages

A user-defined log message can be specified for a resource on the Define Event Related Actions panel when the resource is defined.

If you want to see only these messages in the transient logs, enter UL beside the resource.

Obtain Help on a Logged Message

You can obtain more information about product messages in a transient log through help.

To display the detailed help text associated with a message in the transient log

1. Enter H beside the message.

   The help text appears.

Print a Transient Log

To print a transient log

1. Enter P beside a resource to print its transient log.

   The Generate a Report panel appears, which lets you print a default report or an extended report of the resource's transient log.

2. Specify your printing requirements.
   • To print the default report (TRANSIENTLOG), ensure that the displayed information is satisfactory.
   • The extended report contains additional fields that display the S (severity), Nclid (NCL ID), and Proc (procedure) for each item in the transient log. To print the extended report, enter ? in the Report Name field, and then select TRANSX.

     Press F6 (Action).

     The log report is printed.

Reset a Transient Log

When you do not need the messages in the transient log anymore, you can clear the messages by resetting the log.

To reset the transient log of a resource

1. Enter LR beside the resource.

   Its transient log is cleared of all messages.