149 lines
11 KiB
HTML
149 lines
11 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="reference" />
|
||
|
|
<meta name="DC.Title" content="iSeries Access for Windows Communications and Security APIs" />
|
||
|
|
<meta name="abstract" content="The iSeries Access for Windows Communications and Security topic shows you how to use iSeries Access for Windows application programming interfaces (APIs)" />
|
||
|
|
<meta name="description" content="The iSeries Access for Windows Communications and Security topic shows you how to use iSeries Access for Windows application programming interfaces (APIs)" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikapiinterfaces.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiksyapisysobjattr.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcommapilist1.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcommapilist2.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcommapilist3.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcommapilist4.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcwbcoservicedefines.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikdifferences.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiksimilarities.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiksyslistcommapis1.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiksyslistcommapis2.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiksyslistcommapis3.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiksyslistcommapis4.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcommapiex.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikrccommapis.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikrcsecapis.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikglobalrc.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikas400sysnameformat.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcaexpressprogstd.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="appncm" />
|
||
|
|
<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>iSeries Access
|
||
|
|
for Windows Communications
|
||
|
|
and Security APIs</title>
|
||
|
|
</head>
|
||
|
|
<body id="appncm"><a name="appncm"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">iSeries Access
|
||
|
|
for Windows Communications
|
||
|
|
and Security APIs</h1>
|
||
|
|
<div><p>The iSeries™ Access
|
||
|
|
for Windows<sup>®</sup> Communications
|
||
|
|
and Security topic shows you how to use iSeries Access for Windows application
|
||
|
|
programming interfaces (APIs)</p>
|
||
|
|
<div class="section"><p>You can use these APIs to: </p>
|
||
|
|
<ul><li>Get, use, and delete an iSeries <strong>system object</strong>. Various iSeries Access
|
||
|
|
for Windows APIs
|
||
|
|
require a system object. It holds information about connecting to, and validating
|
||
|
|
security (user ID, password, and signon date and time) on, an iSeries system. </li>
|
||
|
|
<li>Obtain information about environments and connections that are configured
|
||
|
|
in the <strong>system list</strong> when you use iSeries Access for Windows.
|
||
|
|
The system list is a list of all currently configured environments, and of
|
||
|
|
systems within those environments. The system list is stored and managed "per
|
||
|
|
user," and is not available to other users. <div class="note"><span class="notetitle">Note:</span> It is not necessary for
|
||
|
|
you to explicitly configure new systems to add them to the system list. They
|
||
|
|
are added automatically when you connect to a new system.</div>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">iSeries Access
|
||
|
|
for Windows Communications
|
||
|
|
and Security APIs required files:</h4>
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" id="d0e83">Header file</th>
|
||
|
|
<th valign="top" width="18.947368421052634%" id="d0e85">Import library</th>
|
||
|
|
<th valign="top" width="19.473684210526315%" id="d0e87">Dynamic Link Library</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="33.1578947368421%" headers="d0e83 "><strong>System object APIs</strong></td>
|
||
|
|
<td valign="top" width="28.421052631578945%" headers="d0e83 "><strong>System list APIs</strong></td>
|
||
|
|
<td rowspan="2" valign="top" width="18.947368421052634%" headers="d0e85 ">cwbapi.lib</td>
|
||
|
|
<td rowspan="2" valign="top" width="19.473684210526315%" headers="d0e87 ">cwbco.dll</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.1578947368421%" headers="d0e83 ">cwbcosys.h</td>
|
||
|
|
<td valign="top" width="28.421052631578945%" headers="d0e83 ">cwbco.h</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Programmer's Toolkit:</h4><p>The Programmer's Toolkit provides
|
||
|
|
Communications and Security documentation, access to the cwbco.h and cwbcosys.h
|
||
|
|
header files, and links to sample programs. To access this information, open
|
||
|
|
the Programmer's Toolkit and select <span class="menucascade"><span class="uicontrol">Communications
|
||
|
|
and Security</span> > <span class="uicontrol">C/C++ APIs</span></span>.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">iSeries Access
|
||
|
|
for Windows Communications
|
||
|
|
and Security topics:</h4><div class="note"><span class="notetitle">Note:</span> By using the code examples, you agree to
|
||
|
|
the terms of the <a href="codedisclaimer.htm">Code license and disclaimer information</a>.</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiksyapisysobjattr.htm">System object attributes</a></strong><br />
|
||
|
|
<strong>System object attributes</strong> affect the behavior of signing
|
||
|
|
on and communicating with the iSeries system that the system object
|
||
|
|
represents.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikcommapilist1.htm">Communications and security: Create and delete APIs</a></strong><br />
|
||
|
|
These APIs are used for creating and deleting a system object</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikcommapilist2.htm">Communications and security: Connect and disconnect APIs</a></strong><br />
|
||
|
|
These APIs allow you to connect to and disconnect from the iSeries system,
|
||
|
|
and for related behavior</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikcommapilist3.htm">Communication and security: Security validation and data APIs</a></strong><br />
|
||
|
|
These APIs provide security validation and data.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikcommapilist4.htm">Communications and security: Get and set attribute APIs</a></strong><br />
|
||
|
|
Use the APIs to get and set other system object attributes, or determine if the attributes are restricted by policies.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikcwbcoservicedefines.htm">Defines for cwbCO_Service</a></strong><br />
|
||
|
|
The following values define <span class="apiname">cwbCO_Service</span>.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikdifferences.htm">Differences between cwbCO_Signon and cwbCO_VerifyUserIDPassword</a></strong><br />
|
||
|
|
Following are listed some of the significant differences between <span class="apiname">cwbCO_Signon</span> and <span class="apiname">cwbCO_VerifyUserIDPassword</span>.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiksimilarities.htm">Similarities between cwbCO_Signon and cwbCO_VerifyUserIDPassword</a></strong><br />
|
||
|
|
The following information illustrates the similarities between <span class="apiname">cwbCO_Signon</span> and <span class="apiname">cwbCO_VerifyUserIDPassword</span></li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiksyslistcommapis1.htm">Communications: Create and delete APIs</a></strong><br />
|
||
|
|
Use these APIs to create a list of configured systems, either in the currently active environment or in a different environment. Retrieve the number of entries in the list, and each entry in succession.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiksyslistcommapis2.htm">Communications: System information APIs</a></strong><br />
|
||
|
|
Use these APIs to obtain information about individual systems that are configured or connected in the current process. Unless the environment name is passed as a parameter, these APIs work only with the currently active environment.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiksyslistcommapis3.htm">Communications: Configured environments information</a></strong><br />
|
||
|
|
Use these APIs to obtain the names of environments that have been configured.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiksyslistcommapis4.htm">Communications: Environment and connection information</a></strong><br />
|
||
|
|
Use these APIs to determine if the calling application can modify environments and connection information.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaikcommapiex.htm">Example: Using iSeries Access for Windows communications APIs</a></strong><br />
|
||
|
|
The example program below shows the use of communications APIs to retrieve and display the names of the default (managing) system, along with all the systems that are configured in the active environment.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikapiinterfaces.htm" title="iSeries Access for Windows provides C/C++ application programming interfaces (APIs) for accessing iSeries resources.">iSeries Access for Windows C/C++ APIs</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzaikrccommapis.htm">Communications APIs return codes</a></div>
|
||
|
|
<div><a href="rzaikrcsecapis.htm">Security APIs return codes</a></div>
|
||
|
|
<div><a href="rzaikglobalrc.htm">Global iSeries Access return codes</a></div>
|
||
|
|
<div><a href="rzaikas400sysnameformat.htm" title="APIs that take an iSeries system name as a parameter accept names in the following formats.">iSeries system name formats for connection APIs</a></div>
|
||
|
|
<div><a href="rzaikcaexpressprogstd.htm" title="Most of the iSeries Access for Windows C/C++ APIs that accept string parameters exist in three forms: OEM, ANSI, or Unicode.">OEM, ANSI, and Unicode considerations</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|