Global logging properties

The global logging properties apply to all IBM Security Identity Manager logs. The following values are the default property values:

Property value Description
Number of milliseconds between checking for updates to enRoleLogging.properties. The default value is 5 minutes (300,000 milliseconds).
  • handler.file.fileDir=
Location of the log files.

Do not change the default path value for the handler.file.fileDir property in the IBM Security Identity Manager virtual appliance.

  • handler.file.maxFileSize=1024
Maximum size for each log file in KB.
  • formatter.dateFormat="yyyy.MM.dd"
  • formatter.timeFormat="HH:mm:ss:SSS"
Specifies the date and time formats for the timestamps in the log records.

Use the ASCII letters described in Table 2 to specify a different date and time format.

Symbol Description Presentation type* Example
G (uppercase) Era designator Text AD
y (lowercase) Year Number 1996
M Month in the year Text and number July and 07
d Day in the month Number 10
E Day of the week Text Tuesday
D Day in the year Number 189
F Day of the week in the month Number 2 (second Wednesday in July)
w Week in the year Number 27
W Week in the month Number 2
h Hour in AM or PM Number (1-12) 12
H Hour in the day Number (0-23) 0
m Minute in the hour Number 30
s Second of the minute Number 55
S millisecond Number 987
a AM or PM marker Text PM
k Hour in the day Number (1-24) 24
K Hour in AM or PM Number (0-11) 0
z Time zone Text Pacific Standard Time
' (single quotation mark) Escape for text Delimiter  
" (2 single quotation marks) Single quotation mark Literal  
* The number of pattern letters that are specified determines whether a short form or long form is used in the timestamp.

The number of pattern letters determines the format.

Text
Specifies whether to use full or short form. If four or more pattern letters are specified, the full form is used. If less than four letters are specified, the short form is used if a short form exists.

Number
Minimum number of digits to be included. Shorter numbers are padded with zeros to the specified number of digits. Year (y) is handled differently; if 2 y's are specified, the year is shortened to two digits.

Text and number
Specifies whether to use text or a number. If 3 or more pattern letters are specified, text is used, otherwise a number is used. Any characters in the pattern that are not in the ranges of a through z and A through Z are treated as quoted text. For example, characters such as the semicolon (:), period (.), blank space, number sign (#), and at sign (@) are included in the output text even though they are not delimited with single quotation marks.

A pattern that contains an invalid pattern letter generates an error during formatting or parsing.

Table 3 provides examples of user-defined date and time patterns.

Sample pattern Result
formatter.dateFormat="yyyy.MM.dd G" formatter.timeFormat=" 'at' hh:mm:ss z" 1996.07.10 AD at 15:08:56 PDT
formatter.dateFormat="EEE, MMM d, ''yy" Wed, July 10, '96
formatter.timeFormat="h:mm a" 12:08 PM
formatter.timeFormat="hh 'o''clock' a, zzzz" 12 o'clock PM, Pacific Daylight Time
formatter.timeFormat="K:mm a, z" 0:00 PM, PST
formatter.dateFormat="yyyyy.MMMMM.dd GGG" formatter.timeFormat="hh:mm aaa" 1996.July.10 AD 12:08 PM

Parent topic: IBM Security Identity Manager logging properties