Universal Enterprise Controller for z/OS
Overview
Universal Enterprise Controller (UEC) for z/OS executes as a started task.
JCL Procedure
The following figure illustrates the Universal Enterprise Controller for z/OS JCL procedure (UECTLR, located in the SUNVSAMP library).
//UECTLR PROC SHLQ=#SHLQ.UNV, // PHLQ=#PHLQ.UNV, // RGN=100M, // UPARM=, // LEPARM=, // CFG=UECCFG00 //S1 EXEC PGM=UECTLR,REGION=&RGN, // PARM='ENVAR(TZ=EST5EDT) &LEPARM/&UPARM' //STEPLIB DD DSN=&SHLQ..SUNVLOAD, // DISP=SHR //UNVCONF DD DSN=&PHLQ..UNVCONF(&CFG), // DISP=SHR //UNVNLS DD DSN=&SHLQ..SUNVNLS, // DISP=SHR //UNVDB DD DSN=&PHLQ..UECDB, // DISP=SHR //UNVMSGS DD SYSOUT=*,HOLD=YES //UNVPRSR DD SYSOUT=*,HOLD=YES //UNVTRACE DD SYSOUT=*,HOLD=YES //SYSPRINT DD SYSOUT=*,HOLD=YES //SYSOUT DD SYSOUT=*,HOLD=YES //CEEDUMP DD SYSOUT=*,HOLD=YES //SYSIN DD DUMMY
DD Statements used in JCL Procedure
The following table describes the DD statements used in the Universal Enterprise Controller for z/OS JCL procedure, above.
ddname | DCB Attributes | Mode | Description |
---|---|---|---|
STEPLIB | DSORG=PO, | input | Universal Agent load library containing the program being executed. |
UNVCONF | DSORG=PS, | input | UEC configuration member. |
UNVNLS | DSORG=PO, | input | Universal Agent national language support library. Contains message catalogs and code page translation tables. |
UNVDB | DSNTYPE=HFS | input, output | UEC database. Note This ddname is not used when zFS data sets are used instead of HFS data sets. |
UNVMSGS | DSORG=PS, | output | UEC message trace data. |
UNVPRSR | DSORG=PS, | output | UEC parser trace data. |
UNVTRACE | DSORG=PO, | output | UEC trace output. |
SYSPRINT | DSORG=PS, | output | Standard output file for the UEC program. |
SYSOUT | DSORG=PS, | output | Standard error file for the UEC program. |
SYSIN | DSORG=PS, | input | Standard input file for the UEC program. |
Configuration Options
The following table describes the configuration options used to execute Universal Enterprise Controller for z/OS.
Option Name | Description |
---|---|
Maximum number of simultaneous Broker queries allowed for each thread. | |
Number of process threads started to initiate Broker queries during a polling cycle. | |
Period of time within which a Broker query must finish before timing out. | |
Specification for whether or not UNV1059T alert messages (Broker responding) will be issued for initial Broker polls when Universal Enterprise Controller starts up. | |
UEC started task procedure ddname from which a PEM-formatted list of certificates is read. | |
UEC started task procedure ddname from which a PEM-formatted certificate is read. | |
File name / ddname of the PEM-formatted CRL. | |
Code page for text translation of network data. | |
Maximum number of UEC client sessions that can occur on each of the communications threads. | |
Number of threads created to perform communications between UEC and the UEC Client Applications. | |
Deletes completed commit configurations, by age. | |
Deletes incomplete commit configurations, by age. | |
Converts a pre-3.2.0 database into the current database format. | |
Specification for whether or not events are deleted on the Universal Broker after they are retrieved and put into the UEC events database. | |
Length of time to retain a resolved host name in memory cache. | |
Time interval at which the DNS cache is polled. | |
Write options help to SYSPRINT ddname. | |
Number of times that UEC will attempt to resolve the host name of a specified Universal Broker before it ends with a connect error. | |
Number of threads created to perform internal tasks in UEC. | |
Specification for whether or not monitor events are written into the UEC temporary database. | |
Specification for whether or not to log all XML message traffic between UEC and any connected applications. | |
Number of failed login attempts allowed by a user before being disconnected by UEC. | |
Location to which messages are written. | |
Language used for messages. | |
Level of messages written. | |
Length of time that state data is retained in the UEC database. | |
z/OS UNIX directory in which the HFS or zFS data set is mounted. | |
z/OS UNIX access permission mode value with which the mounted database file system's root directory is set. | |
Deletes event records, by age. | |
Time interval at which agents are polled. | |
UEC started task procedure ddname from which a PEM-formatted private key is read. | |
Password for the PRIVATE_KEY. | |
SAF certificate key ring name. | |
SAF certificate key ring label. | |
Interval (in seconds) at which the SAP systems are polled for their status and job activity. | |
IP interface from which to accept connections. | |
Port from which to accept connections. | |
SSL/TLS cipher suite to be used for network communications. | |
SSL/TLS implementation to be used for network configuration. | |
HFS directory in which Universal Enterprise Controller creates temporary files. | |
Maximum number of lines written to the trace ddname. | |
Size of the trace table. | |
HFS or zFS data set used for UEC's databases. | |
Time interval at which connected I-Activity Monitor clients are updated. | |
Authentication method to be used when authenticating UEC user accounts. | |
Writes the program version and copyright statement. |
Command Line Syntax
The following figure illustrates the command line syntax – using the long form of configuration options – of Universal Enterprise Controller for z/OS.
uec [-ca_certs ddname] [-cert ddname [-private_key ddname [-private_key_pwd pwd] ] ] [-crl ddname] [-codepage codepage] [-convert] [-hostname_retry_count count] [-keep_monitor_events option] [-dest destination] [-lang language] [-level {trace|audit|info|warn|error}] [-mount_point directory] [-mount_point_mode mode] [-unix_db_data_set DSN] [-saf_key_ring name] [-saf_key_ring_label label] [-svcipaddr ipaddress] [-svcport port] [-ssl_cipher_list cipherlist] [-ssl_implementation {openssl|system}] [-tracefilelines lines] uec { [-help] | [-version] }
For a description of the options, see Universal Enterprise Controller Configuration Options.