----

UNV5300E Error initializing Configuration Manager subsystem: func, errno, reason

Description

An error occurred when initializing the Configuration Manager subsystem. func is the name of the function in which the error occurred. errno is the error number. reason is an explanation of the error.

Severity

Error

System Action

The program terminates.

User Action

Take corrective action based on the error information provided in this and any previous messages potentially printed. Contact Stonebranch Customer support for assistance if needed.

Component

Universal Broker

----

UNV5301E Broker databases were not properly closed. Database validation required.

Description

The Universal Broker databases were not properly closed. This may have been due to the Broker not being shutdown properly or the operating system halting abnormally. A database validation is strongly recommended.

Severity

Error

System Action

The Broker will validate all databases as part of the initialization phase.

User Action

Determine the reason the Broker was not properly shutdown. The Broker should be shutdown properly for it to close all databases and maintain data integrity.

Component

Universal Broker

----

UNV5302I Broker databases validation has started. Do not shutdown the Broker until validation completes.

Description

Universal Broker database validation has started. All Broker databases shall be validated. Once validation completes successfully, the Broker will begin providing services.

Severity

Informational

System Action

Broker database validation continues.

User Action

Do not interrupt the validation process, otherwise data integrity may be compromised.

Component

Universal Broker

----

UNV5303I Broker databases validation has completed successfully.

Description

Universal Broker database validation has completed successfully.

Severity

Informational

System Action

Broker initialization continues.

User Action

No action required.

Component

Universal Broker

----

UNV5304E Broker databases validation has failed.

Description

Universal Broker database validation failed to complete successfully. The integrity of the databases cannot be verified.

Severity

Error

System Action

Broker terminates.

User Action

The Broker databases must be recovered or deleted. Refer to the Universal Broker database administration documentation for database recovery procedures.

Component

Universal Broker

----

UNV5305E Error validating the cmpname database: func, errno, reason

Description

An error occurred validating the database for component cmpname. func is the name of the function in which the error occurred. errno is the error number. reason is an explanation of the error.

Severity

Error

System Action

The program terminates.

User Action

Refer to the user action of messages following this one. Most likely database recovery is required.

Component

Universal Broker

----

UNV5306E The Universal Event Subsystem has stopped event read operations due to database I/O errors.

Description

The Universal Event Subsystem encountered consecutive database I/O errors while reading event records from the UES database. Consequentially, it has halted event reading operations.

Severity

Error

System Action

The Universal Event Subsystem stops reading event records. The Broker will not provide any events to Universal Enterprise Controllers querying the Broker for event records. The Broker will not perform any UES database cleanup functions as well.

User Action

The reason for the database errors should be resolved as soon as possible. The Broker should be stopped and the databases recovered or deleted. Refer to the Opswise Universal Agent Installation and Administration Guide for database recovery procedures. Contact Stonebranch Customer Support is assistance as needed.

Component

Universal Broker

----

UNV5307E The database file system, loc, has run out of available disk space.

Description

There is no available disk space for the Broker databases to grow. The Broker utilizes a number of databases in performing the services it provides. Without operational databases, the Broker cannot continue. The location of the databases is specified by loc.

Severity

Error

System Action

The Broker shuts down.

User Action

Check the size of the Broker databases. When event recording is activated, the UES database will continue to grow until either Universal Enterprise Controller pulls the event records and requests for their deletion or the event records expire. If the database sizes are within norm, allocate additional disk space to the location in which the Broker maintains its databases. Once the space shortage is relieved, the Broker may be restarted.

Component

Universal Broker

----

UNV5308W Decreased maximum number of components from cfgmax to newmax to meet FD_SETSIZE limits.

Description

The maximum number of running components that Broker will manage was changed from cfgmax to newmax. The change was made so that the Broker would not reach file and socket descriptor limits imposed by the operating system FD_SETSIZE value. The operating system FD_SETSIZE limit is newmax plus 1.

Severity

Warning

System Action

The Broker continues processing with the new limit in effect.

User Action

If the Broker needs to manage the maximum number of components specified contact Stonebranch Customer Support. The FD_SETSIZE is set by the operating system when the product is built. It is not a run-time resource limit.

Component

Universal Broker

----

UNV5309W Forcing end of job for manager component comp compid. Ending abnormally with exit code exitcode (hex).

Description

The manager component identified by component name comp and component ID compid was being managed by a previously executing Broker. The Broker cannot manage components that were started by a previous execution of the Broker. The component is being forced through the Broker's end of job processing. The Broker does not know if the component stopped executing or not, so its exit conditions are unknown. The component exit conditions will be set to an abnormal exit status and exit code exitcode.

Severity

Warning

System Action

The program continues.

User Action

If possible, avoid stopping the Broker when work is in progress. If the Broker must be stopped, stop the Broker in a controlled manner. Refer to Universal Broker Reference manual for the proper shutdown method for the platform.

Component

Universal Broker

----

UNV5310W Forcing end of job for server component comp compid (pid). Ending abnormally with exit code exitcode (hex).

Description

The server component identified by component name comp, component ID compid and process ID pid was being managed by a previously executing Broker. The Broker cannot manage components that were started by a previous execution of the Broker. The component is being forced through the Broker's end of job processing. The Broker does not know if the component stopped executing or not, so its exit conditions are unknown. The component exit conditions will be set to an abnormal exit status and exit code exitcode.

Severity

Warning

System Action

The program continues.

User Action

If possible, avoid stopping the Broker when work is in progress. If the Broker must be stopped, stop the Broker in a controlled manner. Refer to Universal Broker Reference manual for the proper shutdown method for the platform.

Component

Universal Broker

----

UNV5311W Access denied by Default entry UACL entry to user rmtuser at IP address rmtaddr.

Description

The Universal Access Control List (UACL) entry entry denied access to the remote user rmtuser at IP address rmtaddr. Access was denied because the UACL entry entry, by default, denies all access unless explicit access rights are given to allow access.

Severity

Warning

System Action

The client request that was denied access to the resource is terminated.

User Action

Report the access denial to the party responsible for security setup of the Universal Broker.

Component

Universal Broker

----

UNV5312I Broker database: type file system dsn mounted at mount.

Description

The message provides information about the USS file system used for the Broker database. type identifies the type of file system, dsn is the data set name containing the file system, and mount is the mount point in the USS file system.

Severity

Informational

System Action

Processing continues.

User Action

No action necessary.

Component

Universal Broker

----

UNV5313I Broker spool: type file system dsn mounted at mount.

Description

The message provides information about the USS file system used for the Broker spool. type identifies the type of file system, dsn is the data set name containing the file system, and mount is the mount point in the USS file system.

Severity

Informational

System Action

Processing continues.

User Action

No action necessary.

Component

Universal Broker

----

UNV5314E A system error occurred while attempting to start the Universal Broker. Check the AS/400 log file for previously listed messages.

Description

Two Universal Brokers cannot execute and share common resources at the same time. To prevent two Brokers from running an exclusive lock is obtained on the Broker executable. A system error occurred while attempting to obtain this system lock.

Severity

Error

System Action

The program terminates.

User Action

Examine the Broker log for other messages that might indicate the cause of the problem. If the problem persists, contact Stonebranch customer support.

Component

Universal Broker

----

UNV5315E A system error occurred while attempting to deallocate the Universal Broker executable. Check the AS/400 log file for previously listed messages.

Description

Two Universal Brokers cannot execute and share common resources at the same time. To prevent two Brokers from running an exclusive lock is obtained on the Broker executable. A system error occurred while attempting to remove this Universal Broker lock.

Severity

Error

System Action

Shutdown of Universal Broker continues.

User Action

Examine the Broker log for other messages that might indicate the cause of the problem. Manually remove the UBroker exclusive lock if needed. If the problem persists, contact Stonebranch customer support.

Component

Universal Broker

----

UNV5316I Component compname compid meets restart criteria. Restart scheduled in delay seconds.

Description

An instance of the component named compname with component ID compid ended with an exit condition that meets the restart criteria defined in its component definition. The component will be scheduled to restart in delay seconds.

Severity

Informational

System Action

The component will be scheduled for restart.

User Action

If the component ended unexpectedly, determine the reason it shutdown, and take corrective action to prevent further unexpected shutdowns.

Component

Universal Broker

----

UNV5317E A error occurred while scheduling component compname for restart: func, errno, reason

Description

An error occurred while scheduling component named compname for restart. The restart will not occur due to the error. p>func is the name of the function in which the error occurred. errno is the error number. reason is an explanation of the error.

Severity

Error

System Action

The component restart is canceled.

User Action

Report the problem to Stonebranch customer support.

Component

Universal Broker

----

UNV5318E Error restarting component compname: func, errno, reason

Description

Universal Broker failed to restart the component identified by compname. The component is an auto-start component that was scheduled for restart. func is the name of the function in which the error occurred. rc is the error number. reason is an explanation of the error.

Severity

Error

System Action

The Broker continues processing.

User Action

Check the component definition file to make sure the information there is correct. If the problem persists, contact Stonebranch customer support.

Component

Universal Broker

----

UNV5319E Error calculating restart frequency for component compname compid: func, errno, reason

Description

An error occurred attempting to calculate the restart frequency for component compname. The component is an auto-start component that is eligible for restart based on its exit criteria and the exit conditions of component ID compid. func is the name of the function in which the error occurred. rc is the error number. reason is an explanation of the error.

Severity

Error

System Action

The Broker continues processing, but the component will not be restarted.

User Action

Report the problem to Stonebranch customer support.

Component

Universal Broker

----

UNV5320W Server component compname restart frequency has been exceeded. Server will not be restarted.

Description

The auto-start server compname is eligible for restart but it has exceeded its restart frequency as defined in the component definition. The server will not be restarted.

Severity

Warn

System Action

The Broker continues processing. The the component will not be restarted.

User Action

Determine the reason for the server component stopping and take corrective action to resolve the problem. Restart the server once the problem has been resolved.

Component

Universal Broker

----

UNV5321W Component compname compid does not meet restart criteria. Server will not be restarted.

Description

The auto-start server component compnaem is defined to be restarted under certiain conditions. The exit conditions of component #ID compid do not meet the restart criteria specified in the component definition.

Severity

Warn

System Action

The component will not be restarted.

User Action

If the component ended unexpectedly, determine the reason it shutdown, and take corrective action to prevent further unexpected shutdowns. Restart the server once the problem has been resolved.

Component

Universal Broker

----

UNV5322E Component definition for non-autostart component compname is incorrectly configured for component restart.

Description

The component restart feature is only available for autostart servers. The component named compname is not configured as an autostart server but is configured to use component restart.

Severity

Error

System Action

If the error is detected during Broker initialization, the Broker fails initiailization and shuts down. If the error occurred during a configuration refresh operation, the Broker continues processing.

User Action

Change the component definition RESTART option or AUTO_START option as needed.

Component

Universal Broker

----

UNV5323E Error processing console interface request: func, errno, reason

Description

Universal Broker received a message from the z/OS console and encountered an error processing the message. func is the name of the function in which the error occurred. errno is the error number. reason is an explanation of the error.

Severity

Error

System Action

The program continues processing.

User Action

If the problem persists, contact Stonebranch customer support.

Component

Universal Broker

----

UNV5324E Console interface open error: func, errno, reason

Description

The console interface used to process MODIFY commands could not be opened. func is the name of the function in which the error occurred. errno is the error number. reason is an explanation of the error.

Severity

Error

System Action

The program terminates.

User Action

If the problem persists, contact Stonebranch customer support.

Component

Universal Broker

----

UNV5325E Error processing console command 'cmd': func, errno, pm>reason

Description

An error occurred processing console command cmd. func is the name of the function in which the error occurred. errno is the error number. reason is an explanation of the error.

Severity

Error

System Action

The program continues processing.

User Action

If the problem persists, contact Stonebranch customer support.

Component

Universal Broker

----

UNV5326I Universal Broker is executing without superuser permission.

Description

Universal Broker is executing with a user identifier that does not have superuser permission. Universal Broker typically executes with superuser permission in order to provide its full range of services. However the product can be configured with specific services diabled so that superuser access is not required.

Severity

Informational

System Action

Processing continues. If the product is not configured to run without superuser permission, potential security access errors may occur in the Universal Broker or in the server components.

User Action

No action required.

Component

Universal Broker

----

UNV5327E Universal Broker real and effective uids are different: real=ruid, effective=euid.

Description

The Universal Broker process (ubroker or ubrokerd) must be started using the ubrokerd script. The ubrokerd script starts the Universal Broker process so that both the real and effective uid values of the process are the same non-root value. For security purposes, it is not safe to run the Universal Broker with differing uid values. The Broker real uid value is ruid and the effective uid is euid.

Severity

Error

System Action

The Broker terminates process.

User Action

Start the Universal Broker with the ubrokerd script.

Component

Universal Broker

----

UNV5328E Failure setting up external link

Description

The Broker failed to create an external link for launching Universal

Agent components.

Severity

Error

System Action

The Broker will exit.

User Action

Make sure the Broker is properly installed.

Component

Universal Broker

----

UNV5329E Failure removing external link

Description

The Broker failed to remove an external link for launching Universal

Agent components.

Severity

Error

System Action

An error is issued.

User Action

Make sure the Broker is properly installed.

Component

Universal Broker

----

UNV5330E Failure setting up external link to DD:ddname: message

Description

The Broker failed to create an external link for launching external commands in USS to the dataset reference by ddname. message is the reason for the failure.

Severity

Error

System Action

The Broker will exit.

User Action

Make sure the Broker is properly installed and access is available to the temporary directory.

Component

Universal Broker

----

UNV5331E The Broker load library is not APF authorized

Description

The Broker load library, or one of the libraries in the STEPLIB is not

APF authorized.

Severity

Error

System Action

The Broker will exit.

User Action

Make sure the Broker load library and all concatenated libraries in the

STEPLIB are properly APF authorized.

Component

Universal Broker

----

UNV5332E Keystore directory verification failed: dir, func, reason

Description

The user account running the ubroker program does not have sufficient access to the keystore directory, specified by dir. func is the name of the function in which the error occurred. reason is an explanation of the error.

Severity

Error

System Action

The program terminates.

User Action

Make sure the user account running the ubroker program has the authority to create and write to files in the directory specified by dir.

Component

Universal Broker

----

UNV5333E Cannot access keystore directory 'dir': reason

Description

The keystore directory cannot be accessed. dir is the path name of the keystore directory as specified in the ubroker configuration. This is relative to the installation directory. reason is an explanation of the error. The keystore directory is the location in which ubroker creates default keys used to encrypt and decrypt Universal Agent command files.

Severity

Error

System Action

The program terminates.

User Action

Change the keystore directory in the ubroker configuration to a valid directory name.

Component

Universal Broker

----

UNV5334E Error retrieving an encryption key of type type from the keystore in path: func, errno, reason

Description

The Universal Broker was unable to obtain an encryption key from the store location that resides at path. type uniquely indentifies the key and is specific to encryption method for which the key is used. func is the name of the function in which the error occurred. errno is the error number and reason is an explanation of the error.

Severity

Error

System Action

The program terminates. If the Universal Broker issues this message, it means that an encryption key file exists in the keystore location, but the file doesn't contain the requested key type or is corrupt.

User Action

If the keystore file has been corrupted, it may be necessary to recreate the file or remove the file. This means that any Universal Encrypted files generated with that key will also need to be recreated. Otherwise, attempts to decrypt them will fail.

If the keystore file exists in another location, it may be possible to install that file to this Broker's keystore. The file system encodings must be the same, however, because a binary transfer of the file must be done.

Conact Stonebranch customer support if the problem can't be identified or resolved.

Component

Universal Broker

----

UNV5335E Error retrieving an encryption key of type type from the remote keystore at loc: func, errno, reason

Description

The Universal Broker was unable to obtain an encryption key from the remote store location hosted by the Broker at loc. type uniquely indentifies the key and is specific to encryption method for which the key is used. func is the name of the function in which the error occurred. errno is the error number and reason is an explanation of the error.

Severity

Error

System Action

Several conditions may cause the Broker to issue this message. The Broker may not be able to connect to the remote Broker. The remote Broker's version may be earlier than 6.4.0.0, and the keystore query request is unrecognized. The remote Broker may not have any encyrption keys stored in its keystore. Other unexpected conditions will also be reported.

User Action

Review the error messages to identify the cause of the problem. If the Broker executing at the identified location isn't expected or intended to host a keystore, then change the local Broker's configuration. If keystore is corrupted, then it may be necessary to generate new keys. Universal Encrypted files that rely on the keys stored in that keystore must be recreated, or attempts to decrypt them using the new key will fail.

Conact Stonebranch customer support if the problem can't be identified or resolved.

Component

Universal Broker

----

UNV5336E Error saving the encryption key to the local keystore file, fname:, errno, reason

Description

An attempt to save an encryption key to the local keystore and file specified by fname failed. errno is the error number and reason is an explanation of the error.

Severity

Error

System Action

The program terminates.

User Action

Ensure the Broker has access to the specified file's directory and try again. Contact Stonebranch customer support if the problem persists.

Component

Universal Broker

----

UNV5337I Encryption key request received from remote host at ipaddr.

Description

The Universal Broker issues this message whenever it receives a request for an encryption key stored in the local Universal Keystore. This is a normal request that remote Universal Agent components will issue if they are configured to request a key from this Broker. If the remote component is another Broker, then it will cache this key after successful retrieval, making it available for Universal Agent components running on that system.

ipaddr is the IP address of the remote system upon which the Universal Agent component is installed.

Severity

Informational

System Action

The program continues.

User Action

Note the location of the incoming request. If a Universal Agent is installed there, no further action is needed. If no Agent component exists on that system, identify the request's source and remove its access to this Broker.

Component

Universal Broker

----

UNV5338E Cannot access Broker interface file directory 'dir': reason

Description

The Broker interface file directory, used to store local Broker interface information for Manager components, could not be accessed. dir is complete path name of the interface file directory. reason is an explanation of the error.

Severity

Error

System Action

The program terminates.

User Action

Make sure the directory exists and the user account running the ubroker program has access to this directory.

Component

Universal Broker

----

UNV5339I The Universal Broker service svcname was successfully removed.

Description

Reports that removal of a Universal Broker installed via a user mode install was successful. The Broker identified by svcname is removed from the Service Control Manager along with its registered event source.

Severity

Informational

System Action

The program ends successfully.

User Action

None required.

Component

Universal Broker

----

UNV5340I License Information Received: CUSTOMER customer, EXPIREDATE expdate (dateval), DISTRIBUTED distcnt, ZOS zoscnt, USAP usapcnt, UPPS uppscnt, SOA proto, REGISTERED reg

Description

Displays the licence information received from the Universal Controller.

- customer is the name of the license holder.

- expdate is the raw expiration date/time, expressed as the number of seconds since January 1, 1970 00:00:00 UTC.

- dateval is the value expressed in a readable local date/time.

- distcnt is the number of distributed agents licensed by the Universal Controller.

- zoscnt is the number of zOS agents licensed by the Universal Controller, including any agents running on sysplex partner systems.

- usapcnt is the total number of concurrent SAP connections that are available for distribution among all USAP components.

- uppscnt is the total number of concurrent PeopleSoft connections that are available for distribution among all UPPS components.

- proto is a value that represents the Web service protocols Universal Agent for SOA may use.

- reg indicates whether or not the agent obtained a license from Universal Controller. When this value is "no", it likely indicates that all available distributed or zOS agent licenses have been consumed.

Severity

Informational

System Action

The program continues.

User Action

None required. This information is provided to simplify any license-related troubleshooting.

Component

Universal Broker

----

UNV5341E The Universal Controller was unable to grant a license to this agent (errno): reason

Description

The agent expected to receive a license from a Universal Controller, but the Controller refused to grant a license to the agent. errno is the error number that indicates the reason for the refusal. reason is an explanation of the error.

Severity

Error

System Action

The program continues, although no licensed components will be permitted to run.

User Action

Investigate the cause of the failure. If necessary, apply a current, updated license to the Controller to resolve the problem.

Component

Universal Broker

----

UNV5342I No license information was received from Universal Controller.

Description

The agent received a response to its HELLO message from a Universal Controller, but no 6.9.0.0 or later information that includes global license parameters was contained in that response. All licensed agent components will continue to use license information contained in local configuration files.

Severity

Informational

System Action

The program continues and uses locally-configured license information.

User Action

Install or upgrade to a 6.9.0.0 or later Universal Controller. Eventually, <->

Universal Agents will be required to obtain their license information from a Controller. Even if the Controller is not used for workload automation, it must still be available to function as a central license manager.

Component

Universal Broker

----

UNV5343I name database file fname failed verification and will be recreated.

Description

During startup, the Universal Broker detected a corruption in the database identified by name, which resides in the file specified by fname. This can happen whenever the previous instance of the Universal Broker was <->

forcefully terminated while a write to the database was still in progress.

Severity

Informational

System Action

Broker database verification continues.

User Action

No action required

Component

Universal Broker

----

UNV5344E Minimum SSL protocol cannot be higher than the maximum.

Description

The user has set the minimum SSL protocol to a value that is higher than the maximum SSL protocol. This is not a valid configuration; the minimum must be lower or equal to the maximum.

Severity

Error

System Action

The program terminates.

User Action

Make sure the minimum SSL protocol is lower or equal to the maximum.

Component

Universal Broker

----

UNV5345D The recreate_databases option has been deprecated and superseded by db_file_generations.

Description

The user has set an option that has been deprecated and superseded by db_file_generations.

Severity

Diagnostic

System Action

The program continues as normal.

User Action

No action required.

Component

Universal Broker

----

UNV5346E Error archiving the database file fname in func (errno): reason

Description

An attempt to create an archive copy of the database file fname failed. func identifies the name of the function in which the error occurred. errno is the error number and reason is an explanation of the error.

Severity

Error

System Action

In order to allow the Broker to continue its startup processing, the database file identified by fname is deleted and automatically recreated. No backup copy will exist, but this error indicates that the database file was likely beyond repair and not a good candidate for a backup.

User Action

No action required.

Component

Universal Broker

----

UNV5347E Error deleting the dbtype file fname in func (errno): reason

Description

When dbtype is "database", an attempt to delete a corrupted copy of the database that resides in fname failed. When dbtype is "archive", an attempt to delete archived copy of a corrupted database failed. func identifies the name of the function in which the error occurred. errno is the error number and reason is an explanation of the error.

Severity

Error

System Action

If 'dbtype' is "database", the Broker will fail. If 'dbtype' is "archive", the Broker will continue its startup processing. If the Broker is configured to archive corrupted databases, the archive may have been created, but the number of database archive files may now exceed the configured limit.
User Action

If 'dbtype' is "database", delete the specified database file and try to start the Broker again. If 'dbtype' is "archive", delete any archive files that exceed the Broker's configured limit or that are no longer needed.

Component

Universal Broker

----

UNV5348E Error creating the database archive directory in dir in func (errorno): reason

Description

An attempt to create an .archive directory that will hold backup copies of corrupted databases failed. dir is the name of the Broker database directory, in which the attempt to create the .archive directory was made. func identifies the name of the function in which the error occurred. errno is the error number and reason is an explanation of the error.

Severity

Error

System Action

The Broker will treat this as a non-fatal error. The corrupted database will be deleted so that Broker startup may continue. No backup copy will exist, but the database validation failure indicates that the database file was likely beyond repair and not a good candidate for a archival.

User Action

No action required.

Component

Universal Broker

----

UNV5349I Archiving the Broker database file dbpath to arcpath.

Description

The Broker databases were not properly closed when the Broker was last stopped, which has triggered database validation. If the Broker is configured to create archive copies of any database file that fails validation (the default) this message is displayed before before the Broker creates the archive. dbpath is the complete path of the database file being archived. arcpath is the complete path of the archived copy of the bad database file.

Severity

Informational

System Action

When the archival processing finishes, the Broker will delete the database file and resume its startup processing.

User Action

No action is required. To disable database archival, set the db_file_generations option in the Universal Broker configuration to 0 (zero).

Component

Universal Broker

Browser not supported