UPS View User Guide Caterpillar

Text and Data File Logs

Log files are made up of data that your UPS generates during operation.

There are two basic types of log files:

• text log

• data log

Text Files

Text log files appear as text displayed in the UPS View text window.

Illustration 1	g01148877
Log Files in Text Window

When the system stores log file information, the data is stored as ASCII text. The text color is not stored in an ASCII log file, instead colors are designated as <Gre>,<Red>, and <Yel>.

Data Files

Data files contain telemetry channels and sequential time-stamped information. Data log files are in a Microsoft Excel® Comma Separated Values File format.

The log information is classified according to the following categories: Date, Time, Serial Number, Node ID, and Data Type.

Refer to table 1 for an abbreviated example of log information as listed in the text window.

Note: The "Serial Number" field is the MMU serial number whose data is stored in this log file. The DATE is the month, day, and year the file was created. NUM indicates the file number.

Each day the file number resets to zero (0). As new files of the same SN and "TYPE" are created each day, the file numbers increment to a maximum of 999.

The NUM field should not reach or exceed 999 in any 24 hour period.

"TYPE" denotes the type of information stored in a given log file. There are 21 possible values this field can have.

Note: You may retrieve your log files by accessing the log file directories under the "UPSView\Log ".

General Log Files

There are several types of log files generated by your UPS. Typical log files are described in the following paragraphs.

UPS View software automatically creates a set of log files once communication is established with the UPS. These files are periodically written at a rate you define.

You can change the logging rate under the UPS View "File" menu bar selection. See "Def. Data Log Rate" or "Log All Telemetry Data" under the "File" menu to change the logging rate.

General Log File Types are as follows:

• text is ASCII text strings as displayed in the UPS View "Text Log" display.

• data1 is "MMU Floating Point" tiles telemetry data.

• data2 is "MMU Status Tile", "Integer Tile", and "Text Tile" telemetry data.

• data3 is "MMU Three Phase" tile telemetry data.

• sys1 is "System Floating Point" tiles telemetry data.

• sys2 is "System Status Tile", "Integer Tile", and "Text Tile" telemetry data.

• sys3 is "System Three Phase Tile" telemetry data.

Dump Log Files

The dump log file system allows you to "dump" all text and telemetry data in UPS View to log files. UPS View caches (holds) approximately ten (10) minutes worth of UPS data at any time. All dump log files have the word "dump" in the file name.

To generate dump log files, perform the following:

1. Select the "File" menu.

2. Select the "Dump Telemetry Data to File" menu option.

Dump Log File Types:

• "dumpT " is the same as the "text" type (see the above paragraph entitled. "General Log Files"). " dumpT" is generated when you issue a "Dump" command.

• dumpM1_1 is the same as the "data1" type except that the "dumpM1_1" is generated when you select the "dump" command. The "_1" indicates the MMU node ID for the MMU whose data is stored in the file.

• dumpM2_1 is the same as the "data2" type except that the "dumpM2_1" is generated when you select the "dump" command. The "_1" indicates the MMU node ID for the MMU whose data is stored in the file.

• dumpM3_1 is the same as the "data3" type except that the "dumpM3_1" is generated when you select the "dump" command. The "_1" indicates the MMU node ID for the MMU whose data is stored in the file.

• dumpS1 is the same as the "sys1" type except that the "dumpS1" is generated when you select the "dump" command.

• dumpS2 is the same as the "sys2" type except that the "dumpS2" is generated when you select the "dump" command.

• dumpS3 is the same as the "sys3" type except that the "dumpS3" is generated when you select the "dump" command.

Event Log Files

The event log files work like automated dump logs. UPS View can be set up to dump automatically, all of the text and telemetry data to log files when an event occurs.

Events may be defined as conditions in the UPS that generate a buzzer. The buzzer can become active on either a "Notice" or "Alarm". UPS View can generate event logs for either a "Notice" buzzer, "Alarm" buzzer, or both. All event log files have the word "event" in the file name.

UPS View can also delay the creation of the event log by some user-defined number of seconds. This delay can be helpful in acquiring data both before and after an event occurs.

To configure UPS View for event log generation, select the "File" menu. Then select the "Log File Settings" menu option. This menu will open a dialog for configuring UPS View for event logs.

• "eventT " is the same as the "text" type except that "eventT"is generated when an event occurs.

• evenM1_1 is the same as the "data1" type except "evenM1_1" is generated when an "event" occurs. The "_1" indicates the MMU node ID of the MMU whose data is stored in the file.

• eventM2_1 is the same as the "data2" type except "eventM2_1" is generated when an "event" occurs. The "_1" indicates the MMU node ID of the MMU whose data is stored in the file.

• eventM3_1 is the same as the "data3" type except "eventM3_1" is generated when an "event" occurs. The "_1" indicates the MMU node ID of the MMU whose data is stored in the file.

• eventS1 is the same as the "sys1" type except that "eventS1" is generated when an "event" occurs.

• eventS2 is the same as the "sys2" type except that "eventS2" is generated when an "event" occurs.

• eventS3 the same as the "sys3" type except that "eventS3" is generated when an "event" occurs.

Log File Settings

The "Log File Settings" selection allows you to change the way your computer stores UPS information gathered by UPS View.

1. Select "File" from the default menu.
   Show/hide table

   Illustration 2	g01149016

2. Select "Log File Settings" from the drop-down menu. The window in illustration 3 should appear.

Illustration 3	g01149023

The "Log File Settings" option allows the user to define the "Log File Settings" and alter the way your system stores UPS information. The following list shows the settings that can be defined by the user.

• Maximum log file size (File size) - Allows the user to determine how large (how much data) the user wants the log file to contain. If the log file reaches this limit. a new file is created.

• File extension - The accepted default is "comma separated value" (.csv), however, you may also select .txt.

• Enable alarm event log - "Enable alarm event log", logs all telemetry when an alarm event occurs

• Enable notice event log - "Enable notice event log", logs all telemetry when a notice event occurs

• Optimize number of log files - "Optimize number of log files" limits the number of log files created. This limit is accomplished by not writing new log files each time you connect or disconnect to the UPS via UPS View. The system only creates another log file when the file size is reached or you command the system to make a new log file.

• Synchronize file creation - "Synchronize file creation", increments all log file types when one of the files reaches the file size.