UNV2400-UNV2499
----
UNV2400I Spool extraction completed with exit code exitcode.
Description
Indicates the completion of the Universal Command Server instance that was started as a result of restart request by a Universal Command Manager. The only processing done by the Server was the forwarding of all output (stored in a spool file) from a completed process to the Manager that issued the restart. exitcode is the value with which the Server ended.
Severity
Informational
System Action
None
User Action
None required.
Component
Universal Command
----
UNV2401I Force complete processing completed with exit code exitcode.
Description
Indicates the Universal Command Server instance was force completed as a result of a client request. The exitcode value is the server's exit code and indicates its success. A value of 0 is success, otherwise a failure in processing occurred.
Severity
Informational
System Action
The server terminates.
User Action
None required.
Component
Universal Command
----
UNV2402E Cannot access spool file directory 'dir': reason
Description
The spool file 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 ucmdsrv program has access to this directory.
Component
Universal Command
----
UNV2403A Spool file directory: opt
Description
Displays the location where spool files reside.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2404A Allow spooling: opt
Description
Displays the option that specifies whether or not the Universal Command Server is accepting spooling requests from the Manager.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2405E Failed Creating Database Environment: func, errno, reason
Description
The Universal Command Server database environment could not be created and recovery may need to be run on the database before starting the Universal Command Server. 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
Contact Stonebranch customer support.
Component
Universal Command
----
UNV2407I Connection reestablishment started. Files are being spooled.
Description
Indicates that the Universal Command Server has lost its TCP/IP connections with the manager and has received an incoming request from the broker. It will immediately attempt to reestablish the connection with the manager.
Severity
Informational
System Action
The program continues.
User Action
None required.
Component
Universal Command
----
UNV2409W Unable to remove spool database: dbpath, compid, dbfile.
Description
Indicates that the Universal Command Server was unable to remove a database for this component. dbpath is the database directory. compid is the ID of the component that received the error. dbfile specifies the name of the database file.
Severity
Warning
System Action
The program continues.
User Action
Remove the spool database manually using uslrm utility.
Component
Universal Command
----
UNV2410E Error cleaning up child process resources: func, errno, reason.
Description
An error occurred releasing O/S resources obtained or created for the execution of the user workload in a child process. Depending on the type of error, some resource may not have been released back to the O/S resulting in a resource leak. func is the function that encountered the error. errno is the error number returned by the function. reason is a text description of the error.
Severity
Error
System Action
The program continues.
User Action
If the problem persists, contact Stonebranch customer support.
Component
Universal Command
----
UNV2412I Force complete started per client at ipaddr, port.
Description
Indicates that Universal Command Server successfully started and will force the server into completed state without sending spooled output files. ipaddr is the IP address of the client (i.e., the system on which UCMD Manager resides). port is the client port number assigned to UCMD Manager by TCP/IP.
Severity
Informational
System Action
None
User Action
None required.
Component
Universal Command
----
UNV2413I Force complete started per user userid at ipaddr, port.
Description
Indicates that Universal Command Server successfully started and will force the server into completed state without sending spooled output files. userid is the name of a user account that authorized to obtain the output from the original process. ipaddr is the IP address of the client (i.e., the system on which UCMD Manager resides). port is the client port number assigned to UCMD Manager by TCP/IP.
Severity
Informational
System Action
None
User Action
None required.
Component
Universal Command
----
UNV2414E A manager restart cannot force complete a non-PENDING server.
Description
The manager was executed with the force complete option. The force complete option can be applied to PENDING servers only.
Severity
Error
System Action
The program terminates.
User Action
The server must be terminated first with Universal Control.
Component
Universal Command
----
UNV2415E Error sending job information to the Broker for component compid in func(errno): reason
Description
The UCMD Server was unable to send the information required by the Broker to update the job information it maintains in its database. compid is the ID of the component for which the update was requested. 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 system action depends on the context in which it occurs. Refer to other messages printed at this time.
User Action
Make sure the Broker is running and is able to accept connections over the component interface, specified in the Broker's configuration. If the problem persists, contact Stonebranch customer support.
Component
Universal Command
----
UNV2416E Error retrieving job information from the Broker for component compid in func(errno): reason
Description
The UCMD Server was unable to retrieve the information stored in the database managed by the Broker. compid is the ID of the component for which job information was requested. 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 process terminates.
User Action
Make sure the Broker is running and is able to accept connections over the component interface. When attempting a component restart, make sure a valid component ID was specified. If the problem persists, contact Stonebranch customer support.
Component
Universal Command
----
UNV2417E Failed processing Component Instance: func, errno, reason
Description
The component configuration information provided by Universal Broker and required by UCMD Server to establish its runtime environment could not be processed. 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
Contact Stonebranch customer support.
Component
Universal Command
----
UNV2420W An error occurred closing the stdfile spool file: func, errno, reason
Description
An attempt to close one of the files used by UCMD Server to spool redirected standard i/o failed. stdfile is the name of the of the standard i/o file whose corresponding spool file could not be closed. 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
Warning
System Action
The program continues.
User Action
None required, unless this message precedes other, more serious errors. Appropriate action will then depend on the errors reported. If the problem persists, contact Stonebranch customer support.
Component
Universal Command
----
UNV2421W Error creating trace file: func, errno, reason.
Description
An error occurred creating the trace file. The function that encountered the error was func. The error is identified by the error number, errno, and error reason, reason.
Severity
Warning
System Action
Processing continues with tracing disabled.
User Action
Correct the condition that caused the error and rerun the server.
Component
Universal Command
----
UNV2422I Trace data set is 'dsn, volser'.
Description
Universal Command Server was started with a message level of TRACE, which may result in an application trace being written. The trace data set is dsn on volume volser.
Severity
Informational
System Action
The program continues.
User Action
No action required.
Component
Universal Command
----
UNV2423E Error processing command reference: refname, func, errno, reason
Description
While processing the command reference file an error occurred in function func. The error code returned by func is errno which is described by reason. The command reference being processed at the time is referred to in field refname. It is possible that the name is not available in which case the field contains UNKNOWN.
Severity
Error
System Action
The program terminates.
User Action
Review the error information to determine what caused the condition. Contact Stonebranch Customer Support if assistance is required.
Component
Universal Command
----
UNV2424E Cannot access command reference directory 'dir': reason
Description
The command reference 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 ucmsrv program has access to this directory.
Component
Universal Command
----
UNV2425A Manager server options: value.
Description
The Universal Command Manager provided a server options override value. The override specified Universal Command Server options that were to be overridden. Note that only manager related server options can be specified in this manner. Options that control server operational aspects cannot be overridden. The option value provided by the manager is specified by value.
Severity
Audit
System Action
The program continues.
User Action
No action required.
Component
Universal Command
----
UNV2426I STC jobname, jobid successfully started.
Description
The Universal Command Server, at the request of a Universal Command Manager, has started a started task (STC) with job name jobname and job number jobid.
Severity
Informational
System Action
The program continues.
User Action
No action required.
Component
Universal Command
----
UNV2427A Login environment: opt
Description
Displays the option that specifies whether or not the Universal Command Server establishes a user login environment in which to execute the command.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2428A Maximum trace file lines: lines
Description
Displays the option that specifies the maximum number of lines written to the application trace file.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2429A Data session SSL cipher suites: ciphers
Description
Displays the option that specifies the SSL cipher suites that are acceptable for the data sessions.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2430A Default stdin allocation: alloc
Description
Displays the option that specifies the default standard input data set allocation attributes. A standard input data set is allocation for STC command requests.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2431A Stdin high-level qualifier: hlq
Description
Displays the option that specifies the high-level qualifier of the standard input data set used for STC command requests.
Severity
Audit
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2432W Manager access denied by rule: ipaddr, remoteuser, certid, localuser, reqtype, 'reqname'.
Description
A Universal Command Server access control list rule rule has denied access to a Manager request. The criteria used to find the matching UACL rule was the manager's host, ipaddr, the manager's user ID, remoteuser, the manager's mapped certificate ID, certid, the requested user ID, localuser, the type of request, reqtype, and the request name reqname.
UACL rules are numbered in the order they are listed in the configuration file or the Windows Configuration Manager.
Severity
Warning
System Action
The program stops processing the request and terminates.
User Action
Contact your Universal Command administrator for the Server system to determine if the request is properly denied or not.
Component
Universal Command
----
UNV2433I MVS assembler message TBD.
Description
TBD
Severity
Informational
System Action
None.
User Action
None required.
Component
Universal Command
----
UNV2434I Trace file is 'file'.
Description
Universal Command Server was started with a message level of TRACE, which may result in an application trace being written. The trace file path name is file.
Severity
Informational
System Action
The program continues.
User Action
No action required.
Component
Universal Command
----
UNV2435I DDN=ddname, STEP=step, PROCSTEP=procstep, DSN=dsn
Description
Indicates the start of a JES spool file being returned to a Universal command manager. Field ddname is the ddname that allocated the JES sysout data set. Field step is the JCL step name that defines the ddname. Field procstep is the JCL procedure step that defines the ddname. Field dsn is the JES data set name.
Severity
Informational
System Action
The program continues.
User Action
No action required.
Component
Universal Command
----
UNV2436E Error starting STC. Possible JCL error or START command error.
Description
An error occurred creating the started task (STC) address space. The error is most likely a JCL error or an error in the START command.
Severity
Error
System Action
The program terminates.
User Action
Review the MVS system log for START command errors. MVS will issues messages describing the cause of the error.
Component
Universal Command
----
UNV2437W Manager termination request received.
Description
The Universal Command Manager sent a termination message to the server. The termination message indicates that the manager has prematurely shutdown.
Severity
Warning
System Action
Universal Command Server processing continues depending on whether it is running in Manager Fault Tolerant (MFT) mode or not. In MFT mode the server's communication state is changed to ORPHANED and continues processing. In non-MFT mode, the server will cancel the user process and terminate.
User Action
No action is required for the server. Action may be required to correct the condition that caused the manager to terminate.
Component
Universal Command
----
UNV2438W Starting process termination for unresponsive process pid.
Description
The Universal Command Server attempted to cancel process pid, but it has not ended. A forced termination of the process will be attempted. Forced terminations do not permit the process to release acquired resources or complete pending operations, so there is a risk to data or application integrity.
Severity
Warning
System Action
Universal Command Server attempts to terminate the process.
User Action
Determine why the process is not responding to a controlled cancel. After the application is terminated, check that application resources are in good condition.
Component
Universal Command
----
UNV2439W Server STOP command received.
Description
The Universal Command Server received a STOP command from the Universal Broker. STOP commands directs the server to terminate the user process and shutdown. STOP commands come from one of the following sources:
- Universal Broker
- Universal Control
- Universal Enterprise Controller
Severity
Warning
System Action
Universal Command Server terminates the user process and shuts down.
User Action
No action is required.
Component
Universal Command
----
UNV2440E Possible JCL error in STC. No user steps executed.
Description
The STC successfully started, but the only step executed was the UCMSS000 program. Either the STC only had this step defined or all user steps were flushed possibly due to JCL errors.
Severity
Error
System Action
The program terminates.
User Action
Review the STC job log for a possible JCL error.
Component
Universal Command
----
UNV2441E Universal Products environment for started task support has not been defined.
Description
The required environment for Universal Products to support started task (STC) requests has not been defined. STC support requires that Universal Broker configuration parameters specify that the Broker is to establish the necessary environment to support the execution of started tasks via Universal Command. Refer to Universal Broker installation documentation for more details.
Severity
Error
System Action
The program terminates.
User Action
Contact the Universal Products administrator to have the STC environment defined.
Component
Universal Command
----
UNV2442E STC was terminated due to a JCL error in one of its steps.
Description
The STC successfully started, but one of its steps received a JCL error. A JCL error is considered a fatal error. As there is no step completion code for a JCL error, the resulting exit code is a SIGABND signal.
Severity
Error
System Action
The program terminates.
User Action
Review the STC job log to identify the reason for the JCL error. Correct the condition that caused the JCL error and rerun the STC.
Component
Universal Command
----
UNV2443E Error establishing local broker session: func, errno, reason
Description
An error occurred establishing a communication session with the local broker. The function that failed is identified by field 'func'. Field p>errno is the error number, and field reason is an explanation of the error.
Severity
Error
System Action
The program terminates.
User Action
If the reason indicates the connection was refused, then the local Broker is not running. Start the local Broker and rerun the command. Contact Stonebranch customer support for assistance.
Component
Universal Command
----
UNV2444W Error generating event message type type: func, errno), reason
Description
UCMD Manager or Server was unable to successfully generate an event message of type type. 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
Warning
System Action
The program continues processing. The event message is lost and will not be recovered.
User Action
Make sure the Broker is running and is able to accept connections over the component interface, specified in the Broker's configuration. If the problem persists, contact Stonebranch customer support.
Component
Universal Command
----
UNV2445E Error initializing for event generation: func, errno, reason.
Description
An error occurred initializing for event generation. The function that encountered the error is func. The error number returned is errno. An explanation of the error is reason.
Severity
Error
System Action
The program continues.
User Action
Determine the cause of the error based upon this message and any messages issued prior to this one. If you need assistance, contact Stonebranch Customer Support.
Component
Universal Command
----
UNV2446E Error initializing job object: func, errno, reason.
Description
Because Windows does not maintain a parent/child relationship among its processes, UCMD Server attaches its child processes to a single entity known as a job object. One feature of a job object is that it causes all child processes to terminate whenever UCMD Server is terminated. This enables Unix-like behavior (which maintains parent/child relationships), where killing a parent process results in the termination of all its children.
This error message indicates that UCMD Server was unable to create the job object used to group and manage child processes. 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 requested user process is not started, and UCMD Server terminates.
User Action
Examine the error message to see if the problem might be environmental, rather than application specific. Contact Stonebranch customer support if necessary.
Component
Universal Command
----
UNV2447E Failed setting Job Log Output to value. Function: func, Component: comp
Description
func function in component component failed to set the Job Log Output, LOGOUTPUT, value to value. Check for previously issued messages in this job log. Correct any errors and try the command again.
Severity
Error
System Action
The program terminates.
User Action
Correct previously listed errors and retry the command.
Component
Universal Command
----
UNV2448E Attempt to create unencrypted data session denied: ipaddr, port, userid, workid
Description
The UCMD server is configured to require ssl for data sessions. An attempt to establish a data session without ssl encryption (and with UNVv2 legacy protocol) was attempted and denied by the UCMD server. The attempt was from a UCMD manager at IP address ipaddr and TCP port number port. The UCMD manager was executing with a user identifier of userid and work identifier of workid.
Severity
Error
System Action
The UCMD server rejects the work request form the manager and terminates the session.
User Action
Refer to the UBroker REQUIRE_SSL configuration option to specify if an ssl data session is required or UNVv2 legacy protocol is allowed.
Component
Universal Command
----
UNV2449E UCMD Server license validation failed: reason
Description
UCMD Server is not authorized to execute due to unavailable or invalid license information. reason explains the validation error.
Severity
Error
System Action
The program terminates.
User Action
Starting with UA 6.9.0.0, UCMD Server execution will be controlled by any 6.9.0 license or later license information a Universal Agent receives from Universal Controller. If the Agent was unable to obtain a license from a Universal Controller (or is waiting for acquire one), this message will be issued. If the Agent is not configured to connect to a Universal Controller, pre-6.9.0.0 licensing schemes are used.
- If the error reason indicates that no license was granted, update the number of distributed (or zOS) agents included in your Controller license. - If the error reason indicates that the license is not available, check your UAG Server connection configuration to make sure it is correct and pointing to an active OMS server.
Component
Universal Command