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