OPTIONS - UEM Manager configuration option

Owned by Stonebranch (Deactivated)
Jul 03, 2023
2 min read

Description

The OPTIONS option specifies a value that UEM Server uses for command line arguments to an event handler process it executes for a given EVENT_STATE.

Any value specified for OPTIONS works in conjunction with —- not as a replacement of — any value specified by the HANDLER_OPTIONS option. UEM Server uses the values of both options to construct a list of one or more command line arguments. Any value specified by OPTIONS always precedes the value specified by HANDLER_OPTIONS.

OPTIONS allows an event definition to control handler process behavior for a specific EVENT_STATE.

For example, given the following UEM Manager command parameters:

-event_type file -filespec c:\uemfiles\somefile.txt -inact_date_time +1 

-handler_opts ">c:\uemlogs\somelog.txt 2>&1" 

-triggered -script c:\uemscripts\somescript.bat 

-expired -script c:\uemscripts\somescript.bat -options " -state expired"

If one or more occurrences of the event enter a triggered state, UEM Server (on Windows, in this example) executes c:\uemscripts\somescript.bat.

If the event expires, UEM Server also executes c:\uemscripts\somescript.bat, but sets the script's -state command line parameter to "expired".

UEM Server always redirects the script's stdout and stderr to c:\uemlogs\somelog.txt.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

-o string



(tick)

(tick)

(tick)

Command Line, Long Form

-options string



(tick)

(tick)

(tick)

Environment Variable

n/a






Configuration File Keyword

n/a






Values

string is a character string that UEM Server adds to the command line it constructs to execute an event handler process.

If string contains spaces, enclose it in double ( " ) quotation marks.


UNIX and z/OS

If string contains spaces, enclose it in single ( ' ) or double ( " ) quotation marks.

To pass quotation marks as part of the value (for example, it is necessary to treat an argument with spaces as a single command argument):

  • Enclose options in apostrophes.
  • Use quotation marks to enclose the quoted value.

For example, specifying -options 'parm1 "parm2a parm2b" parm3' instructs UEM Server to pass three arguments to the process it executes on behalf of the event handler. UEM Server treats the portion of the string enclosed in quotation marks ("parm2a parm2b") as a single value.