115 lines
7.1 KiB
HTML
115 lines
7.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 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="task" />
|
||
|
|
<meta name="DC.Title" content="Configure Xsockets" />
|
||
|
|
<meta name="abstract" content="There are two versions of the tool that can be created. The first version is integrated with iSeries client. The integrated version is completely created by the first set of instructions. The second version uses a Web browser as the client." />
|
||
|
|
<meta name="description" content="There are two versions of the tool that can be created. The first version is integrated with iSeries client. The integrated version is completely created by the first set of instructions. The second version uses a Web browser as the client." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="xsockets.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="xsockwhatis.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="unative.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="uxsockets.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="cxsockets" />
|
||
|
|
<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>Configure Xsockets</title>
|
||
|
|
</head>
|
||
|
|
<body id="cxsockets"><a name="cxsockets"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Configure Xsockets</h1>
|
||
|
|
<div><p>There are two versions of the tool that can be created. The first
|
||
|
|
version is integrated with iSeries™ client. The integrated version is completely
|
||
|
|
created by the first set of instructions. The second version uses a Web browser
|
||
|
|
as the client.</p>
|
||
|
|
<div class="section"> <p>If you want to use the Web browser client, you
|
||
|
|
must complete setup instructions for the integrated version first.</p>
|
||
|
|
<p>To
|
||
|
|
create the Xsockets tool, complete the following steps:</p>
|
||
|
|
</div>
|
||
|
|
<ol><li class="stepexpand"><span>To unpackage the tool, enter </span> <pre>CALL QUSRTOOL/UNPACKAGE ('*ALL ' 1)</pre>
|
||
|
|
on
|
||
|
|
a command line. <div class="note"><span class="notetitle">Note:</span> There must be 10 characters between the opening ' and
|
||
|
|
closing'.</div>
|
||
|
|
</li>
|
||
|
|
<li class="stepexpand"><span>To add the QUSRTOOL library to your library list, enter </span> <pre>ADDLIBLE QUSRTOOL</pre>
|
||
|
|
on a command line.</li>
|
||
|
|
<li class="stepexpand"><span>Create a library in which to create the Xsocket program files by
|
||
|
|
entering</span> <pre>CRTLIB <library-name></pre>
|
||
|
|
on
|
||
|
|
a command line. The <samp class="codeph"><library-name></samp> is the the library
|
||
|
|
in which you want the Xsockets tool objects created. For example, <pre>CRTLIB MYXSOCKET</pre>
|
||
|
|
is
|
||
|
|
a valid library name. <div class="note"><span class="notetitle">Note:</span> Do not add Xsockets tool objects to the QUSRTOOL
|
||
|
|
library. This can interfere with the use of other tools within that directory.</div>
|
||
|
|
</li>
|
||
|
|
<li class="stepexpand"><span>To add this library to the library list, enter</span> <pre>ADDLIBLE <library-name></pre>
|
||
|
|
on
|
||
|
|
the command line. The <samp class="codeph"><library-name></samp> is the library
|
||
|
|
that you created in step 3. For example, MYXSOCKET was used as the library
|
||
|
|
name, then<pre>ADDLIBLE MYXSOCKET</pre>
|
||
|
|
would be entered.</li>
|
||
|
|
<li class="stepexpand"><span>Create the installation program TSOCRT that automatically
|
||
|
|
installs the Xsockets tool by entering:</span> <pre>CRTCLPGM <library-name>/TSOCRT QUSRTOOL/QATTCL</pre>
|
||
|
|
on
|
||
|
|
the command line. The <samp class="codeph"><library-name></samp> is
|
||
|
|
the library that you created in step 3. For example, MYXSOCKET was used as
|
||
|
|
the library name, then<pre>CRTCLPGM MYXSOCKET/TSOCRT QUSRTOOL/QATTCL</pre>
|
||
|
|
would
|
||
|
|
be entered.</li>
|
||
|
|
<li class="stepexpand"><span>To call the installation program, enter:</span> <pre>CALL TSOCRT library-name</pre>
|
||
|
|
on the command line.
|
||
|
|
In the place of library-name, use the library you created in step 3. For example,
|
||
|
|
to create the tool in the MYXSOCKET library, enter: <pre>CALL TSOCRT MYXSOCKET</pre>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> This
|
||
|
|
might take a few minutes to complete.</div>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<div class="section"> <p> If you do not have job control (*JOBCTL) special authority when
|
||
|
|
you call TSOCRT to create the sockets tool, the <span class="apiname">givedescriptor()</span> socket
|
||
|
|
function returns errors when an attempt is made to pass a descriptor to a
|
||
|
|
job that is not the one you are running.</p>
|
||
|
|
<p>TSOCRT creates
|
||
|
|
a CL program, an ILE C/400<sup>®</sup> program (two modules are created), two ILE C/400 service
|
||
|
|
programs (two modules are created), and three display files. Whenever you
|
||
|
|
want to use the tool, you must add the library to your library list. All objects
|
||
|
|
created by the tool have a name that is prefixed by TSO.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><div class="p">To use the integrated Xsockets tool, see Use integrated
|
||
|
|
Xsockets topic. <div class="note"><span class="notetitle">Note:</span> The integrated version does not support
|
||
|
|
GSKit secure socket APIs. If you want to write socket programs that use the
|
||
|
|
integrated APIs, you should use the browser-based version of the tool.</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><strong><a href="xsockwhatis.htm">What is created by integrated Xsocket setup</a></strong><br />
|
||
|
|
A table lists the objects created by the installation program. All the objects created reside in the specified library.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="xsockets.htm" title="The Xsockets tool is one of the many tools that are shipped with the iSeries. All tools are stored in the QUSRTOOL library. The Xsockets tool allows programmers to interactively work with socket APIs.">Xsockets tool</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="uxsockets.htm" title="There are now two ways to work with the Xsockets tool. You can work with the tool from the integrated client or work with the tool in a Web browser.">Use Xsockets</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="unative.htm" title="This topic helps you use Xsocket on an integrated client.">Use integrated Xsockets</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|