Overview

UEM Manager for z/OS executes as a batch job.

JCL Procedure

The following figure illustrates the Universal Event Monitor for z/OS JCL procedure (UEMPRC, located in the SUNVSAMP library) that is provided to simplify the execution JCL and future maintenance.

//UEMPRC  PROC UPARM=,               -- UEM options
//             UEMPRE=#SHLQ.UNV
//*
//PS1      EXEC PGM=UEM,PARM='ENVAR(TZ=EST5EDT)/&UPARM'
//STEPLIB  DD  DISP=SHR,DSN=&UEMPRE..SUNVLOAD
//*
//UNVNLS   DD  DISP=SHR,DSN=&UEMPRE..SUNVNLS
//UNVTRACE DD  SYSOUT=*
//*
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//CEEDUMP  DD  SYSOUT=*

The symbolic parameter UPARM is provided to allow EXEC PARM keyword values to be specified for the UEM program. The PARM values to the left of the slash ( / ) character are IBM Language Environment (LE) parameters. (See the z/OS Installation for information regarding the customization of Language Environment parameters.)

The CONFIG symbolic parameter can be used to specify the name of the PDS member in which persistent configuration options for UEM Manager reside.

The UEMPRE symbolic parameter specifies the data set name prefix of Universal Agent installation data sets.

DD Statements used in JCL Procedure

The following table describes the DD statements used in the Universal Event Manager for z/OS JCL procedure, above.

ddname	DCB Attributes *	Mode	Description
STEPLIB	DSORG=PO, RECFM=U	input	Universal Agent load library which contains the program to execute.
UNVNLS	DSORG=PO, RECFM=(F, FB, V, VB)	input	Universal Agent national language support library. Contains message catalogs and code page translation tables.
UNVTRACE	DSORG=PS, RECFM=(F, FB, V, VB)	output	UEM trace output.
SYSPRINT	DSORG=PS, RECFM=(F, FB, V, VB)	output	Standard output file for the UEM program. UEM does not write any messages to SYSPRINT.
SYSOUT	DSORG=PS, RECFM=(F, FB, V, VB)	output	Standard error file for the UEM program. UEM writes its messages to SYSOUT.

* The C runtime library determines the default DCB attributes. Refer to the IBM manual OS/390 C/C++ Programming Guide for details on default DCB attributes for stream I/O.

DD Statement Categories

UEM Manager for z/OS DD statements are organized into the following categories:

Category	DD Statements
Runtime specifications	STEPLIB, UNVCONF, and UNVNLS.
UEM message and command files	SYSPRINT, SYSOUT, and UNVTRACE.
Command files	User-defined DD statements to which Universal Event Monitor commands refer.

JCL

The following figure illustrates the Universal Event Monitor for z/OS JCL using the UEMPRC JCL procedure, above.

//jobname JOB CLASS=A,MSGCLASS=X
//STEP1 EXEC UEMPRC
//ENCFILE DD DISP=SHR,DSN=UEM.UENCRYPT.USERINFO(MYHOST) 
//SYSIN   DD *
-event_type file -filespec "myfile*.dat" -host myhost 
-encryptedfile ENCFILE
/*

Job step STEP1 executes the procedure UEMPRC.

The command options are specified on the SYSIN DD.

In this example, a UEM Server is executed on the remote host myhost in order to detect the occurrence of a file that matches the file specification of myfile*.dat. The contents of ENCFILE include an encrypted user ID and password that are validated on the remote host.

Browser not supported