Configure Xsockets

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.

If you want to use the Web browser client, you must complete setup instructions for the integrated version first.

To create the Xsockets tool, complete the following steps:

To unpackage the tool, enter
```
CALL QUSRTOOL/UNPACKAGE ('*ALL      ' 1)
```
on a command line.
Note: There must be 10 characters between the opening ' and closing'.
To add the QUSRTOOL library to your library list, enter
```
ADDLIBLE QUSRTOOL
```
on a command line.
Create a library in which to create the Xsocket program files by entering
```
CRTLIB <library-name>
```
on a command line. The <library-name> is the the library in which you want the Xsockets tool objects created. For example,
```
CRTLIB MYXSOCKET
```
is a valid library name.
Note: Do not add Xsockets tool objects to the QUSRTOOL library. This can interfere with the use of other tools within that directory.
To add this library to the library list, enter
```
ADDLIBLE <library-name>
```
on the command line. The <library-name> is the library that you created in step 3. For example, MYXSOCKET was used as the library name, then
```
ADDLIBLE MYXSOCKET
```
would be entered.
Create the installation program TSOCRT that automatically installs the Xsockets tool by entering:
```
CRTCLPGM <library-name>/TSOCRT QUSRTOOL/QATTCL
```
on the command line. The <library-name> is the library that you created in step 3. For example, MYXSOCKET was used as the library name, then
```
CRTCLPGM MYXSOCKET/TSOCRT QUSRTOOL/QATTCL
```
would be entered.
To call the installation program, enter:
```
CALL TSOCRT library-name
```
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:
```
CALL TSOCRT MYXSOCKET
```
Note: This might take a few minutes to complete.

If you do not have job control (*JOBCTL) special authority when you call TSOCRT to create the sockets tool, the givedescriptor() socket function returns errors when an attempt is made to pass a descriptor to a job that is not the one you are running.

TSOCRT creates a CL program, an ILE C/400^® 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.

To use the integrated Xsockets tool, see Use integrated Xsockets topic.

Note: 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.