OSA-Express Setup Driver README

This README file contains information about installing the
OSA-Express Setup Driver.

CONTENTS
__________

1.0  PREREQUISITES
2.0  INSTALLING OSA-EXPRESS SETUP DRIVER
3.0  CUSTOMIZING OSA-EXPRESS SETUP DRIVER
4.0  RUNNING OSA-EXPRESS SETUP DRIVER
5.0  TRADEMARKS

1.0  PREREQUISITES 
___________________________

A TPF 4.1 system at PUT level 13 or later with OSA-Express support defined and 
enabled.


2.0  INSTALLING OSA-EXPRESS SETUP DRIVER
________________________________________

The OSA-Express setup driver consists of three segments: QTCP, QTC1, and QTCPBS.

To install the OSA-Express setup driver on your TPF system:

1.  Compile qtcp.cpp 
2.  Assemble qtc1.asm
3.  Link the two objects created from Steps 1 and 2 to the QTCP DLM by using 
    qtcpbs.bsc
4.  Load the QTCP DLM segment to your TPF system.



3.0  CUSTOMIZING OSA-EXPRESS SETUP DRIVER
_________________________________________

The OSA-Express setup driver contains a table of OSA-Express communication 
information. This table must be created and predefined by a network 
administrator. If this table is not set up correctly and information is 
duplicated, the network can fail. See the OSA-Express Setup Driver Users 
Guide for information about setting up the table of user names. 




4.0  RUNNING OSA-EXPRESS SETUP DRIVER
_____________________________________

Run the OSA-Express setup driver by calling the setup_tcpip() function and passing 
a NULL-terminated user name, which will be the user name information to set up. 
This means that you must create a program by which you parse out the information 
from the user and pass this information to the QTCP (setup_tcpip() function).

To have your parsing program recognize the setup_tcpip function, include QTCP as 
a stub and include the following lines in your program:

	#pragma map (setup_tcpip, "QTCP")
	extern "C" int  setup_tcpip(char* user_name);


5.0  TRADEMARKS
_________________

The following terms are trademarks of the International Business
Machines Corporation in the United States, or other countries,
or both:

IBM

Other company, product, and service names may be trademarks
or service marks of others.

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED,
INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS
FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO
THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT,
IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

Copyright IBM Corporation 2002.  All rights reserved.