UNV5300-UNV5399
----
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