Files
org-hyperion-cules/html/hercmsca.html
Stefan e8bdabdce1 Fixed many typos (#744)
Co-authored-by: Stefan A. Haubenthal <polluks@sdf.org>
2025-04-21 11:39:18 -07:00

432 lines
14 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.0//EN" "html.dtd">
<HTML>
<HEAD><TITLE>
Hercules Version 3: System Messages: CA - Communication Adapter</TITLE>
<LINK REL=STYLESHEET TYPE="text/css" HREF="hercules.css">
</HEAD>
<BODY BGCOLOR="#ffffcc" TEXT="#000000" LINK="#0000A0"
VLINK="#008040" ALINK="#000000">
<h1>Hercules Version 3: System Messages: CA - Communication Adapter</h1>
<p>
This page describes the Communication Adapter emulation messages for the Hercules S/370,
ESA/390, and z/Architecture emulator.
<h3>Messages</h3>
<dl class="messages">
<dt>
<code><a name="HHCCA001I">
HHCCA001I <em>CCUU</em>:Connect out to <em>ipaddr:port</em> failed during initial status : <em>System Cause Text</em>
</a></code>
<dd><dl>
<dt>Explanation
<dd>HERCULES attempted to make an outgoing TCP connection to <em>ipaddr:port</em>, but the system indicated that there was an error while processing the request.
<dt>System Action
<dd>The DIAL or ENABLE CCW that caused the connection attempt ends with Unit Check and Intervention Required.
The reason for the failure is indicated in the <em>System Cause Text</em> field
<dt>Operator Action
<dd>None
<dt>Programmer Action
<dd>Correct the RHOST/RPORT configuration statements in the configuration file.
If this message occurred during a program initiated DIAL, correct the dial data.
<dt>Module
<dd>commadpt.c
<dt>Function
<dd>commadpt_connout
</dl>
<p></p>
<dt>
<code><a name="HHCCA002I">
HHCCA002I <em>CCUU</em>:Line Communication thread <em>thread id</em> started
</a></code>
<dd><dl>
<dt>Explanation
<dd>The thread responsible for asynchronous operations for the BSC emulated line <em>CCUU</em> has been started.
<dt>System Action
<dd>The system continues
<dt>Operator Action
<dd>None. This is an informational message
<dt>Programmer Action
<dd>None. This is an informational message
<dt>Module
<dd>commadpt.c
<dt>Function
<dd>commadpt_thread
</dl>
<p></p>
<dt>
<code><a name="HHCCA003E">
HHCCA003E <em>CCUU</em>:Cannot obtain socket for incoming calls : <em>System Cause Text</em>
</a></code>
<dd><dl>
<dt>Explanation
<dd>A system error occurred while attempting to create a socket to listen for incoming calls.
<dt>System Action
<dd>The device creation is aborted.
<dt>Operator Action
<dd>None.
<dt>Programmer Action
<dd>Check the System Cause Text for any information relating to the host system. Notify support.
<dt>Module
<dd>commadpt.c
<dt>Function
<dd>commadpt_thread
</dl>
<p></p>
<dt>
<code><a name="HHCCA004W">
HHCCA004W <em>CCUU</em>:Waiting 5 seconds for port <em>port</em> to become available
</a></code>
<dd><dl>
<dt>Explanation<dd>While attempting to reserve port <em>port</em> to listen to
it, the system indicated the port was already being used.
<dt>System Action<dd>The system waits 5 seconds and then retries the operation
<dt>Operator Action<dd>Terminate the device if the port is in error
<dt>Programmer Action<dd>Determine the program holding the specified port. If
the port cannot be made available, use a different port.
</dl>
<p></p>
<dt>
<code><a name="HHCCA005I">
HHCCA005I <em>CCUU</em>:Listening on port <em>port</em> for incoming TCP connections
</a></code>
<dd><dl>
<dt>Explanation<dd>The system is now listening on port <em>port</em> for incoming
a tcp connection.
<dt>System Action<dd>The system continues
<dt>Operator Action<dd>None. This is an informational message
<dt>Programmer Action<dd> None. This is an informational message
</dl>
<p></p>
<dt>
<code><a name="HHCCA006T">
HHCCA006T <em>CCUU</em>:Select failed : <em>System Cause Text</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>An error occurred during a 'select' system call.
<dt>System Action<dd>The BSC thread is terminated
<dt>Operator Action<dd>None.
<dt>Programmer Action<dd>Check the <em>System Cause Text</em> for any indication
of where the error might come from. Notify Support.
</dl>
<p></p>
<dt>
<code><a name="HHCCA007W">
HHCCA007W <em>CCUU</em>:Outgoing call failed during <em>ENABLE|DIAL</em> command : <em>System Cause Text</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>The system reported that a previously initiated TCP connection
could not be completed
<dt>System Action<dd>The I/O operation responsible for the TCP outgoing connection
is ended with Unit Check and Intervention Required.
<dt>Operator Action<dd>If the error indicates that the error is temporary, retry
the operation.
<dt>Programmer Action<dd>Check that the destination for this line is correctly
configured. If the operation was a DIAL attempt, check in the
application configuration or operation data.
</dl>
<p></p>
<dt>
<code><a name="HHCCA008I">
HHCCA008I <em>CCUU</em>:cthread - Incoming Call
</a></code>
<dd><dl>
<dt>Explanation<dd>The BSC thread has received an incoming call.
<dt>System Action<dd>Depending on configuration and operational status,
the call is either accepted or rejected. Eventually, an
ongoign I/O operation may complete.
<dt>Operator Action<dd>None. This is an informational message
<dt>Programmer Action<dd> None. This is an informational message
</dl>
<p></p>
<dt>
<code><a name="HHCCA009I">
HHCCA009I <em>CCUU</em>:BSC utility thread terminated
</a></code>
<dd><dl>
<dt>Explanation<dd>The BSC thread has ended
<dt>System Action<dd>the system continue.
<dt>Operator Action<dd>Refer to any previous error message
if this message was not unexpected
<dt>Programmer Action<dd> Refer to any previous error message
if this message was not unexpected
</dl>
<p></p>
<dt>
<code><a name="HHCCA010I">
HHCCA010I <em>CCUU</em>:initialisation not performed
</a></code>
<dd><dl>
<dt>Explanation<dd>The Device initialisation process has failed.
<dt>System Action<dd>the system terminates or continues, depending
on the reason for which the device was initialisation was
initiated.
<dt>Operator Action<dd>Refer to any previous error message
<dt>Programmer Action<dd> Refer to any previous error message
</dl>
<p></p>
<dt>
<code><a name="HHCCA011E">
HHCCA011E <em>CCUU</em>:Error parsing <em>Keyword</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>The device keyword parser found an error while
parsing a known keyword.
<dt>System Action<dd>The system continues. The device initialisation
routine turns on a NOGO flag.
<dt>Operator Action<dd>for a runtime initialisation,
correct the device initialisation parameters, otherwise
notify the programmer.
<dt>Programmer Action<dd>For an engine initialisation, correct the device
configuration parameters in the configuration file.
</dl>
<p></p>
<dt>
<code><a name="HHCCA012E">
HHCCA012E <em>CCUU</em>:Unrecognized parameter <em>Keyword</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>The device keyword parser found an unknown
keyword in the device parameter list.
<dt>System Action<dd>The system continues. The device initialisation
routine turns on a NOGO flag.
<dt>Operator Action<dd>for a runtime initialisation,
correct the device initialisation parameters, otherwise
notify the programmer.
<dt>Programmer Action<dd>For an engine initialisation, correct the device
configuration parameters in the configuration file.
</dl>
<p></p>
<dt>
<code><a name="HHCCA013E">
HHCCA013E <em>CCUU</em>:Incorrect <em>local port|remote port|local host|remote host</em> specification <em>value</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>The device initialisation routine could not correctly parse a
parameter value.
<dt>System Action<dd>The system continues. The device initialisation
routine turns on a NOGO flag.
<dt>Operator Action<dd>for a runtime initialisation,
correct the device initialisation parameters, otherwise
notify the programmer.
<dt>Programmer Action<dd>For an engine initialisation, correct the device
configuration parameters in the configuration file.
</dl>
<p></p>
<dt>
<code><a name="HHCCA014E">
HHCCA014E <em>CCUU</em>:Incorrect switched/dial specification <em>value</em>; defaulting to DIAL=OUT
</a></code>
<dd><dl>
<dt>Explanation<dd>The device initialisation routine found an incorrect
DIAL value.
<dt>System Action<dd>The system continues. The device initialisation
routine turns on a NOGO flag.
<dt>Operator Action<dd>for a runtime initialisation,
correct the device initialisation parameters, otherwise
notify the programmer.
<dt>Programmer Action<dd>For an engine initialisation, correct the device
configuration parameters in the configuration file.
</dl>
<p></p>
<dt>
<code><a name="HHCCA015E">
HHCCA015E <em>CCUU</em>:Missing parameter : DIAL=<em>NO|IN|OUT|INOUT</em> and <em>LPORT|RPORT|LHOST|RHOST</em> not specified
</a></code>
<dd><dl>
<dt>Explanation<dd>The device initialisation routine found that a
mandatory parameter was not provided for a specific
DIAL Value.
<dt>System Action<dd>The system continues. The device initialisation
routine turns on a NOGO flag.
<dt>Operator Action<dd>for a runtime initialisation,
correct the device initialisation parameters, otherwise
notify the programmer.
<dt>Programmer Action<dd>For an engine initialisation, correct the device
configuration parameters in the configuration file.
<dt>Note<dd>
For DIAL=NO , LPORT, RPORT and RHOST are needed
<dd>For DIAL=IN , LPORT is required
<dd>For DIAL=OUT None of LPORT,LHOST,RPORT,RHOST are required
<dd>For DIAL=INOUT, LPORT is required
</dl>
<p></p>
<dt>
<code><a name="HHCCA016W">
HHCCA016W <em>CCUU</em>:Conflicting parameter : DIAL=<em>NO|IN|OUT|INOUT</em> and <em>LPORT|RPORT|LHOST|RHOST</em>=<em>value</em> specified
</a></code>
<dd><dl>
<dt>Explanation<dd>The device initialisation routine found that a
parameter was provided for a parameter that is not
relevant for a specific DIAL Value.
<dt>System Action<dd>The parameter is ignored. The system continues
<dt>Operator Action<dd>for a runtime initialisation,
correct the device initialisation parameters, otherwise
notify the programmer.
<dt>Programmer Action<dd>For an engine initialisation, correct the device
configuration parameters in the configuration file.
<dt>Note
<dd>For DIAL=IN , RPORT and RHOST are ignored
<dd>For DIAL=OUT , LPORT, LHOST, RPORT and RHOST are ignored
<dd>For DIAL=INOUT, RPORT and RHOST are ignored
</dl>
<p></p>
<dt>
<code><a name="HHCCA017I">
HHCCA017I <em>CCUU</em>:<em>LPORT|RPORT|LHOST|RHOST</em> parameter ignored
</a></code>
<dd><dl>
<dt>Explanation<dd>The system indicates that the parameter specified
is ignored. This message is preceded by message HHCCA016W
<dt>System Action<dd>The system continues
<dt>Operator Action<dd>None
<dt>Programmer Action<dd>None
</dl>
<p></p>
<dt>
<code><a name="HHCCA018E">
HHCCA018E <em>CCUU</em>:Bind failed : <em>System Cause Text</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>While attempting to bind a socket to a specific
host/port, the host system returned an uncorrectable
error.
<dt>System Action<dd>BSC Thread terminates
<dt>Operator Action<dd>None
<dt>Programmer Action<dd>Check that the LHOST parameter for this device
is indeed a local IP address. Otherwise, notify support.
</dl>
<p></p>
<dt>
<code><a name="HHCCA019E">
HHCCA019E <em>CCUU</em>:BSC comm thread did not initialise
</a></code>
<dd><dl>
<dt>Explanation<dd>The BSC communication thread reported that it terminated
while the device was initialising.
<dt>System Action<dd>The device is not initialised.
<dt>Operator Action<dd>Check for any previously issued error message.
<dt>Programmer Action<dd>Check for any previously issued error message.
</dl>
<p></p>
<dt>
<code><a name="HHCCA020E">
HHCCA020E <em>CCUU</em>:Memory allocation failure for main control block
</a></code>
<dd><dl>
<dt>Explanation<dd>A memory allocation failure occurred while attempting to reserve memory for the Communication Adapter control block
<dt>System Action<dd>The device is not initialised.
<dt>Operator Action<dd>None
<dt>Programmer Action<dd>Contact support
</dl>
<p></p>
<dt>
<code><a name="HHCCA02II">
HHCCA021I <em>CCUU</em>:Initialization failed due to previous errors
</a></code>
<dd><dl>
<dt>Explanation<dd>The initialisation process for device <em>CCUU</em> did not complete successfully
<dt>System Action<dd>The device is not initialised
<dt>Operator Action<dd>None
<dt>Programmer Action<dd>Refer to any previous error message
</dl>
<p></p>
<dt>
<code><a name="HHCCA300D">
HHCCA300D <em>Debug Message</em>
</a></code>
<dd><dl>
<dt>Explanation<dd>This is a debug message. CCW Tracing has been turned on for this device and the Line Handler issues debug messages to help diagnose interface, conformance and protocol issues.
<dt>System Action<dd>The system continues
<dt>Operator Action<dd>If the debug messages are no longer necessary, turn off CCW tracing (panel command : 't-CCUU').
<dt>Programmer Action<dd>None
</dl>
<p></p>
<p><center><hr width=15% noshade></center>
<p>
If you have a question about Hercules, see the
<a href="hercfaq.html">Hercules Frequently-Asked Questions</a> page.
<p><center><hr width=15% noshade>
<a href="hercmsg.html"><img src="images/back.gif" border=0 alt="back"></a>
</center>
<p class="lastupd">Last updated $Date$ $Revision$</p>
</BODY>
</HTML>