Command Line Options for AAMTCP.exe

The following table lists the available command line options for the Auto Alarm Manager application using TCP/IP (AAMTCP.exe). You can use these command lines, for instance, to update the [AUTO ALARM TCPIP] section of the FIX.ini.

Command

Description

-B[num]

Allows you to adjust the size of the global string buffer for the messages sent to Mission Control. The [num] variable represents the maximum number of messages to be sent before the buffer begins recycling.

Example: AAMTCP.exe –B80

NOTE: If you do not include this command line option, the default global string buffer is 50 messages. In this case, you can see 50 messages in Mission Control before the buffer starts to recycle.

-D[num]

Allows you to specify a delay, in seconds, to wait after stopping the RAS Client or Server (service). The [num] variable represents the number of seconds to wait.

The minimum value you can configure is 10 seconds. The maximum is 999 seconds.

Example: AAMTCP.exe -D30

NOTE: If you do not include this command line option, the default delay time is the WIN32 delay, typically 200 seconds.

-F

Allows you to flush the user queue when transitioning the Receiver node from Disabled to Enabled. You must have the Receiving Tagname [node:tag] option configured in the SCU in the Auto Alarm Manager Configuration dialog box to use this command line option.

Example: AAMTCP.exe -F

-L

Allows you to run the AAMTCP over a LAN. When you use this command line option, do not use the RAS dial-up.

This option assumes that you have an Ethernet TCP/IP connection already established between the Auto Alarm Manager's Sender and Receiver nodes during iFIX startup.

NOTE: This feature is supported for iFIX 4.0 and greater; it is not supported in FIX32.

Example: AAMTCP.exe -L

-Q[1 | 2]

There are two messages queues that you can use with AAM: WUSERQ1 or WUSERQ2. By default, -Q1 for WUSERQ1 is assumed, whether or not you specify the -Q1 command line option. Otherwise, if you want to specify WUSERQ2, use the -Q2 command to indicate that you want to use the WUSERQ2 message queue.

Example: AAMTCP.exe -Q2

To indicate the size of the queue, add the size value after the WUSERQ1.EXE or WUSERQ2.EXE command line that runs on iFIX startup. For example, in the FIX.ini file, this is how it would look if you wanted to use WUSERQ2 message queue with a size of 5000:

...

[AUTO ALARM TCPIP]

RUN=%WUSERQ2.EXE 5000

RUN=%AAMTCP.EXE –Q2

...

To use WUSERQ1 with a queue size of 2000, here is how the FIX.ini file would look:

...

[AUTO ALARM TCPIP]

RUN=%WUSERQ1.EXE 2000

RUN=%AAMTCP.EXE

...

-R[num]

Allows you to specify a single digit number for the allowable number of retries for the iFIX TCP/IP networking connection. The [num] variable represents the number of retries.

The minimum value you can configure is 1 retry. The maximum is 5 retries.

Example: AAMTCP.exe -R4

NOTE: If you do not include this command line option, the default number of retries is 3.

-W[num]

Allows you to specify a double digit number for the maximum allowable wait time between the iFIX TCP/IP networking connection time-out and the retry event. The [num] variable represents the number of seconds.

The minimum value you can configure is 10 seconds. The maximum is 99 seconds.

Example: AAMTCP.exe -W45

NOTE: If you do not include this command line option, the default number of seconds to wait for an iFIX TCP/IP connection is up to 30 seconds.

NOTES:

  • When using a command line option, you can preface it with either a dash (-) or forward slash (/). Do not put a space between the dash or forward slash and the command option. If there is a number following the command line option, there should be no space separating the command from the number.
  • The command line options are case insensitive; you can use CAPITAL or lowercase letters.
  • The command line options do not have to be in any particular order. You can combine as many as you need.

To add command line parameters in the FIX.INI file:

  1. Open the FIX.INI file in a text editor, such as Notepad. By default, the FIX.INI resides in the C:\Program Files (x86)\Proficy\iFIX\LOCAL folder.
  2. Locate the [AUTO ALARM TCPIP] section.
  3. Locate the following line and add the command line parameters you want to the end of it:

RUN=%AAMTCP.EXE

    For example, to specify the /F parameter, edit the line to match the following:

RUN=%AAMTCP.EXE /F

  1. Save the file.

 

See Also

How Do I...