script

You use script to specify a text string which is to be executed as an operating system command. A context object of type script can be referenced in the executeScript activity or by remoteSuccessScript or remoteFailureScript.
The command must be written in the operating system-specific syntax of each operating system. You can specify a different text string for each operating system in a script object.
openFT-Script selects the text string that is to be executed on the basis of the operating system specification in the partner definition or on the basis of the local operating system. If the operating system is unknown or no script matching the operating system is specified then the text string designated with script is executed.
The text string (script) is completely output by the ftshwact command. If this string contains passwords or related security-relevant information (e.g. for an ncopy command), then the ftshwact command outputs this information.
A return value other than zero is interpreted as an error and results in an ft_scriptError.

Restrictions

1. A script (e.g. bs2000Script, unixScript) may only occupy one line and its length is limited to 500 characters.

2. In this version, the script is not configurable.

Format

 <script id="ID" ref?="ID" repeatable?=true|false" >  
   comment?
   script?
   bs2000Script?
   unixScript?
   windowsScript?
   zosScript?
   partner?
 </script>

Attributes

Name	Value	Meaning
id	string	A unique ID in the current context. The context object is referenced under this ID.
ref	string	ID of another script object.
repeatable?	true | false	The default value is true. The script may be repeated on a restart. If false is specified then the script may not be repeated. If, on restart, it is not possible to determine whether the Ftscript has run then the entire Ftscript is cancelled.

Examples

See section “executeScript”.