OPTIONS - UEMLoad configuration option
Description
The OPTIONS option specifies a value that is passed as a command line argument to the process executed for an event handler.
UEM adds this value to the command string that it builds as it prepares the event handler process for execution.
OPTIONS is very similar to the HANDLER_OPTIONS option stored in the event definition. UEM adds the parameters for both as command line parameters to the command string built in order to execute an event handler process. The difference is that the value stored in HANDLER_OPTIONS is used for every event handler referenced by an event definition. For example, if an event definition contains a value for the TRIGGERED_HANDLER_ID and EXPIRED_HANDLER_ID, then the command line arguments stored in HANDLER_OPTIONS are passed to both handler processes.
On the other hand, the value stored in OPTIONS is used every time that the event handler's process is executed. Keep in mind that a single event handler record can be referenced by many event definition records. Because of this one-to-many relationship, UEM adds the value stored HANDLER_OPTIONS to the command string after the value stored in the event handler's OPTIONS. This effectively allows an event definition to change the behavior of an event handler by overriding command line parameters (assuming that the last duplicate parameter specified is the one used by the process).
Usage
Specification Method | Parameter / Value | IBM i | HP NonStop | UNIX | Windows | z/OS |
---|---|---|---|---|---|---|
Command Line, Short Form | n/a | |||||
Command Line, Long Form | -options string | |||||
Definition File Keyword | options string |
Value
string is the value passed as a command line argument.
A value of none can be used to remove the options string from an existing event handler record.
If string contains spaces, it must be enclosed in double ( " ) quotation marks.
UNIX | If string contains spaces, it must be enclosed either in single ( ' ) or double ( " ) quotation marks. |
---|---|
Windows | If quotes are to be passed as part of the parameter's value (for example, an argument that contains spaces is to be passed to the handler process and treated as a single argument), the required syntax depends on whether the parameter is specified from the command line or from a definition file. |
There is no default value for this option for new event handler records.