TIMEZONE keyword for the ANALYZE control statement


You can use the TIMEZONE keyword (or the TIMEZ abbreviation) on the ANALYZE control statement to specify how time values are interpreted when you are specifying time input values and when Log Analyzer is displaying time values in reports and on panels.

You can specify one of the following values:

  • LOCAL

    Use the offset that is specified in the z/OS system that is executing the Log Analyzer job. Using this offset, Log Analyzer automatically converts time values to the equivalent coordinated universal time (UTC), also referred to as Greenwich Mean Time (GMT).

  • GMT

    Use UTC times. Log Analyzer interprets and displays all time values as UTC times.

    Warning

    Note

    Using TIMEZONE=GMT is the safest option because IMS always writes log records with GMT values. With GMT, no confusion can result from time shifts (standard time to daylight savings time, or daylight savings time to standard time) or analysis of records from multiple time zones.

    Even if you usually specify TIMEZONE=LOCAL, if you are analyzing logs across a time shift you might want to specify TIMEZONE=GMT. With this specification, Log Analyzer automatically handles the time shift for you.

  • (-hhmm) or (+hhmm)

    Use the specified offset instead of the offset that is specified in the z/OS system that is executing the Log Analyzer job. Using this offset, Log Analyzer interprets and displays time values as GMT plus or minus the specified number of hours and minutes. If you want to work in local time but Log Analyzer is processing log records that were created in a different time zone than your own, you might find it easiest to specify TIMEZONE=(-hhmm) or TIMEZONE=(+hhmm).

    Warning

    Note

    You must use 15-minute increments for the mm units. If you use any other increment, you will encounter an error message.

  • ORIGINAL

    Automatically determine and display the local time offset from GMT by using the UTC or IMS timestamps in log records within the SLDS.

    You cannot specify TIMEZONE=ORIGINAL if you specify START and STOP timestamps on the INTERVAL control statement.

The default is TIMEZONE=LOCAL.

Information
Example

To work with log records in a local time zone that is 6 hours earlier than GMT, specify the following keyword on the ANALYZE control statement:

TIMEZONE=(-0600)

 

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

BMC AMI Log Analyzer for IMS 1.7