-------------------------------------------------------------------------------
 IBM 4079 SunOS* 4.1 Basic Attach Support -- README           Version 0.2 Beta
 Copyright 1992 Lexmark International, Inc.                   November 4, 1992
-------------------------------------------------------------------------------

The Files In This Archive:
-------------------------
ibm4079/
   printcap.4079 -- Contains sample printcap entries for serial attachment
                    of the IBM 4079 laser printer.
   setup         -- Shell script for performing a default installation.
   README        -- This file.

Cabling of IBM 4079 Printer to Sun workstation:
-----------------------------------------------
   The parallel and serial interfaces share the same connector on the
IBM 4079.  The connector on the printer is a 36-pin D-shell female
receptacle (Centronics connector).  There are three methods of serial
attachment for this printer.

   1. An IBM serial cable P/N 6486685 with a Male-Male gender changer.
      This cable has a 25-pin D-shell connector on the printer end and
      a Female DB-25 connector on the host end.  This cable will support
      DTR/DSR and XON/XOFF handshaking with most DTE equiptment.  As most
      Sun workstations have a Female DB-25 connector on their serial ports,
      a gender changer is necessary to make the connection.

   2. A non-IBM serial printer cable with an IBM serial adapter plug
      P/N 1319143 and a gender changer.  The serial adapter plug maps the
      pins of a Male DB-25 connector to the corresponding pins of the
      printer's 25-pin D-shell connector.  This combination will support
      DTR/DSR and XON/XOFF handshaking with most DTE equiptment.  The serial
      printer cable should have the following pin assignments:

                        Host                 Printer
                   (Female DB-25)          (Male DB-25)
                   --------------          ------------
                                2 -------- 3
                                3 -------- 2
                              4,8 -------- 5
                                5 -------- 20
                                6 -------- 4
                                7 -------- 7
                               20 -------- 6

   3. A standard null-modem cable with an IBM serial adapter plug
      P/N 1319143 and a gender changer if necessary.  This combination
      will support XON/XOFF handshaking only.

Installation and Setup of Files Under SunOS:
-------------------------------------------
As supplied, the default printcap entry is set up for the following:

   1. Printer attached to workstation's ttya port at 38400,n,8,1 and will
      have the name ibm4079 associated with the queue.

   2. Spool directory of /var/spool/ibm4079.

   3. Accounting and log files of acct and log within the
      /var/spool/ibm4079 directory.

Non-SPARCstation*/SPARCserver* (Non Sun-4 Application Architecture) Setup:
   If you are installing on a non-SPARCstation or SPARCserver, you need to
   recompile the 4079if filter program.  This can be done by typing "make".

Default Setup:
   If you are satisfied with all of the default location of directories and
   files (items 2-3 above), then you can set up the printer by typing "setup".

   This will automatically create the needed directories, copy the necessary
   files with correct ownership and permissions, and update your /etc/printcap
   file.  Note: Your old printcap file will be saved as /etc/printcap.old.

   If you wish to change any of the port parameters (item 1 above), this may
   be done by editing the ibm4079 entry of the /etc/printcap/file.  See the
   section "Example printcap Entry with Description of Components" of this
   README for more information.

   Set the printer the the appropriate communication mode (under
   "Interface Menu").  If using the default, they should be:

      Serial Protocol  : XON/XOFF should work with any of the cabling methods
                         DTR/DSR should work with cabling methods 1 or 2
             Baud      : 38400
             Data Bits : 8
             Parity    : None

Custom Setup:
   If you want different locations or names for any of the directories or
   files (items 2-4 above), then perform the following steps.

   1. Concatenate printcap.4079 to /etc/printcap by using:
      cat printcap.4079 >>/etc/printcap

   2. Edit /etc/printcap file to change the printer or spool directory names.
      You may also change any of the communication parameters as necessary.
      See the description below.

   3. Create a spool directory under /var/spool corresponding to the directory
      specified in the printcap (sd=) entry.  This directory should have daemon
      owner and group and 775 permissions.  If an error logging file (lf=) or
      an accounting file (af=) were specified in the printcap file, the
      associated files should be created with daemon owner and group and 660
      permissions.

   4. Set the IBM 4079 to the interface, baud rate, parity, stop-bits,
      and hand-shaking matching the printcap entry.  In general, 38400 baud,
      no parity, 1 stop-bit, XON/XOFF handshaking should work well.

Example File Permissions:
------------------------
/var/spool:
   drwxrwsr-x  2 daemon   daemon        512 Oct 12 15:33 ibm4079/
/var/spool/ibm4079:
   -rw-rw----  1 daemon   daemon        638 Oct  8 16:18 acct
   -rw-rw----  1 daemon   daemon          0 Oct 12 15:05 log

Example printcap Entry with Description of Components:
-----------------------------------------------------
Example:
01: ibm4079|IBM 4079 Serial:\
02:	:lp=/dev/ttya:\
03:	:br#38400:\
04:	:ms=-parity,crtscts,ixon,tabs,-onlcr,-echo:\
05:	:sd=/var/spool/ibm4079:\
06:	:lf=/var/spool/ibm4079/log:\
07:	:af=/var/spool/ibm4079/acct:\
08:	:mx#0:\
09:	:sh:\
10:	:ff=\004:

Explanation:
01: Specifies that name(s) associated with this printer and queue.
02: Specifies the name of the Unix special (device) file associated with
    the port that the printer is connected to.  In this case /dev/ttya.
03: Specifies the baud rate at which to communicate.  This must match the
    baud rate setting on the printer.
04: Specifies parameters for the serial device.  The params. in this example
    are as follows: -parity = no parity, 8-bit data; crtscts = honor RTS/CTS
    (hardware) handshaking; ixon = honor XON/XOFF (software) handshaking;
    tabs = do not expand tabs; -onlcr = do not convert LF to CR-LF; -echo =
    do not echo data received from printer.  This corresponds to 38400 baud,
    no parity, 1 stop-bit, and XON/XOFF or DTR/RTS handshaking on the printer.
    For a full explanation of these parameters may be found in the stty(1)
    man page.
05: Specifies the directory for spooling files.
06: Specifies the name of the log file for printer errors (optional).
07: Specifies the name of the accounting file for printer accounting
    (optional).
08: Specifies the maximum block size of jobs allowed.  Because of the 
    ability of PostScript* to print graphics this should be set to 0 (no limit).
09: Specifies that no headers are to be generated.  This is necessary because
    Unix headers would cause PostScript to flush.  Headers could be used if
    an appropriate output filter (of=) were put in place to convert the
    ASCII headers to PostScript.
10: Specifies that he spooler should place an EOT (0x04) at the end of jobs
    instead of a FF.

Note: For a full description of the printcap device entries see the
      printcap(5) man page.


------------------
*  SunOS, SPARCstation, and SPARCserver are the registered trademarks of 
      Sun Microsystems, Inc.
   SPARC is the registered trademark of SPARC International, Inc.
   PostScript is the registered trademark of Adobe Systems, Inc.
