Note on usage
Function: Modify an instance
User group: FT administrator
Functional description
The ftmodi command allows you to assign another Internet host name address to an instance.
Note on using more than one instance
All instances must be explicitly assigned their own host name(option -addr with ftmodi or ftcrei). This also applies to standard instances.
Only on Windows systems: Using several openFT instances is only possible with the transport system TCP/IP. If you want to use several instances and you are using the TNS, you must delete all TNS entries specific to openFT which do not relate to TCP/IP.
Format
ftmodi -h | <instance 1..8> [ -addr=<host name> | -addr=@n ]
[ -ua=<user ID 1..32> ]
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
instance
Name of the instance to be modified. Instance names have a maximum length of 8 characters and must consist of alphanumeric characters. The first character must not be a number.
-addr=host name | -addr=@n
Internet host name whose assigned IP address is used to address the instance externally (destination address) and which is used as the sender address with outgoing connections. Changing -addr does not affect the instance's operating parameters instance ID and processor.
host name
A particular or another Internet host name can be assigned to the instance here.
@n for host name
This specification is only permitted for the standard instance std.
The standard instance is not assigned a particular host address anymore, and therefore it signs on for all addresses of the system.
In this manner you can switch from an operation with several instances to a one instance operation.
-ua=user ID
With this parameter root allocates an openFT instance to another user in single-user mode on Unix systems. The new owner of the instance also becomes its FTAC administrator. If the previous owner of the instance had ADM administrator permission, this is then transferred to the new owner.
The changing of the owner of an instance with ftmodi should as a matter of principle not be done during ongoing openFT operation because an asynchronous openFT server or Ftscript jobs running at the time the command is executed will be stopped.
The Ftscript user options (including those of the openFT ID) are deleted. The Ftscript runs of unauthorized IDs can no longer be accessed using openFT resources.
Examples
The host with the name MAPLE is assigned to the standard instance. Local requests to 127.0.0.1 are thus no longer possible. The command is as follows:
ftmodi std -addr=MAPLEThe standard instance is to log in with all IP addresses of a system again and listen to all addresses. The command is as follows:
ftmodi std -addr=@n
Messages of the ftmodi command
If ftmodi could not be executed properly, a self-explaining message is output. The exit code is not equal zero in this case.