Administrator's Reference

QUERY ACTLOG (Query the Activity Log)

Use this command to display messages generated by the server. This command offers you various filtering options that can be used to limit the amount of messages displayed and the time it takes to process this query. If you do not specify any parameters with this command, all messages generated in the last hour are displayed.

Note:You cannot schedule the QUERY ACTLOG command using the DEFINE SCHEDULE command.

All messages are recorded or displayed on the MVS console, the MVS hardcopy log, and the TSM Server's Job Log. Responses to commands are not recorded in the activity log, unless the command affects or starts a background process or a client session. All error messages are retained in the activity log.

Privilege Class

Any administrator can issue this command.

Syntax

                   .-BEGINDate--=--current_date--.
>>-Query ACtlog----+-----------------------------+-------------->
                   '-BEGINDate--=--date----------'
 
      .-BEGINTime--=--currenttime_minus_1_hour--.
>-----+-----------------------------------------+--------------->
      '-BEGINTime--=--time----------------------'
 
      .-ENDDate--=--current_date--.
>-----+---------------------------+----------------------------->
      '-ENDDate--=--date----------'
 
      .-ENDTime--=--current_time--.
>-----+---------------------------+----------------------------->
      '-ENDTime--=--time----------'
 
>-----+---------------------------+---+--------------------+---->
      '-MSGno--=--message_number--'   '-Search--=--string--'
 
      .-ORiginator--=--ALL----------------.
>-----+-----------------------------------+--------------------><
      '-ORiginator--=--+-ALL------------+-'
                       +-SErver---------+
                       '-CLient--| A |--'
 
A
 
|---+-------------------------+---+---------------------------+->
    '-NODEname--=--node_name--'   '-OWNERname--=--owner_name--'
 
>-----+------------------------------+-------------------------->
      '-SCHedname--=--schedule_name--'
 
>-----+-----------------------------+--------------------------->
      '-Domainname--=--domain_name--'
 
>-----+-----------------------------+---------------------------|
      '-SESsnum--=--session_number--'
 

Parameters

BEGINDate
Specifies the beginning date of the range for messages to be displayed. All messages meeting the time range criteria that occurred after this date are displayed. The default is the current date. This parameter is optional.

You can specify the data using one of the values below:

Value Description Example
MM/DD/YYYY A specific date 09/15/1998
TODAY The current date TODAY
TODAY-days or-days The current date minus days specified. The maximum number of days you can specify is 9999. TODAY -7 or -7.

To display information beginning with messages created a week ago, you can specify BEGINDATE=TODAY-7 or BEGINDATE= -7.

BEGINTime
Specifies the beginning time of the range for messages to be displayed. All messages meeting the time range criteria that occurred after this time are displayed. If you do not specify time, all messages that occurred in the last hour are displayed.

You can specify the data using one of the values below:

Value Description Example
HH:MM:SS A specific time on the specified begin date 10:30:08
NOW The current time on the specified begin date NOW
NOW+HH:MM or +HH:MM The current time plus hours and minutes on the specified begin date NOW+03:00 or +03:00.

If you issue this command at 9:00 with BEGINTIME=NOW+3 or BEGINTIME=+3, TSM displays messages with a time of 12:00 or later on the begin date.

NOW-HH:MM or -HH:MM The current time minus hours and minutes on the specified begin date NOW-04:00 or -04:00.

If you issue the QUERY ACTLOG command at 9:00 with BEGINTime=NOW-3:30 or BEGINTime= -3:30, TSM displays messages with a time of 5:30 or later on the begin date.

ENDDate
Specifies the ending date of the range for messages to be displayed. All messages meeting the time range criteria that occurred before this date are displayed. If you do not specify a value, the current date is used. This parameter is optional.

You can specify the data using one of the values below:

Value Description Example
MM/DD/YYYY A specific date 09/15/1998
TODAY The current date TODAY
TODAY-days or-days The current date minus days specified. The maximum number of days you can specify is 9999. TODAY-1 or -1.

To display information created up to yesterday, you can specify ENDDATE=TODAY-1 or simply ENDDATE= -1.

ENDTime
Specifies the ending time of the range for messages to be displayed. All messages meeting this time range criteria that occurred before this time are displayed. If you do not specify a value, all messages are displayed up to the time when you issued this command. This parameter is optional.

You can specify the data using one of the values below:

Value Description Example
HH:MM:SS A specific time on the specified end date 10:30:08
NOW The current time on the specified end date NOW
NOW+HH:MM or +HH:MM The current time plus hours and minutes on the specified end date NOW+03:00 or +03:00.

If you issue this command at 9:00 with ENDTIME=NOW+3:00 or ENDTIME= +3:00, TSM displays messages with a time of 12:00 or later on the end date you specify.

NOW-HH:MM or -HH:MM The current time minus hours and minutes on the specified end date NOW-03:30 or -03:30.

If you issue this command at 9:00 with ENDTIME=NOW-3:30 or ENDTIME= -3:30, TSM displays messages with a time of 5:30 or later on the end date you specify.

MSGno
Specifies an integer that defines the number of the message to be displayed from the activity log. This is the numeric part of the message without the ANR prefix or the message type suffix (that is, I, W, E, S, or D). This parameter is optional.

Search
Specifies a text string expression that you want to search for in the activity log. Enclose the string expression in quotation marks if it contains blanks. You can use a wildcard character to specify this string. This parameter is optional.

ORiginator
Specifies that the query displays messages logged by the server, client, or both. The default is ALL. Possible values are:

ALL
Specifies that the query displays messages that originated from the client and the server.

SErver
Specifies that the query displays messages that originated from the server.

CLient
Specifies that the query displays messages that originated from the client.

You can specify one of the following values to minimize processing time when querying the activity log for messages logged by the client:

NODEname
Specifies that the query displays messages logged for this node. If you do not specify a value for this parameter, messages for all nodes are displayed.

OWNERname
Specifies that the query displays messages logged for a particular owner. If you do not specify a value for this parameter, messages for all owners are displayed.

SCHedname
Specifies that the query displays messages logged by a particular scheduled client activity. If you do not specify a value for this parameter, messages for all schedules are displayed.

DOmainname
Specifies that the query displays messages logged for a particular policy domain to which a named schedule belongs. This parameter is optional, unless you are specifying a schedule name.

SESsnum
Specifies that the query displays messages logged from a particular client session number. If you do not specify a value for this parameter, messages for all client sessions are displayed.

Examples

Task 1

Search the activity log for any message that contains the string "delete". The output includes only messages produced during the past hour.

Command:
query actlog search=delete

Output:
 
+--------------------------------------------------------------------------------+
|Date/Time            Message                                                    |
|-------------------- -------------------------------------------------          |
|08/27/1998 15:19:43  ANR0812I Inventory client file expiration                  |
|                      complete: 0 files deleted.                                |
+--------------------------------------------------------------------------------+

Task 2

Display messages that occurred yesterday between 9:30 and 12:30.

Command:
query actlog begindate=today-1 begintime=09:30:00 endtime=12:30:00

Output:
 
+--------------------------------------------------------------------------------+
|Date/Time            Message                                                    |
|-------------------- -------------------------------------------------          |
|10/21/1998 10:52:36 ANR0407I Session 3921 started for administrator ADMIN       |
|                    (WebBrowser) (HTTP 9.115.20.100(2315)).                     |
|10/21/1998 11:06:08 ANR0405I Session 3922 ended for administrator ADMIN         |
|                    (WebBrowser).                                               |
|10/21/1998 12:16:50 ANR0405I Session 3934 ended for administrator ADMIN         |
|                    (WebBrowser).                                               |
|10/21/1998 12:36:18 ANR2501I Schedule AGADM_TEST deleted from policy            |
|                    domain STANDARD.                                            |
+--------------------------------------------------------------------------------+

Task 3

Search the activity log for TSM messages from the client for node JEE.

Command:
query actlog originator=client node=jee

Output:
 
+--------------------------------------------------------------------------------+
|Date/Time           Message                                                     |
|-------------------- -----------------------------------------------------      |
|06/10/1998 15:46:22 ANE4007E (Session No: 3 Node: JEE) Error processing         |
|                      '/jee/report.out': access to the object is                |
|                      denied                                                    |
|06/11/1998 15:56:56 ANE4009E (Session No: 4 Node: JEE) Error processing         |
|                     '/jee/work.lst': disk full condition                       |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Commands

Table 134. Command Related to QUERY ACTLOG

Command Description
SET ACTLOGRETENTION Specifies the number of days to retain log records in the activity log.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]