Utilities: fx translators and database interfaces

Syntax

<fx program> {-h} {-c=<connect string>} {-comp=<n>} {-if=<input commands>}
    {-key=<shared memory key>} {-log=<log url>} {-mx=<host>:<port>}
	{-no_q} {-of=<output eim file>} {-prompt} {-start=<startup script>}
    {-url=<register url>}

Description

An external file translator or database interface.

Program

<fx program> can be one of the following:
   Translators:  fxacad, fxarc, fxeagle, fxigds, fxmif, fxntf, fxshape, fxvpf
   Database interfaces:  fx8i, fx9i, fx10g, fxinformix, fxmysql, fxodbc, fxsde

Parameters

None

Switches

• -h
  Print a usage summary on stderr.

• -c=<connect string>
  A database connection to connect to. This applies to database interfaces only. The format of <connect string> is pogram specific.

• -comp=<n>
  Run the translator with specific Fire compatibility. Some eim instructions are not compatible with early versions of Fire. To run a translator with versions of Fire prior to release 5, use -comp=<n>, where <n> is typically 3 or 4.

• -if=<input file>
  Take input from a script file of commands. This is an alternative to redirecting stdin.

• -key=<shared memory key>
  When the translator is initiated as a child process by Fire (aka client/server mode), this parameter supplies a handle to a shared memory segment for subsequent communication with Fire. This parameter should not be supplied when the translator is run manually.

• -log=<log url>
  When the translator is initiated as a network service by a service agent, the agent passes this parameter to tell the translator where to send its log messages. This parameter should not be supplied when the translator is run manually.

• -mx=<host>:<port>
  Run the translator in a peer-to-peer deployment with a running Fire session. <host>:<port> is a tcp socket connection corresponding to the value of the Fire identifier network_socket.

• -no_q
  Don't start in quiet mode (the default), when some messages get suppressed.

• -of=<output file>
  Direct eim output to an eim file. This is an alternative to redirecting stdout..

• -prompt
  Take command input from the keyboard, when the translator is being run from a DOS prompt.

• -start=<startup script>
  Specifies an initialization script, to be executed before any client connections.

• -url=<register url>
  Start the translator as a network service, registering it to a service broker. For details about registering web services consult the Translators and Database Interfaces User Guide

Notes

Translators and database interfaces take command input. There is a common command set available to all programs.

Individual translators and database interfaces extend this set on a per-program basis. Consult the following for details:

fxacad	fxarc	fxeagle
fxigds	fxmif	fxntf
fxshape	fxvpf
fx8i, fx9i, fx10g	fxinformix	fxodbc
fxmysql	fxsde

See Also