USER_COMMAND - UEM Manager configuration option
Description
The USER_COMMAND option specifies an application or script that the demand-driven UEM Server should execute whenever an event occurrence, or the event itself, enters one of the states specified by the EVENT_STATE option.
USER_COMMAND cannot be used with the HANDLER_ID or USER_SCRIPT options for a specified EVENT_STATE.
Examples
The following example is invalid:
-triggered -cmd dir -handler_id id001
In this example, it is unclear whether the UEM Server should execute the dir command or the actions contained in the stored event handler id001 when an event occurrence is set to a triggered state.
The following example is valid:
-triggered -handler_id id001 -expired -cmd dir
In this example, the -handler_id and -cmd options are specified for different event states.
- If an event occurrence is set to a triggered state, the UEM Server will execute the actions specified in the stored event handler id001.
- If the monitored event is set to an expired state, the UEM Server will execute the dir command.
A Stonebranch Tip
If a Windows UEM Manager has issued a request to monitor an event on a UNIX system, and the value specified by command contains a complete path, a leading space must be added to the path name, and the path must be enclosed in quotes.
For example, if the UEM Server is to execute an application named someapp that resides in /opt, the value specified for command must be "/opt/someapp".
This requirement is a result of the way that command line arguments are read by a Windows UEM Manager, where a forward slash ( / ) also can be used as a command option prefix. The leading space allows the string beginning with the / to be interpreted as a option value.
Usage
Method |
Syntax |
IBM i |
HP NonStop |
UNIX |
Windows |
z/OS |
Command Line, Short Form |
n/a |
|
|
|
|
|
Command Line, Long Form |
-cmd command |
|
|
|
|
|
Environment Variable |
n/a |
|
|
|
|
|
Configuration File Keyword |
n/a |
|
|
|
|
|
Value
command is the application or script to be executed.
If the application or script is not in the UEM Server home directory, or if it resides outside of the system path, the complete path to the file must be provided.
If command contains spaces, it must be enclosed in double ( " ) quotation marks.
UNIX and z/OS
If command contains spaces, it must be enclosed in either single ( ' ) or double ( " ) quotation marks.