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, | input | Universal Agent load library which contains the program to execute. |
UNVNLS | DSORG=PO, | input | Universal Agent national language support library. Contains message catalogs and code page translation tables. |
UNVTRACE | DSORG=PS, | output | UEM trace output. |
SYSPRINT | DSORG=PS, | output | Standard output file for the UEM program. UEM does not write any messages to SYSPRINT. |
SYSOUT | DSORG=PS, | 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.