MODIFY-FT-INSTANCE

Note on usage

Function: Modify an openFT instance

User group: FT administrator

Functional description

Using this command, you can modify the characteristics of an instance (name, automatic start of openFT).

MODIFY-FT-INSTANCE may only be used if openFT is not started in this instance, (STARTED=*NO is displayed in the SHOW-FT-INSTANCE command).

WARNING!

The instance may not be renamed if - even though openFT has been terminated - the instance is still occupying system resources that contain the instance name. That is the case, for example, if requests with pre- or postprocessing are still entered under this instance.

Format

MODIFY-FT-INSTANCE

NAME = <alphanum-name 1..8>

,NEW-NAME = *UNCHA NGED / <alphanum-name 1..8>

,AUTOMATIC-START = *UNCHA NGED / *ON / *OFF

Operands

NAME = <alphanum-name 1..8>

Name of the openFT instance that is to be modified.

NEW-NAME = *UNCHANGED
The instance name remains unchanged.

NEW-NAME = <alphanum-name 1..8>
The new instance name. This name must be identical on all the computers on which this instance is to be used.

AUTOMATIC-START =

This is specified if, after loading the instance, openFT is automatically started in this instance.

AUTOMATIC-START = *UNCHANGED
The previous setting remains unchanged.

AUTOMATIC-START = *OFF
After loading the instance, openFT is not started.

AUTOMATIC-START = *ON
After each loading of the instance, a START-FT command is also implicitly executed in this instance. In this way, it is possible to work with openFT immediately after loading. All the components that are available for the standard instance are also started such as, for example, openFT-AC and openFT-FTAM.

Command return codes

(SC2)      SC1	Maincode	Meaning
83      32	CMD0221	Internal error.
25      64	FTR1025	Instance does not exist.
26      64	FTR1026	Instance must not be modified.

SC1/2 = Subcode 1/2 in decimal notation
For additional information, see section “Command return codes”