1 Introduction
2 Control Requests
3 JCL Procedure
- 3.1 DD Statements used in JCL Procedure
- 3.2 JCL
4 Configuration
- 4.1 Configuration Sources
  - 4.1.1 Configuration File
- 4.2 Configuration Options Categories
  - 4.2.1 Certificate Category Options
  - 4.2.2 Command Category Options
  - 4.2.3 Events Category Options
  - 4.2.4 Local Category Options
  - 4.2.5 Messages Category Options
  - 4.2.6 Miscellaneous Category Options
  - 4.2.7 Network Category Options
  - 4.2.8 Options Category Options
  - 4.2.9 Remote Category Options
  - 4.2.10 User Category Options
5 Command Line Syntax

Introduction

This Universal Control (UCTL) Manager information is specific to the z/OS operating system.

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

Control Requests

UCTL Manager for z/OS supports all three Universal Control control requests:

Start (START_CMD option)
Stop (STOP_CMD option)
Refresh (REFRESH_CMD option)

JCL Procedure

The following figure identifies the UCTL Manager for z/OS JCL procedure (UCTLPRC, located in the SUNVSAMP library) that is provided to simplify the execution JCL and future maintenance.

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

DD Statements used in JCL Procedure

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

ddname	DCB Attributes *	Mode	Description

ddname	DCB Attributes *	Mode	Description
STEPLIB	DSORG=PO, RECFM=U	Input	Load library containing the program being executed.
UNVNLS	DSORG=PO, RECFM=(F, FB, V, VB)	Input	UCTL national language support library. Contains message catalogs and code page translation tables.
UNVTRACE	DSORG=PS, RECFM=(F, FB, V, VB)	Output	UCTL trace output.
SYSPRINT	DSORG=PS, RECFM=(F, FB, V, VB)	Output	stdout file for the UCTL program. UCTL does not write any messages to SYSPRINT.
SYSOUT *	DSORG=PS, RECFM=(F, FB, V, VB)	Output	stderr file for the UCTL program. UCTL 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

JCL

The following figure illustrates the UCTL Manager for z/OS JCL using the UCTLPRC JCL procedure, above.

//jobname JOB CLASS=A,MSGCLASS=X //STEP1 EXEC UCTLPRC //SYSIN DD * -stop 10312932 -host dallas -userid joe -pwd akkSdiq /*

Job step STEP1 executes UCTLPRC.

The configuration options are specified on the SYSIN DD.

Configuration

Configuration consists of:

Setting default options and preferences for all executions of UCTL Manager.
Setting options and preferences for a single execution of UCTL Manager.

Configuration Sources

Configuration options are read from the following sources:

PARM keyword
SYSIN ddname
Command file ddname
Configuration file

The order of precedence is the same as the list above; command line being the highest, and configuration file being the lowest. That is, options specified via a PARM keyword override options specified via a SYSIN ddname, and so on.

Detailed information on these methods of configuration can be found in Configuration Management.

Configuration File

The UCTL Manager configuration file is provided to the manager by the local Universal Broker with which it registers. The UCTL Manager configuration file is located in the UCTCFG00 member of the PDSE allocated to the UNVCONF ddname in the Universal Broker started task.

The configuration file, provided by the local Universal Broker, provides the simplest method of specifying configuration options whose values will not change with each command invocation. These default values are used if the options are not read from one or more other sources.

Some options only can be specified in the configuration file; they have no corresponding command line equivalent. Other options cannot be specified in the configuration file; they must be specified via one or more other sources for a single execution of UCTL Manager.

Note

For any changes to the UCTL Manager configuration file to become active, a Universal Broker refresh is required, or the Universal Broker started task must be restarted.

Configuration Options Categories

The following table categorizes the configuration options used to execute Universal Control Manager for z/OS into logical areas of application. Each Category name is a link to a table of options in that category. Each Option Name in those tables is a link to detailed information about that option.

Category	Description

Category	Description
Command	Control command to execute.
Remote	Network address of the remote system.
User	User account the Control command executes with on the remote system.
Certificates	X.509 certificate related options.
Events	Options used to define event generation.
Local	Options required for local broker registration.
Messages	Universal Control message options.
Network	Options used to control the process of network data.
Options	Alternative methods to specify command options.
Miscellaneous	Options use to display command help and program versions.

Universal Control Manager for zOS