Options

The following commands have been implemented in EMUEScript exactly as they are implemented in OLIE™:

Syntax -

Options File <file specifications> Log <Log Options> LogMode <LogMode Option> Column <Starting Column> Timeout <Seconds>

       Where:

               <file specifications> is a literal string.

               <Log options> is one of three choices: All, Errors, or LogOnly.

               <LogMode option> is either append or overwrite.

<Starting Column> is a numeric value.

       <Seconds> is a numeric value.  

Description:  Unlike most EMUE commands, the Options command allows its parameters to be specified in any order as long as they appear as pairs where the option name is paired with the option value.  Additionally, one or more pairs can be specified.

File:  This option is used to define the input file.  If SetStartup InputFile has also been defined, the file specified in the Options line will be ignored.

Log:  The Log option determines how much logging will take place.

All: When All is specified, each record in the input file is also written to the log file as well as the contents of all Log and Logline commands.

Errors:   When Errors is specified, records from the input file that generate errors in the terminal are logged along with the contents of Log and Logline commands.

LogOnly: When LogOnly is specified, only the contents of the Log and Logline commands are written to the output log.

LogMode:  When Append is specified for the LogMode, then any logging that occurs will be appended to the log file if a file already exists with the same name.  When Overwrite is specified, if a file with the same name already exists, it will be overwritten.  

Column:  This option defines an offset in the file when the data does not start in the first position on the line.  This might happen if each record in the file has a header.  The default value is 1 and indicates that the data starts in the first position in the file.

Timeout: This option defines the amount of time in seconds that the host will wait before raising a host-timeout condition.  The default timeout is 30 seconds.

Note: This command is fully implemented as it was in OLIE, except that wildcards are not supported for the input file name.

Note: If no log file is specified and the Options line defines the input file, then, in maintaining backward compatibility with OLIE, a log file with the same name  as the input file will with a .log extension.

Sample:

       The following statement uses the Options command to define the input file as well as the logging behavior.

Options File "C:\EMUE\InputFiles\RPG643.txt" Log LogOnly

See Also:

InputFile

LogFile

Log

LogLine