Handling an Expired Event - zOS

Owned by Stonebranch (Deactivated)
Last updated: Feb 01, 2024
2 min read

Handling an Expired Event in z/OS

In this example, a demand-driven UEM Server installed on a UNIX system watches for the creation of a file called uemtest.dat. The -filespec option contains no path information, so UEM Server looks for this file in uemuser's home directory.

A relative inactive date / time instructs the demand-driven Server to monitor the event for one (1) minute. If the UEM Server detects the file, and the file completes within that time, UEM sets the event occurrence to the triggered state. Since the command options contain no event handler information for a triggered occurrence, the UEM Server simply renames the file (by default). UEM Server then makes the event inactive, and ends.

If the UEM Server detects the file, but the file does not complete within 60 seconds, UEM sets the occurrence to the rejected state. Since the command options contain no event handler information for a rejected occurrence, the UEM Server leaves the file as-is and takes no further action.

If the UEM Server does not detect the presence of uemtest.dat before the inactive time elapses, it sets the event to the expired state. When this happens, the UEM Server executes the command specified by the -cmd parameter of the -expired option. In this example, UEM executes the ls -alR /home command.


Note

In this example, the -expired option is followed by the -options option, which redirects the output of the "ls -alR /home" command to a file in uemuser's home directory called uemtest.log.


//jobname  JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//STEP1    EXEC UEMPRC
//SYSIN    DD *
-event_type        file
-filespec          uemtest.dat
-inact_date_time   +1
-expired -cmd "ls -alR /home" -options ">uemtest.log 2>&1"
-host              uemhost
-userid            uemuser
-pwd               uemusers_password
/*

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.

-expired

Event state that, when encountered, will result in the execution of the associated event handler.

-cmd

Complete path to an application file or remote script that should be executed on behalf of the event handler.

-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.

Components

Universal Event Monitor Manager for z/OS

Universal Event Monitor Server for UNIX