ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/unix9b.htm

85 lines
4.7 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>i5/OS Secure Sockets Layer (SSL_) APIs</title>
<!-- 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. -->
<!-- Begin Header Records ========================================= -->
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
<!-- File restructured December 2001 -->
<!-- 031112 JETAYLOR replaced API and/or Exit listings with -->
<!-- pagegenerator output from javascript array -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>i5/OS Secure Sockets Layer (SSL_) APIs</h2>
<p>i5/OS<SUP>(TM)</SUP> SSL_ APIs, when used in addition to the existing i5/OS Sockets APIs,
provide the functions required for applications to establish secure
communications. An application using SSL for secure communications is basically
a client/server application written using sockets.</p>
<p>The SSL_ APIs are:</p>
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
<!-- Updates made in this section *will* be overlaid by pagegen tool. -->
<!-- Notify Beth Taylor of needed updates to be made in javascript array.-->
<!--***************API BEGIN PASTE***************-->
<ul>
<li><A HREF="sslinitu.htm">QlgSSL_Init()</A> (Initialize the current job for SSL (using NLS-enabled path name)) is used to establish the SSL security information to be used for all SSL sessions for the current job.</li>
<li><A HREF="sslcreat.htm">SSL_Create()</A> (Enable SSL support for the specified socket descriptor) is used by a program to enable SSL support for the specified socket descriptor.</li>
<li><A HREF="ssldest.htm">SSL_Destroy()</A> (End SSL support for the specified SSL session) is used by a program to end SSL support for the specified SSL session.</li>
<li><A HREF="sslhands.htm">SSL_Handshake()</A> (Initiate the SSL handshake protocol) is used by a program to initiate the SSL handshake protocol. Both the client and the server program must call the SSL_Handshake verb in order to initiate the handshake processing.</li>
<li><A HREF="sslinit.htm">SSL_Init()</A> (Initialize the current job for SSL) is used to establish the SSL security information to be used for all SSL sessions for the current job.</li>
<li><A HREF="sslinita.htm">SSL_Init_Application()</A> (Establish the SSL security information) is used to establish the SSL security information to be used for all SSL sessions for the current job based on the specified application identifier.</li>
<li><A HREF="sslperr.htm">SSL_Perror()</A> (Print SSL error message) prints an error message to stderr.</li>
<li><A HREF="sslread.htm">SSL_Read()</A> (Receive data from an SSL-enabled socket descriptor) is used by a program to receive data from an SSL-enabled socket descriptor.</li>
<li><A HREF="sslstrer.htm">SSL_Strerror()</A> (Retrieve SSL runtime error message) is used to retrieve an error message and associated text string which describes an SSL return value.</li>
<li><A HREF="sslwrite.htm">SSL_Write()</A> (Write data to an SSL-enabled socket descriptor) is used by a program to write data to an SSL-enabled socket descriptor.</li>
</ul>
<!--***************API END PASTE***************-->
<p><strong>Note:</strong> These functions use header (include) files from the
library QSYSINC, which is optionally installable. Make sure QSYSINC is
installed on your system before using any of the functions. See <a href=
"unix13.htm">Header Files for UNIX-Type Functions</a> for the file and member
name of each header file.</p>
<p>See the following examples for more information:</p>
<ul>
<li><a href="../rzab6/x1sslserver.htm">Example: Establish secure
server with SSL APIs</a></li>
<li><a href="../rzab6/x1sslclient.htm">Example: Establish secure
client with SSL APIs</a>
</ul>
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center">
<a href="#Top_Of_Page">Top</a> |
<a href="unix.htm">UNIX-Type APIs</a> |
<a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</body>
</html>