Log File Transfer Utility

 

For Catalysts with firmware version 1.83 or higher, there is a utility that has been developed to aid the retrieval of log files. This command line Log File Transfer Utility will allow you to download Catalyst log files, without the need for third party terminal applications, such as ProComm. The Log File Transfer Utility can be scheduled to transfer log files without operator interaction. Log files are saved in the Aware\Log directory.

To provide greater flexibility with how the data is retrieved, the transfer session will use the Transfer Options parameters set within Alarmware. Transfer Options enable data filtering and control over log file names and formats. In addition, LOGTRAN will perform error detecting and correcting due to line noise.

The session is initiated by delivering a command line to the Windows command line interpreter. This is accomplished by:

The command line syntax is either:

LOGTRAN RTU name direct uses Alarmwares comport settings to connect

LOGTRAN RTU name dial uses Alarmwares modem settings to connect

 

The RTU name argument must be identical with the RTU name configured with Alarmwares Select RTU dialog. If there are any blank spaces in the name, quotation marks must be used. All arguments must be specified. There are no abbreviations.

When the session has been initiated, LOGTRAN will attempt a session with the specified Catalyst using the specified communications resource. A small dialog window will indicate the session progress. The session may be aborted at any time.

LOGTRAN notes:

Instructions for setting up a desktop icon:

  1. Right-click on an empty space on your Windows desktop
  2. Select New and Shortcut
  3. Click the Browse button to locate logtran183.
  4. Click OK.
  5. Click Next.
  6. Enter a title for the icon. Describe the Catalysts duties or location.
  7. Click Finish.
  8. When the icon has been created on the desktop, right click on the icon and select Properties.
  9. The command line is shown here as the Target. The syntax Catalyst Name and dial has been added to the command line. Be sure that the Start in directory is the same as the directory where Aware and Logtran are located.
  10. Click OK.
  11. Double-clicking on the icon will now initiate a session to the configured Catalyst.

Instructions for adding a LOGTRAN task to the Windows Scheduler:

  1. From the Start menu, select Accessories | System Tools | Scheduled Tasks
  2. When the scheduler window appears, click on the Add a Scheduled Task icon. This will launch the Scheduled Task Wizard.

  1. Click Next.

  1. Click Browse.

  1. Browse for the Aware directory, then select logtran183.exe. Click Open.

  1. Type in a title for the Catalyst scheduled task. Provide some useful information within the title for later reference.
  2. Select the frequency of this scheduled task. In this example, Daily has been selected. Click Next.

  1. Set the time of day you would like the event to start. In this example, the scheduled task will begin at 12:00 noon. The task will be performed every day and will begin April 15, 2003. Click Next.

  1. The task has now been scheduled, but there are still some properties that need to be configured.
  2. Select the Open advanced properties for this task when I click Finish checkbox. Click Finish.
  3. The Catalyst task properties dialog will appear.

  1. On the Run line, modify the command line to include the Catalyst Name, followed by the connection type [direct or dial]. Ensure the Start in directory is the Aware directory.
  2. Click on the Schedule tab.

  1. Click on the Advanced button.

  1. In this example, the scheduler will repeat the task every 4 hours, for a 24 hour period. Click OK.

Notice the new Catalyst task is now listed among the scheduled tasks.