Note on usage
Function: Modifying openFT-Script user options
User group: FT user
Functional description
Functions for the user
Users are able to specify where their openFT-Script requests are to be stored. openFT-Script creates the following subdirectory in the specified working directory:
.openFT/<instance>/script (Unix systems)
.openFT\<instance>\script (Windows systems)
openFT-Script stores openFT-Script requests in it. The user in question then has write permissions for the subdirectory and it cannot be accessed by other users.
You use the ftmodsuo command to specify the directory in which the openFT-Script requests are to be stored. However, you can only do this if no openFT-Script is running and there are no current openFT-Script requests for the user. If necessary, you may have to cancel your running openFT-Script requests with ftcans and delete terminated openFT-Script requests with ftdels. The command is also rejected if another ftmodsuo command for the specification of an openFT-Script working directory is currently running under the same user ID.
Functions for the FT administrator
As FT administrator, you can set the following limits for openFT script requests:
Maximum number of threads which can be used by a user.
Maximum number of file transfer requests which can be triggered by a user simultaneously.
These settings apply for all users.
Format
ftmodsuo -h |
[ -wd=[ <directory name 1..128> ] ]
[ -u=@a [ -thl=[ thread limit 11..10000 ] ]
[ -ftl=[ file transfer limit 1..500 ] ] ]
Description
-h
Outputs the command syntax on screen. Any specifications after -h are ignored.
-wd
Absolute or relative path name of the working directory in which the subdirectory for the user's openFT-Script requests is to be created.
-wd= resets the working directory to the default value, i.e. the user's home directory.
-u=@a
Only for the FT administrator.
The specified openFT user option should apply for all Ftscript users. This parameter is mandatory when -thl and/or -ftl is specified, -u is not permitted when -wd is specified.
-thl=[thread limit]
Only for the FT administrator.
Maximum number of threads which the openFT script simultaneously executes in a Java VM of a user.
If this limit is exceeded during the continuation of an Ftscript run, then the run waits until a sufficient number of threads have been terminated (number of threads <= 3/4 * thread limit + 2). Then the openFT script starts again further threads and the Ftscript run is continued.
Possible values: 11 to 11000.
Default value: 250.
thread limit not specified
If you specify -thl= without value then thread limit is reset to the default value.
-ftl=[file transfer limit]
Only for the FT administrator.
Maximum number of simultaneous openFT file transfers which the openFT script triggers from a Java VM of a user.
If this limit is exceeded during the continuation of an Ftscript run then the run waits until a sufficient number of file transfer requests have been terminated. Then the openFT script starts again further file transfers and the Ftscript run is continued.
Possible values: 1 to 500.
If the specified value exceeds twice the openFT connection limit (value CONN-LIM in ftshwo), the default is then set.
Default value: openFT connection limit *2.
file transfer limit not specified
If you specify -ftl= without value then file transfer timit is reset to the default value.
ftmodsuo can also be specified without parameters but does nothing.