Use File Change attributes to monitor changes to your file system and to request notification when resources change. File Change is a multiple-instance attribute group. You cannot mix these attributes with those of any other multiple-instance group.
When creating situations using the File Change attribute group you must supply values for the following attributes to restrict the monitoring for the situation.
Situations must contain only one row of filter data in the situations formula. If more than one row is provided the results are undefined.
Action The type of change that occurred most recently to the directory or to the file. Valid values are positive integers in the range 0 to 5 and can include the use of the *AVG, *MIN, *MAX, or *SUM functions. The numbers 1 through 5 determine the type of change that recently occurred.
Number |
Description |
1 |
File/directory was added |
2 |
File/directory was removed |
3 |
File/directory changed (in size, in attribute, or in the security for the file/directory) |
4 |
File/directory was renamed - the old name displays |
5 |
File/directory was renamed - the new name displays |
For example, to determine whether a file/directory was removed, enter 2.
Attributes The current attributes for the file. When used in a situation, this value does not act as a trigger condition for the situation. This value can be used as a filter condition after the situation has already been triggered by one of the predefined monitor conditions. Valid values are positive integers in the range 0 to 2147483647 and can include the use of the *AVG, *MIN, *MAX, or *SUM functions. For example, to express 75 file attributes, enter 75.
Change Attributes Selects monitoring for attribute changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for attribute changes.
Change Create Selects monitoring for Create Date/Time changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for creation date/time changes.
Change Directory Name Selects monitoring for directory name changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for changes to directory names.
Change File Name Selects monitoring for file name changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for file name changes.
Change Last Access Selects monitoring for Last_Access date/time changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for last access date/time changes.
Change Last Write Selects monitoring for Last_Write date/time changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for last write date/time changes.
Change Security Selects monitoring for security code changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for security code changes.
Change Size Selects monitoring for size changes. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for size changes.
Current Size The current size of the file. When used in a situation, this value does not act as a trigger condition for the situation. This value can be used as a filter condition after the situation has already been triggered by one of the predefined monitor conditions. Valid values are positive integers in the range 0 to 2147483647 and can include the use of the *AVG, *MIN, *MAX, or *SUM functions. For example, to express 5358 as the current size of the file, enter 5358.
Date Created (V200) The date the file was created. Valid format is a text string (MM/DD/YY). For example, to express August 9, 1997, enter 08/09/97.
Date Last Modified (V200) The date/time that the file was last modified. When used in a situation, this value does not act as a trigger condition for the situation. This value can be used as a filter condition after the situation has already been triggered by one of the predefined monitor conditions.Valid format is a text string (MM/DD/YY). For example, to express August 9, 1997, enter 08/09/97.
Date Time Created The date and time at which the file was created. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where:
C |
Century (0 for 20th, 1 for 21st) |
YY |
Year |
MM |
Month |
DD |
Day |
HH |
Hour |
MM |
Minute |
SS |
Second |
mmm |
Millisecond |
Use simple text strings as described above. For example, enter 0971009130500000 to express October 9, 1997, 1:05:00 pm.
Date Time Last Modified The date and time the file was last modified. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where:
C |
Century (0 for 20th, 1 for 21st) |
YY |
Year |
MM |
Month |
DD |
Day |
HH |
Hour |
MM |
Minute |
SS |
Second |
mmm |
Millisecond |
Use simple text strings as described above. For example, enter 0971009130500000 to express October 9, 1997, 1:05:00 pm.
Monitor All Conditions This attribute combines different types of filter criteria, allowing you to monitor the most recent file changes. You can use this attribute to trigger monitoring for all of the following attributes: Change Attributes, Change Create, Change Directory Name, Change File Name, Change Last Access, Change Last Write, Change Security, and Change Size. You can also use the above-listed attributes in individual situations to monitor for one or more conditions, such as the latest change to the file name or the last time a file was accessed. Valid value is a single character (Y=Yes). For example, enter Y to select monitoring for all of the above listed conditions.
Server Name The name of the managed system. Valid format is a text string of up to 64 characters.
Time Created (V200) The time the file was created. Valid format is a text string (HH:MM:SS). For example, to express 1:05pm and 30 seconds, enter 13:05:30.
Time Last Modified (V200) The time the file was last modified. Valid format is a text string (HH:MM:SS). For example, to express 2:05pm and 30 seconds, enter 14:05:30.
Timestamp The date and time the Tivoli Enterprise Management Server samples the data. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where:
C |
Century (0 for 20th, 1 for 21st) |
YY |
Year |
MM |
Month |
DD |
Day |
HH |
Hour |
MM |
Minute |
SS |
Second |
mmm |
Millisecond |
Use simple text strings as described above. For example, enter 0971009130500000 to express October 9, 1997, 1:05:00 pm.
Total Hits The total number of file/directory changes since monitoring began. Valid values are positive integers in the range 0 to 2147483647 and can include the use of the *AVG, *MIN, *MAX, or *SUM functions. For example, to express 74 file/directory changes since monitoring began, enter 74.
Watch Directory The full path and name of the watched directory. Valid format is a text string of up to 260 characters. For example, C:\FILESYS\USAGE. A filter value is required for this attribute in situations using either the File Change attribute group or the File Trend attribute group.
Watch Directory (Unicode) Name of watched Directory in UTF8. Valid format is a text string of up to 392 bytes. A filter value is required for this attribute in situations using either the File Change attribute group or the File Trend attribute group.
Watch File The name of the watched file. Valid format is a text string of up to 260 characters. For example, usage.log. A filter value is required for this attribute in situations using either the File Change attribute group or the File Trend attribute group.
Watch File (Unicode) Path and Name of watched File in UTF8. Valid format is a text string of up to 392 bytes. A filter value is required for this attribute in situations using either the File Change attribute group or the File Trend attribute group.
Watch Tree The entire watch tree or only the directory. Valid value is a single character (Y=Yes or N=No). Y = to select monitoring for the entire watch tree. N = to select monitoring for the directory only. For example, Y indicates that you are monitoring the entire watch tree.