UNV1900-UNV1999
----
UNV1900E The 'stop', 'start', or 'refresh' argument is required.
Description
The -stop, -start, or -refresh parameter was not supplied to Universal Control Manager.
Severity
Error
System Action
The program terminates.
User Action
Add the -stop parameter to specify the component ID to stop on a remote system, the -start parameter to specify the name of a component to start on a remote system, or the -refresh parameter to force a Universal Broker to parse it's config file.
Component
Universal Control
----
UNV1901E The 'stop', 'start', and 'refresh' options are mutually exclusive.
Description
An attempt was made to start a Universal Control Manager using more than one of the following command line options: 'stop', 'start', or 'refresh'.
Severity
Error
System Action
The program terminates.
User Action
Restart the Universal Control Manager, making sure that only one of the following options are specified: 'stop', 'start', or 'refresh'.
Component
Universal Control
----
UNV1902E The Universal Control Server does not support the requested reqtype operation.
Description
The version of the Universal Control Server installed on the target system does not support the operation requested by the Universal Control Manager. reqtype is the type of request not supported <->
by the Server.
Severity
Error
System Action
The program terminates. The control session between the UCtl Manager and UCtl Server will be forcefully closed when the Manager ends. This will result in a termination error in the Server.
User Action
Upgrade the Universal Control Server on the target system to a version that supports the requested operation. See the Universal Command Consolidated Documentation manual for information on the features supported by Universal Control.
Component
Universal Control
----
UNV1903E Missing 'host' argument.
Description
The IP address or host name of the remote system was not supplied as a parameter to the Universal Control Manager command, and no default value is available in the UCTL Manager configuration file.
Severity
Error
System Action
The program terminates.
User Action
Add the -host parameter to the UCTL Manager command. To set a default IP address, update the 'host' value in the UCTL Manager configuration file.
Windows users: Use Universal Configuration Manager, accessible via the Control Panel, to set a default value.
Component
Universal Control
----
UNV1904E Unable to connect to ubroker at ipaddr, port: reason
Description
Universal Control Manager was unable to establish a connection to Universal Broker, which is needed to request the start of the Universal Control component. ipaddr is the IP address of the system on which UCTL Manager expects Universal Broker to be running. port is the port number that UCTL Manager expects Universal Broker to be using to accept incoming connections. reason is an explanation of the error.
Severity
Error
System Action
The program terminates.
User Action
Make sure Universal Broker is running on the target system, and a network connection is available between the client and server machines. Make sure the 'host' value in UCTL Manager's configuration file is set to the IP address or host name of the system where Universal Broker is running. Also, make sure the 'port' value in UCTL Manager's configuration is set to the port number that is being used by Universal Broker to accept new connections (verify this against the service_port value in Universal Broker's configuration file). If the problem persists, contact Stonebranch customer support.
Windows users: Configuration values for all Universal products can be checked using Universal Configuration Manger, which is accessible from the Control Panel.
Component
Universal Control
----
UNV1905E Error starting UCTL: func, errno, reason
Description
Universal Control Manager was unable to send a request to Universal Broker to start the UCTL component. 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
Make sure Universal Broker is running on the target system, and a network connection is available between the client and server machines. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1906E Error receiving READY message: func, errno, reason
Description
Universal Control Manager was unable to receive a message from Universal Control Server indicating the server's readiness to accept control request information. 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
Make sure a network connection is still available between the client and server machines. Check the Universal Broker message log for any errors reported by Universal Control Server. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1908E Error sending req message: func, errno, reason
Description
Universal Control Manager was unable to send a message to Universal Control Server containing the component command. req is the command the Manager tried to send. 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
Make sure a network connection is still available between the client and server machines. Check the Universal Broker message log for any errors reported by Universal Control Server. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1911E Error receiving STARTED message: func, errno, reason
Description
Universal Control Manager was unable to receive a message from Universal Control Server indicating the start of the request. 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
Make sure a network connection is still available between the client and server machines. Check the Universal Broker message log for any errors reported by Universal Control Server. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1912E Error receiving ENDED message: func, errno, reason
Description
Universal Control Manager was unable to receive a message from Universal Control Server indicating the completion of the request. 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
Make sure a network connection is still available between the client and server machines. Check the Universal Broker message log for any errors reported by Universal Control Server. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1913E Cannot access installation directory 'dir': reason
Description
The installation directory identified by dir could not be accessed. reason is an explanation of the error.
Severity
Error
System Action
The program terminates.
User Action
Check the value of the installation_directory entry in the UCTL Manager configuration file. Make sure the directory exists and the user account running the uctsrv program has sufficient access to that directory. Re-install UCTL Manager if necessary.
Component
Universal Control
----
UNV1914E Cannot access nls directory 'dir': reason
Description
The nls directory, whose entire path is specified by dir, could not be accessed. 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 uctl program has access to this directory.
Component
Universal Control
----
UNV1915E Error starting remote command: reason
Description
Universal Control Server rejected the control request sent by the Universal Control Manager. reason is an explanation of the error.
Severity
Error
System Action
The program terminates.
User Action
Make sure the correct file name and path information for the process was specified. Consult the documentation for the remote process to identify and resolve the problem.
Component
Universal Control
----
UNV1916E Universal Control is ending unsuccessfully with exit code exitcode.
Description
An error occurred within Universal Control Manager. exitcode is the value returned by UCTL Manager.
Severity
Error
System Action
The program terminates.
User Action
Look for other messages issued by Universal Control Manager. Check the Universal Broker message log for any I/O redirection errors reported by Universal Control Server. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1917E Error negotiating session with Uctl server: reason
Description
An attempt to determine compatible configuration options with Universal Control Server failed. reason is an explanation of the error.
Severity
Error
System Action
The program terminates.
User Action
Make sure a network connection is still available between the client and server machines. Also, check the value of the start_command entry in the UCTL component definition file. If this is not correct (and UCTL Server could not be started), UCTL Manager may time out waiting for the negotiation to start. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1918I Universal Control client shutdown initiated due to user interrupt.
Description
Universal Control Manager is terminating due to a cancel request issued by a user.
Severity
Informational
System Action
The program terminates.
User Action
None required.
Component
Universal Control
----
UNV1919E Error processing user identification request: func, errno, reason
Description
Universal Control Manager was unable to provide Universal Control Server with the user ID and/or password values stored in its configuration file or specified as a command parameter. 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
Make sure a network connection exists between the client and server machines. If the problem persists, contact Stonebranch customer support.
Component
Universal Control
----
UNV1920E The server requires a User ID.
Description
A user ID is required by Universal Control Server to stop the requested component, but none was supplied Universal Control Manager.
Severity
Error
System Action
The program terminates.
User Action
Add the -userid parameter to the list of parameters used for the Universal Control command (see the Universal Control User's Guide for more information). To set up a default user ID, update the userid value in Universal Control Manager's configuration file.
Component
Universal Control
----
UNV1921E Cannot access code page file 'file': reason
Description
The text translation file specified by file cannot be read. reason is an explanation of the error.
Severity
Error
System Action
The program terminates.
User Action
Make sure the specified file exists in the Universal Control Manager's 'nls' directory. If it does not exist, re-install Universal Control Manager.
Component
Universal Control
----
UNV1922I Connecting to broker at ipaddr, port.
Description
Indicates that Universal Control Manager is trying to connect to Universal Broker at internet address ipaddr on port port.
Severity
Informational
System Action
The program continues.
User Action
None required.
Component
Universal Control
----
UNV1923I reqtype started at remote time starttime.
Description
Indicates that the requested operation has started on the remote system. reqtype is the type of component request issued, either STOP or START. starttime is the time the stop request was sent, expressed in terms of the remote system's local time.
Severity
Informational
System Action
The program continues.
User Action
None required.
Component
Universal Control
----
UNV1924W Component compName cannot be started with Universal Control.
Description
An attempt to start the component identified by compName has failed because it can only be started as the Server component (e.g., Universal Command Server) for a Manager application (e.g., Universal Command Manager).
Severity
Warning
System Action
The program continues.
User Action
Set up the request to run as one of the available Universal Product Manager applications. If you are trying to start a component that does not require a Manager (e.g., an event-driven Universal Event Monitor Server) and the request is still failing, contact Stonebranch customer support.
Component
Universal Control
----
UNV1925I Stop request ended abnormally with exit code exitcode (hex) at remote time endtime.
Description
Indicates that the stop request did not complete, and did not end cleanly. exitcode is the value returned by the ubroker. hex is a hexadecimal representation of the exit code. endtime is the time the request ended, expressed in terms of the remote system's local time.
Severity
Informational
System Action
The program continues.
User Action
None required on behalf of Universal Control.
Component
Universal Control
----
UNV1926W An instance of the component compName is already running.
Description
An attempt to start the component identified by compName has failed because an instance of that component is already running. Because there is no Manager-Server relationship for Server components started with Universal Control, work is typically allocated to those components via an outside source. As such, only a single instance of a specific component may receive work assigned to it. To run multiple instances of the same type of Server component (e.g., an event-driven Universal Event Monitor Server), each instance must be defined with separate component definitions, and each must have a unique component name.
Severity
Warning
System Action
The program continues.
User Action
Use Universal Query to check the status of components on the target system. Execute Universal Control, passing it the ID of the active component instance to stop the component. Re-start the component by re-issuing the Universal Control command with the -start option.
Component
Universal Control
----
UNV1927W Component compId is not found.
Description
Indicates that the component compId specified in the request was not found running on the remote system.
Severity
Warning
System Action
The program continues.
User Action
Use uquery to check the status of components on the remote system and verify that the correct host and component ID were specified.
Component
Universal Control
----
UNV1928I Universal Control is ending successfully with exit code exitcode.
Description
Universal Control Manager successfully executed the command request. In the case of the STOP command, this message does not reflect the result of the stop request, only that it was successfully executed.
Severity
Informational
System Action
The program continues.
User Action
No action required.
Component
Universal Control
----
UNV1929I The maximum number of components are running on the Broker. Retry in num seconds.
Description
The Universal Control component cannot be started because the number of components currently being managed by Universal Broker has reached the maximum allowed. An attempt to start the component will be made every num seconds.
Severity
Informational
System Action
The program continues, attempting to start the component every num seconds.
User Action
Allow the program to run, waiting for another component to finish so the one waiting can start. Or, cancel UCTL Manager and try again later. If necessary, increase the running_max value in the Universal Broker configuration file.
Windows users: This value can be changed using Universal Configuration Manager, which is accessible via the Control Panel.
Component
Universal Control
----
UNV1930W Component compName is not defined.
Description
An attempt to start the component identified by compName has failed because no definition for that component was found.
Severity
Warning
System Action
The program continues.
User Action
Make sure the component name specified matches the name of an installed component definition and try the command again.
Component
Universal Control
----
UNV1931E Security entity name 'entity' exceeds maximum length of maxlen.
Description
The security entity used to check whether a user account is authorized to run commands on the target system is too long. entity is the security entity name. maxlen is the maximum allowable length.
Severity
Error
System Action
The program terminates.
User Action
Contact Stonebranch customer support.
Component
Universal Control
----
UNV1932E Error checking authorization: func, errno, reason
Description