UEM Manager for zOS - Usage

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.