ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzain_5.4.0.1/rzaintrouble.htm

82 lines
5.2 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 lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<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))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="SSL troubleshooting" />
<meta name="abstract" content="This very basic troubleshooting information is intended to help you thin out the list of possible problems that the iSeries server can encounter with SSL." />
<meta name="description" content="This very basic troubleshooting information is intended to help you thin out the list of possible problems that the iSeries server can encounter with SSL." />
<meta name="DC.Relation" scheme="URI" content="rzainoverview.htm" />
<meta name="DC.Relation" scheme="URI" content="rzainplanssl.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzahg/rzahgictroub2.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzab6/ssltrouble.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2002, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="trouble" />
<meta name="DC.Language" 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. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>SSL troubleshooting</title>
</head>
<body id="trouble"><a name="trouble"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SSL troubleshooting</h1>
<div><p>This very basic troubleshooting information is intended to help
you thin out the list of possible problems that the iSeries™ server can encounter with SSL.</p>
<p>It is important to understand that this is not a comprehensive source for
troubleshooting information, but rather a guide to aid in common problem resolution.</p>
<div class="p">Verify that the following statements are true: <ul><li>You have met the prerequisites for SSL on the iSeries server.</li>
<li>Your certificate authority and certificates are valid and have not expired.</li>
</ul>
</div>
<div class="p">If you have verified that the previous statements are true for your system
and you still have an SSL-related problem, try the following options: <ul><li>The SSL error code in the server job log can be cross referenced in an
error table to find more information about the error. For example, this table
maps the <samp class="codeph">-93</samp> that might be seen in a server job log to the
constant <samp class="codeph">SSL_ERROR_SSL_NOT_AVAILABLE</samp>. <ul><li>A negative return code (indicated by the dash before the code number)
indicates that you are using an SSL_ API.</li>
<li>A positive return code indicates that you are using a GSKit API. Programmers
can code the <samp class="codeph">gsk_strerror()or SSL_Strerror()</samp> API in their
programs to obtain a brief description of an error return code. Some applications
make use of this API and print out a message to the job log containing this
sentence.</li>
</ul>
If more detailed information is required, the message id provided in
the table can be displayed on an iSeries server to show potential cause
and recovery for this error. Additional documentation explaining these error
codes may be located in the individual secure socket API that has returned
the error. </li>
<li>The following two header files contain the same constant names for System
SSL return codes as the table, but without the message ID cross reference: <ul><li><samp class="codeph">QSYSINC/H.GSKSSL</samp></li>
<li><samp class="codeph">QSYSINC/H.QSOSSL</samp></li>
</ul>
Remember that although the names of the System SSL return codes remain
constant in these two files, more than one unique error can be associated
with each return code.</li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzainoverview.htm" title="This topic describes how to use SSL on your server.">Secure Sockets Layer (SSL)</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzainplanssl.htm" title="This topic describes the prerequisites of SSL enablement on the iSeries server, as well as some helpful tips.">Plan to enable SSL</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../rzahg/rzahgictroub2.htm">Service and support</a></div>
<div><a href="../rzab6/ssltrouble.htm">Secure socket API error code messages</a></div>
</div>
</div>
</body>
</html>