                                   *           Guide to TCP/IP Printer Symbiont                   May, 1995     ?           This manual describes the installation and use of the 6           TCP/IP Printer Symbiont for OpenVMS systems.          =           Revision/Update Information:  This is a new manual.   ?           Operating System and Version: compiled on VAX/OpenVMS ;                                         V5.5-2; Untested on <                                         earlier versions and+                                         AXP   5           Software Version:             TCPIPSYM V1.0                John E. Babbitt, Jr.           john@cutler.com                                                "           ________________________           12 May 1995   =           Permission is granted to copy and redistribute this *           document for no commercial gain.  ?           The information in this document is subject to change 9           without notice and should not be construed as a 9           commitment by the author. The author assumes no ?           responsibility for any errors that may appear in this            document.   9           DISCLAIMER: The author and his employer make no ;           representations or warranties with respect to the ?           contents hereof and specifically disclaim any implied :           warranties of merchantability or fitness for any           particular purpose.   ;           The following are trademarks of Digital Equipment            Corporation:  =           AXP                   DEC                   OpenVMS #           VAX                   VMS   5           UNIX is a registered trademark of USL, Inc.              __________9           Copyright 1995 John E. Babbitt, Jr. All Rights            Reserved.                  A           _______________________________________________________              Contents  A                 _________________________________________________ A                 PREFACE                                       vii   A           _______________________________________________________ A           CHAPTER 1  INTRODUCTION                             1-1   A                 _________________________________________________ A                 1.1   WHAT IS A TCP/IP PRINTER SYMBIONT?      1-1   A                 _________________________________________________ A                 1.2   WHY A TCP/IP PRINTER SYMBIONT?          1-1     A           _______________________________________________________ A           CHAPTER 2  INSTALLING TCPIPSYM                      2-1   A                 _________________________________________________ A                 2.1   BUILDING THE EXECUTABLE                 2-1   A                 _________________________________________________ A                 2.2   PLACING THE EXECUTABLE                  2-1     A           _______________________________________________________ A           CHAPTER 3  SETTING UP A TCP/IP PRINTER QUEUE        3-1   A                 _________________________________________________ A                 3.1   DEFINING /PROCESSOR                     3-1   A                 _________________________________________________ A                 3.2   DEFINING /ON                            3-1               A                                                               iii                     Contents      A           _______________________________________________________ A           APPENDIX A  EXAMPLE                                 A-1                                                                                          iv               A           _______________________________________________________              Preface     ?           This guide explains how to install and use the TCP/IP            Printer Symbiont.   L           __________________________________________________________________             Intended Audience   9           This manual is intended for the System Manager.   <           The reader is assumed to have knowledge of setting;           up printer queues. Furthermore, the reader should <           have some understanding of TCP/IP address and port>           assignment. This software requires NETLIB v2.0 which4           can be obtained from MadGoat's FTP server.  L           __________________________________________________________________             Document Structure  ?           This document consists of an introductory chapter, an :           installation section, and a queue setup section.  L           __________________________________________________________________             Related Documents   <           The Guide to Setting Up a VMS System will give you>           information on setting up queues. The DCL Dictionary<           Part 1 explains command, parameters and qualifiers@           associated with INITIALIZE and SET QUEUE commands. The?           NETLIB Installation Guide explains how to install the @           NETLIB shareable image. These manuals are not included           in this package.        A                                                               vii                  A           _______________________________________________________       1      Introduction        =           This chapter describes the TCP/IP Printer Symbiont.   L           __________________________________________________________________  ,    1.1    What is a TCP/IP Printer Symbiont?  =           The normal OpenVMS printer symbiont communicates to ?           a print device attached directly to its communication ;           hardware, such as a serial port. A TCP/IP printer @           symbionts communicates to a remote print device over a           network using TCP/IP.   L           __________________________________________________________________  (    1.2    Why a TCP/IP Printer Symbiont?  =           It allows one to set up an OpenVMS-style queue that @           talks to printers that can only be reached via TCP/IP.;           For example, one may have several serial printers <           attached to a terminal server that only has TCP/IP>           capabilities. TCPIPSYM can be used to communicate to,           these printers for this situation.                        A                                                               1-1                  A           _______________________________________________________       2      Installing TCPIPSYM         <           Source code is supplied with this package to allow<           you to build the executable from scratch. A Pascal>           compiler and the NETLIB v2.0 package is required. An?           object file of the compiled Pascal source is provided @           for those that do not have a Pascal compiler. There is@           a DESCRIPT.MMS file for those who have MMS or MMK. MMK;           can also be obtained from the MadGoat FTP server.   L           __________________________________________________________________  !    2.1    Building the Executable   @           For those with MMS or MMK, the executable can be built=           by simply typing the appropriate command, i.e., MMS @           or MMK. For those that do not have either product, the4           following steps will build the executable:                  PASCAL TCPIPSYM                MACRO PSMDEF P                LINK/NODEBUG/NOTRACE TCPIPSYM.OBJ, PSMDEF.OBJ, NETLIB.OPT/OPTIONS  <           One do not need to compile the Pascal source since=           the object file for that source is included in this            package.  L           __________________________________________________________________       2.2    Placing the Executable  3           The TCPIPSYM executable must be placed in ?           SYS$COMMON:[SYSEXE] on the node that will connect the @           print queue to the printer via TCP/IP. You can do that            with the COPY command:  4                COPY TCPIPSYM.EXE SYS$COMMON:[SYSEXE]  A                                                               2-1                  A           _______________________________________________________   +    3      Setting Up a TCP/IP Printer Queue         >           The queue setup is the same for normal print queues,@           except that the /PROCESSOR and /ON qualifiers are used,           to establish a TCP/IP print queue.  L           __________________________________________________________________      3.1    Defining /PROCESSOR   5           This qualifier must contain TCPIPSYM, i.e.,   "                /PROCESSOR=TCPIPSYM  :           This tells the queue manager to use this printer3           symbiont in place of its normal symbiont.   L           __________________________________________________________________      3.2    Defining /ON  =           This qualifier must contain the IP Address and port >           number in host format, enclosed within quotes, e.g.,  ,                /ON="tek540a.cutler.com:9100"  ?           It's the address and port of where the remote printer ?           can be reached. One can use either the IP name or the $           IP number for the address.              A                                                               3-1                  A           _______________________________________________________       A      Example                           $ MMK                MACRO PSMDEF.MAR e                LINK /NODEBUG /NOTRACE /EXEC=TCPIPSYM.EXE TCPIPSYM.OBJ, PSMDEF.OBJ, NETLIB.OPT/OPTIONS 6                $ COPY TCPIPSYM.EXE SYS$COMMON:[SYSEXE]_                $ INITIALIZE/QUEUE/START/PROCESSOR=TCPIPSYM/ON="tek540a.cutler.com:9100" TEK540A /                $ PRINT/QUEUE=TEK540A MYFILE.TXT                                                       A                                                               A-1 