Definition File Format for UNIX

The format of the definition load file for events and event handlers follows the keyword / value-pair convention used for Universal Agent configuration files. However, because more than one definition can be specified in a load file, some additional conventions are used.

• The begin_event and end_event keywords are used to mark the beginning and end, respectively, of each event definition entry.
• The begin_handler and end_handler keywords are used to mark the beginning and end, respectively, of each event handler entry.
• The begin_script and end_script keywords are used to mark the beginning and end, respectively, of any user script contained in the definition load file.

Lines that belong to the script must begin with the stmt keyword. Long stmt values that have to be split across lines can be done so using the + and - line continuation characters (as described in Configuration File Syntax). These lines will be accepted verbatim, and no script syntax validation will be done. Lines will continue to be added to the script until an end_script, end_handler, begin_handler, or begin_event keyword is read, or the end of the file is reached.

If a parameter's value contains spaces, it must be enclosed in single ( ' ) or double ( " ) quotation marks.

If quotes are to be saved as part of the parameter's value, enclose the value in single ( ' ) quotation marks quotes, and use a set of double ( " ) quotation marks to enclose the quoted value (for example, optname 'optval1 "optval2 optval2a" optval3').

The script keyword can be used in lieu of a begin_script/end_script block, in which case the contents of the specified file will be written to the event handler.

A sample definition file for UNIX is shown in the following figure.

# Indented lines are for illustration only.  Leading spaces are
# ignored by UEMLoad.  Defaults will be used for any omitted 
# values.

# Start of parameters for an event definition with an ID of
# "unix_event_sample".  

begin_event
   event_id unix_event_sample
   event_type FILE
   comp_name uems
   state enable
   inact_date_time 2011.12.31,23:59
   triggered_id unix_script_sample
   filespec 'uem*.dat'
   rename_file yes
   rename_filespec '$(compname).$(compid).$(date).$(seqno)'
end_event

# End of parameters for event definition "unix_event_sample".

# Start of parameters for an event handler with an ID of 
# "unix_script_sample".

begin_handler
   handler_id unix_script_sample
   handler_type SCRIPT
   maxrc 0
   userid uemuser
   begin_script
      stmt "#!/bin/sh"
      stmt ""
      stmt 'ls -al "/home/uem user"'
   end_script
   script_type bat
end_handler

# End of parameters for event handler "unix_script_sample".

# Start of parameters for an event definition with an ID of
# "unix_cmd_sample".

begin_handler
   handler_id unix_cmd_sample
   maxrc 0
   userid uemuser
   cmd 'homeuem usersomeapp'
end_handler

# End of parameters for event definition "unix_cmd_sample".

Definition File Options

The Definition File options used in this example are:

Components

UEMLoad Utility for UNIX