TIME statement

The TIME statement specifies:

Format of the time of day (date and time) and duration (elapsed time) fields, including the universal CURRENT_TIME field
(Optional) Source of local time for BMC AMI Datastream and CZASEND message timestamps, and the RFC 3164 syslog message timestamp (always local time in the format mmm dd hh:mm:ss).

For more information, see Time-settings.

Important

You can modify the $$$SERVR member in the amihlq.CZAGENT.PARM data set.

If you code more than one TIME statement, then the latest TIME statement replaces the earlier one.

The TIME statement has no effect in CEF mode. For more information, see the following topics:

Common Event Format (CEF)
OPTIONS-statement (description of SIEMtype and its effect on TIME)

The following table describes the TIME statement parameters:

Parameter	Description
UTC\|ASIS\|LOCal	Type of date and time formatting Use one of the following parameters: UTC for Coordinated Universal Time (similar to Greenwich Mean Time) ASIS for BMC AMI Datastream versions 5.1.0 and earlier LOCal for local time. For more information about UTC, see https://www.ipses.com/eng/services/timing/. We recommend that you do not use ASIS with any of the _Z formats or with the %z or %Z strftime format codes. If you omit this parameter, UTC is used by default. The local time is taken from the environment variables TZ or _TZ. If the environment variables are not present, UTC is used by default. For information about setting up environment variables using ENVAR, see Time-settings.
DATE	Calendar date format Use one of the following values: ISO8601 generates a date in the format YYYY-MM-DD. JULIAN generates a date in the format YYDDD. strftime generates a date in string format by using the characters in the strftime format codestable. For more information about ISO8601 (International Standard 8601), see http://dotat.at/tmp/ISO_8601-2004_E.pdf. If you omit DATE, ISO8601 is used by default.
DURation	Format of duration (elapsed time) fields in the SMF records Use one of the following values: ISO8601_T (ISO8601 with thousandths) generates a duration in the format Phh:mm:ss.ttt. ISO8601 generates a duration in the format Phh:mm:ss.ttt. HHMMSSHH generates a duration in the format hh:mm:ss.hh. *strftime* generates a duration in a string format by using the characters in the strftime format codestable. We recommend that you do not use DURation with format codes, such as %a. For formats that include a decimal point, such as ISO8601_T, the locale-appropriate decimal point is used. If you omit DURation, ISO8601_T is used by default.
NORound	Does not round off the time output Time output from STCK (store clock) and STCKE (store clock extended) is rounded off to the nearest millisecond or microsecond. If you omit NORound, the time output is rounded off by default.
TIME	Format of time (without a date) fields in the SMF records Use one of the following values: ISO8601_T (ISO8601 with thousandths) generates a time in the format hh:mm:ss.ttt. ISO8601 generates a time in the format hh:mm:ss. HHMMSSHH generates a time in the format hh:mm:ss.hh. *strftime* generates a time in a string format by using the characters in the strftime format codestable. For formats that include a decimal point, such as ISO8601_T, the locale-appropriate decimal point is used. If you omit TIME, ISO8601_T is used by default.
TIMEOFDay	Format of time of day (date and time) fields in the SMF records Use one of the following values: ISO8601_T (ISO8601 with thousandths) generates a date and time in the format yyyy-mm-ddThh:mm:ss.ttt. ISO8601 generates a date and time in the format yyyy-mm-ddThh:mm:ss. ISO8601_TZ (ISO8601 with thousandths and zone indicator) generates a date and time in the format yyyy-mm-ddThh:mm:ss.ttt±oooo. ISO8601_Z (ISO8601 with zone indicator) generates a date and time in the format yyyy-mm-ddThh:mm:ss±oooo. JULian generates a date and time in the format yyddd hh:mm:ss.hh. *strftime* generates a date and time in a string format by using the characters in the strftime format codestable. For formats that include a decimal point, such as ISO8601_T, the locale-appropriate decimal point is used. For more information, see the description of SIEMtype (and its effect on TIMEOFDay) in the OPTIONS-statement. If you omit TIMEOFDay, ISO8601_T is used by default.
ZONe	Time zone information needed by z/OS Language Environment Use one of the following values: _TZ uses the value of the _TZ environment variable. TZ uses the value of the TZ environment variable. *timeZone* uses a literal time zone specifier, enclosed in quotation marks. The full format of time zone specifiers is complex, but the simplest form is "ssso" or "sssoddd": *sss* is a standard time zone abbreviation, such as EST o is the offset in hours from UTC, such as 5 for Eastern Standard Time or -1 for Central European Time *ddd* is the daylight or summer time zone abbreviation, such as EDT Omit ddd if your locale does not observe summer or daylight time, for example, ZONE('EST5'). For more information about the _TZ and TZ environment variables, see Using the TZ or _TZ environment variable to specify time zone in the IBM documentation. Important Unsigned (positive) offsets are for time zones west of Greenwich, such as in the Americas Minus or negative offsets are for time zones east of Greenwich, such as in Europe, Africa, Asia, and most of Oceania. The zone must be the local time zone of the mainframe, not the time zone of the syslog server or the office where the security analysts are located. If the zone specified or defaulted does not correspond to the time zone specified in z/OS, then certain SMF fields that are recorded by IBM in mainframe local time are interpreted incorrectly. For more information about time zone specifiers, see the IBM documentation. If you omit ZONe, TZ is used by default.

Examples of formatted times

The following table shows how 15:40:50.789 on September 26, 2012, Eastern Standard Time, and a duration of 3 minutes and 25.789 seconds, would be formatted under various options. The strftime format string examples are just two of a nearly unlimited number of possibilities. The ASIS format would be the same as either UTC or LOCAL, depending on the particular field. (Durations are unaffected by time zones.)

Format	UTC	LOCal
ISO8601	2012-09-26T20:40:51 P00:03:26	2012-09-26T15:40:50.789 P00:03:26
ISO8601_T	2012-09-26T20:40:50.789 P00:03:25.789	2012-09-26T15:40:50.789 P00:03:25.789
ISO8601_TZ	2012-09-26T15:40:50.789+0000	2012-09-26T15:40:50.789-0500
ISO8601_Z	2012-09-26T15:40:51+0000	2012-09-26T15:40:51-0500
JULIAN	12269 20:40:50.79	12269 15:40:50.79
HHMMSSHH	00:03:25.79	00:03:25.79
‘%d%b%Y %r’	26Sep2012 08:40:51 pm	26Sep2012 03:40:51 pm
‘Dur=%T’	Dur=00:03:26	Dur=00:03:26

strftime format codes

The format codes consist of a % (percent sign) followed by one or two characters. The characters are case-sensitive: %a and %A have different meanings; %F is a valid code, but %f is not. Characters not prefaced with a percent sign represent themselves: the string Month: %B might format as Month: September. A literal percent sign that is to appear in the output data is coded as %%. strftime refers to the standard C programming language library function strftime(). If you code an invalid format code, it is preserved literally in the time value: a format code of %f is formatted as the literal %f.

Format code	Value substituted ¹
%a	Abbreviated weekday name of locale
%A	Full weekday name of locale
%b	Abbreviated month name of locale
%B	Full month name of locale
%c	Date and time of locale
%C	Locale’s century number (year divided by 100 and truncated)
%d	Day of the month (01-31)
%D	Date in mm/dd/yy form, regardless of locale
%e	Day of the month as a decimal number (01–31) Under CPOSIX only, it’s a 2-character, right-justified, blank-filled field.
%Ec	The locale’s alternative date and time representation	If the alternative date/time format is not available, these codes are mapped to their unextended counterparts. For example, %EC is mapped to %C.
%EC	The name of the base year (period) in the locale’s alternative representation
%Ex	The locale’s alternative date representation
%EX	The locale’s alternative time representation
%Ey	The offset from %EC (year only) in the locale’s alternative representation
%EY	The full alternative year representation
%F	The ISO 8601:2000 standard date format, equivalent to %Y-%m-%d
%g	The last two digits of the week-based year as a decimal number (00-99)
%G	The week-based year as a four-digit decimal
%h	Locale’s abbreviated month name This is the same as %b.
%H	Hour (24-hour clock) as a decimal number (00-23).
%I	Hour (12-hour clock) as a decimal number (01-12).
%j	Day of the year (001-366)
%m	Month (01-12)
%M	Minute (00-59)
%Od	The day of month, using the locale’s alternative numeric symbols, filled as needed with leading zeros if there is any alternative symbol for zero, otherwise with leading spaces	If the alternative date/time format is not available, the %O codes are mapped to their non-alternative counterparts. For example, %Od is mapped to %d.
%Oe	The day of the month, using the locale’s alternative symbols, filled as needed with leading spaces
%OH	The hour (24-hour clock) using the locale’s alternative symbols
%OI	The hour (12-hour clock) using the locale’s alternative symbols
%Om	The month using the locale’s alternative numeric symbols
%OM	The minutes using the locale’s alternative numeric symbols
%OS	The seconds using the locale’s alternative numeric symbols
%Ou	The weekday as a number in the locale’s alternative representation (Monday=1)
%OU	The week number of the year (Sunday as the first day of the week, rules corresponding to %U) using the locale’s alternative numeric symbols
%OV	The week number of the year (Monday as the first day of the week, rules corresponding to %V) using the locale’s alternative numeric symbols
%Ow	The weekday (Sunday=0) using the locale’s alternative numeric symbols
%OW	The week number of the year (Monday as the first day of the week) using the locale’s alternative numeric symbols
%Oy	The year (offset from %C) in the locale’s alternative representation and using the locale’s alternative numeric symbols
%p	The locale’s equivalent of AM or PM
%Qn	Fractional seconds formatted to n places; for instance, %Q3 to format as milliseconds The %Qn format code can appear no more than once in the format specification.
%r	A string equivalent to %I:%M:%S %p; or use t_fmt_ampm from LC_TIME, if present
%R	Time in 24 hour notation (%H:%M)
%S	Seconds as a decimal number (00-60)
%T	Equivalent to %H:%M:%S
%u	The weekday as a decimal number (1 to 7), with 1 representing Monday
%U	Week number of the year (00-53) where Sunday is the first day of the week The first Sunday of January is the first day of week 1; days in the new year before this are in week 0.
%V	Week number of the year (01-53) where Monday is the first day of the week If the week containing 1 January has four or more days in the new year, then it is considered week 1. Otherwise, it is the last week of the previous year, and the next week is week 1. Both January 4 and the first Thursday in January are always in week 1.
%w	Weekday (0-6) where Sunday is 0
%W	Week number of the year (00-53) where Monday is the first day of the week
%x	Date representation of locale
%X	Time representation of locale
%y	Year without the century (00-99)
%Y	Year with century
%z	The offset from UTC in ISO8601:2000 standard format ( +hhmm or –hhmm ) For instance, -0430 means 4 hours 30 minutes behind UTC (west of Greenwich).
%Z	Name of time zone, or no characters if time zone is not available
%%	%

TIME statement

Examples of formatted times

strftime format codes

On this page