This file is indexed.

/usr/share/hercules/hercmsca.html is in hercules 3.12-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
<!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 occured 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 occured 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 occured 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 preceeded 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 occured 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>:Initialisation failed due to previous errors
</a></code>
<dd><dl>

    <dt>Explanation<dd>The initialisation process for device <em>CCUU</em> did not complete succesfully

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