Versions Compared

Old Version 1

changes.mady.by.user Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Tony Partin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
Table of Contents


...

Warning

Currently, IBM i runs Workload Automation Universal Agent 7.7.0 for IBM i does not include Universal Command (UCMD) or Universal Data Mover (UDM).   Customers who require those components should use an older version of Workload Automation for IBM i.  The latest version containing those components is 5.1.1.  These pages provide information for that version.

...

Older versions of Workload Automation for IBM i can be installed alongside version 7.7.0.

Configuration

Universal Broker reads configuration options only from the Universal Broker configuration file.

The Universal Broker configuration file is named UNVPRD511UNVPRD770/UNVCONF(UBROKER). File UNVCONF is a physical source file located in the UNVPRD511 UNVPRD770 library. File member UBROKER contains the configuration options for the Universal Broker. File UNVCONF contains configuration members for the Workload Automation 5 Universal Agent for IBM i components. This file can be edited manually with any text editor.

...

This option was introduced to IBM i in version 5.1.1.0

.

This option was introduced to IBM i in version 5.1.1.0.

Option Name

Description

ACTIVITY_MONITORING

Specification for whether or not product activity monitoring events are generated.

CA_CERTIFICATES

Path to PEM formatted trusted CA X.509 certificates.

CERTIFICATE

Path to Broker's PEM formatted X.509 certificate.

CERTIFICATE_REVOCATION_LIST

Path to PEM formatted CRL.

CODE_PAGE

Text translation code page.

CTL_SSL_CIPHER_LIST

SSL/TLS cipher list for the control sessions.

DNS_CACHE_TIMEOUT

Time-out for DNS cache.

EVENT_GENERATION

Events to be generated as persistent events.

KEYSTORE_PATHSpecifies the location of a remote Universal Broker key store.

MESSAGE_DESTINATION

Location where messages are written.

MESSAGE_LANGUAGE

Language of written messages.

MESSAGE_LEVEL

Level of messages written.

MIN_SSL_PROTOCOL

Minimum SSL protocol level that will be negotiated and used for communications channels.

Note
titleNote

MONITOR_EVENT_EXPIRATION

Duration of a monitoring event record in the Universal Broker local UES database.

PERSISTENT_EVENT_EXPIRATION

Duration of a persistent event record in the Universal Broker local UES database.

PRIVATE_KEY

Path to Broker's PEM formatted RSA private key.

PRIVATE_KEY_PWD

Password for the Broker's PRIVATE_KEY.

REQUIRE_SSL

Specification for whether or not Universal Broker will enforce the use of SSL connections by the clients (managers) of Universal Command Server and Universal Data Mover Server,

Note
titleNote

RUNNING_MAX

Maximum number of simultaneous components.

SERVICE_BACKLOG

Service interface backlog size for pending connection requests.

SERVICE_IP_ADDRESS

TCP/IP address on which the Broker listens.

SERVICE_PORT

TCP/IP port number on which the Broker listens.

TRACE_FILE_LINES

Maximum number of lines written to the trace file.

TRACE_TABLE

Memory trace table specification.

...

...


Component Management

Anchor10753011075301Universal Broker is aware only of Universal Agent components that have been defined. It is the responsibility of Universal Broker to start, stop, and query these defined components. Anchor

10753021075302One of the steps in the installation of a component is defining it to the local Universal Broker. These component definitions provide Universal Broker with the necessary information that it needs to manage the components.

...

Component definitions are text files that define Universal Agent components to the Universal Broker. All IBM i component definitions are located in the source physical file UNVPRD511UNVPRD770/UNVCOMP as individual members.

...

Option Name

Description

AUTOMATICALLY_START

Specification for whether or not the component automatically starts by the Universal Broker at start-up time or only on demand.

COMPONENT_NAME

Name by which clients know the component.

COMPONENT_TYPE

Type of component.

CONFIGURATION_FILE *

Component's configuration file name.

RESTART

Specification for whether or not the component should be restarted if it ends.

RESTART_CONDITIONS

Exit conditions criteria for which the server is considered eligible for restart.

RESTART_DELAY

Number of seconds to wait before restarting.

RESTART_MAX_FREQUENCY

Maximum frequency a server can be restarted.

RUNNING_MAXIMUM

Maximum number of this component that can run simultaneously.

START_COMMAND *

Component program name.

WORKING_DIRECTORY *

Path used as the working directory of the component.

* These options are required in the component definitions.

...


Universal Access Control List

...

10743891074389Universal Broker uses the Universal Access Control List (UACL) file as an extra layer of security. The UACL file contains Universal Broker entries that contain Access Control List (ACL) rules that permit or deny access to the Broker. Anchor

10743911074391Universal Broker reads in the UACL entries when the program is started. If the UACL file is changed, the new entries can be activated either by:

  • Stopping and starting Universal Broker.
  • Sending Universal Broker a Universal Control REFRESH command, which instructs Universal Broker to reread all its configuration files, including the UACL file.

...

Panel
STRUCT REFRESH(*YES) HOST(hostname)

...

UACL Entries

...

The syntax of a UACL entry file is the same as the Universal Broker configuration file.

...