ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzau3_5.4.0.1/rzau3msgs.htm

105 lines
6.1 KiB
HTML

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<meta name="dc.date" scheme="iso8601" content="2005-10-17" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<title>OptiConnect error messages</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="msgs"></a>
<h2 id="msgs">OptiConnect error messages</h2>
<p>OptiConnect provides messages that are kept in the QCPFMSG message file
in QSYS library. You can display and print these messages by using the Work
with Message File (WRKMSGF) command as follows: </p>
<pre class="xmp">WRKMSGF MSGF(QCPFMSG)</pre><p class="indatacontent"> Or, you can use:</p>
<pre class="xmp">WRKMSGD CPDADA1</pre>
<p>Detailed information can be displayed by selecting option 5 (Display details).
You can also print from this display by using option 6 (Print).</p>
<p>When you are using OptiConnect, you may also see system messages that can
be displayed as described above. These messages are also in the QCPFMSG message
file in the QSYS library.</p>
<p>The list below describes the major/minor codes for message CPDADA0. There
are two pieces of information in the MSGCPDADA0 secondary text. The first
is the 'yyxx'X data. This information includes an error code followed by a
function code. The second, which the message identifies as a major/minor return
code, is a code point that identifies (to the OptiConnect developer) where
the operation failed.</p>
<p>The MSGCPDADA0 msg 'yyxx'X data in the second level text can be interpreted
as follows:</p>
<ul>
<li>yy = Error Code (what failure was detected)</li>
<li>xx = Function Code (what function was being run)</li></ul>
<p>Error Codes:</p>
<ul>
<li>01xx - Coupling Environment not open (for example, QSOC SBS and SOCMGR
not up).</li>
<li>02xx - System name not found (results in CPF9162 - cannot establish DDM
connection with remote system).</li>
<li>03xx - Source/Agent connection id invalid (for example, source or target
job ended the OptiConnect conversation without a clean disconnect).</li>
<li>0403 - Source/target conversation startup error. This is typically due
to timeout, but can happen due to other errors during startup.</li>
<li>05xx - Bad conversation state. Received the wrong message type when waiting
for a request, response, or control message (for example, waiting for a request
and received a control message or any other combination of request/response/control).
Typically this happens when a "Close-Path" (conversation) is received due
to unexpected error on the other job (look at target joblog if 05xx on source
and vice versa).</li>
<li>06xx - Communication error - error from IPCF/transport layer. In a dual
bus setup this typically means the operation could not be done on either adapter.
Most operations will be automatically retried on the alternate connection
if available. Errors returned from HMC I/O typically cause this error.</li>
<li>07xx - Transaction ended, this error is almost always 070B: Terminate
waiting for response. Indicates an inflight request was ended without any
response. This typically means the associated target (or source) job failed
and ended OptiConnect conversation without sending a response. However, this
can also occur if communication between source and target systems was lost
while a request was outstanding. The 06xx error occurs only if the communication
is lost during request/response transport, while 07xx results because of failure
during wait for response.</li>
<li>90xx - Internal Error. An unexpected or unhandled condition was detected
by the OptiConnect device driver. A VLIC log with major or minor of 0700/0DDD
is logged when this occurs. This may indicate a code problem or incorrect
data (900B has been due to bad data in messages that are sent over the bus).
<a name="wq61"></a>
<div class="notetitle" id="wq61">Note:</div>
<div class="notebody">There are also some known cases in the device driver where this
error is due to loss of communication during certain states. That is, errors
which should probably be 06xx sometimes show up as 90xx. A 90xx error, which
happens at the same time as a SOC<span class="italic">nnnnnn</span> OptiConnect
connection closed message, is probably one which should have been 06xx.</div></li></ul>
<p>Function Codes which may appear in MSGCPDADA0:</p>
<ul>
<li>yy01 - Open-stream (connects job with OptiConnect device driver, should
only fail if Coupling Environment not open = 0101)</li>
<li>yy03 - Open-conversation (namely, Open-path; connects source and agent
job through SOCMGR on the target system)</li>
<li>yy05 - Close-conversation (namely, Close-path; disconnects source and
agent job)</li>
<li>yy07 - Send-request (send a request message; requests may be originated
by either source or agent job)</li>
<li>yy08 - Receive-request (receive a request message)</li>
<li>yy0A - Send-response (send a response message; associated with a previous
request message)</li>
<li>yy0B - Receive-response</li></ul>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>