Handling an Event With a Script in z/OS

In this example, a demand-driven UEM Server installed on a Windows machine will watch for the creation of a file called uemtest.dat. Since no path is specified, it will look for this file in the user's UEM Server working directory.

A relative inactive date/time is used to instruct the UEM Server to monitor the event for 10 minutes. If the file is detected and completes within that time, the event occurrence will be set to the triggered state. The script statements contained within the MYSCRIPT DD statement then will be written to a temporary script file and executed by UEM Server.

The value specified by the -handler_opts option is appended to the command line constructed by UEM in order to execute the temporary script file. This will cause the values parm1, parm2, and parm3 to be passed to the script. Further, any output generated by the script will be written to a file in the UEM Server working directory, uemtest.log.

If the file is detected, but does not complete before the inactive time elapses, the event occurrence will be set to a rejected state. Since no event handler information is provided for a rejected occurrence, no further action will be taken by the UEM Server.

If the UEM Server does not detect the presence of uemtest.dat before the inactive time elapses, the event will be set to an expired state. Again, because no handler information is given for this state, no further action will be taken by the UEM Server.

SYSIN Options

The SYSIN options used in this example are:

Option	Description
-event_type	Type of event to monitor.
-filespec	Name or pattern of the file whose creation should be detected and tracked for completion.
-inact_date_time	Date and time at which the state of the monitored event should be made inactive.
-handler_opts	Forces the UEM Manager to wait for the completion of the UEM Server.
-host	List of one or more hosts upon which a command may run.
-userid	ID of a remote user account that the UEM Server uses to establish the security context in which event monitoring is performed.
-pwd	Password associated with -userid.
-triggered	Event state that, when encountered, will result in the execution of the associated event handler.
-script	Complete path to a local script file or DD statement that contains one or more system commands that should be executed on behalf of the event handler.

Components

Universal Event Monitor Manager for z/OS

Universal Event Monitor Server for Windows