home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume25 / ispin / part12 < prev    next >
Encoding:
Text File  |  1992-02-01  |  55.3 KB  |  1,127 lines

  1. Newsgroups: comp.sources.unix
  2. From: sir-alan!ispin!lbartz@iuvax.cs.indiana.edu (Larry Bartz)
  3. Subject: v25i123: Indianapolis Standard Printer Interface for Networked printers, Part12/15
  4. Sender: sources-moderator@pa.dec.com
  5. Approved: vixie@pa.dec.com
  6.  
  7. Submitted-By: sir-alan!ispin!lbartz@iuvax.cs.indiana.edu (Larry Bartz)
  8. Posting-Number: Volume 25, Issue 123
  9. Archive-Name: ispin/part12
  10.  
  11. #! /bin/sh
  12. # This is a shell archive.  Remove anything before this line, then unpack
  13. # it by saving it into a file and typing "sh file".  To overwrite existing
  14. # files, type "sh file -c".  You can also feed this as standard input via
  15. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  16. # will see the following message at the end:
  17. #        "End of archive 12 (of 15)."
  18. # Contents:  ISPIN/doc/NQinstall.doc ISPIN/doc/README.rel_2.2
  19. #   ISPIN/doc/wholeGNUdoc ISPIN/doc/OLD-DOCS/README.rel_1.2
  20. # Wrapped by socrates@indy6 on Tue Jan 28 15:27:10 1992
  21. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  22. if test -f 'ISPIN/doc/NQinstall.doc' -a "${1}" != "-c" ; then 
  23.   echo shar: Will not clobber existing file \"'ISPIN/doc/NQinstall.doc'\"
  24. else
  25. echo shar: Extracting \"'ISPIN/doc/NQinstall.doc'\" \(19940 characters\)
  26. sed "s/^X//" >'ISPIN/doc/NQinstall.doc' <<'END_OF_FILE'
  27. X   The installation script and these following procedures must be
  28. X   executed by the superuser.
  29. X
  30. X1. cd to ISPIN.rel_2.2/ISPIN/h
  31. X   Edit the file localcnfg.h
  32. X   Edit the SITELINE constant definition to reflect the name of your site.
  33. X   Modify ONLY what is between the asterisks, keeping the overall width of
  34. X   the line the same as what is already there.
  35. X
  36. X2. cd to ISPIN.rel_2.2/ISPIN/install.
  37. X   Edit the file "Makefile" and make sure the SPOOLER is set to the proper
  38. X   value -
  39. X
  40. X         ZILOGNQ, since your system is a Zilog which uses the nq spooler 
  41. X
  42. X   Execute the command "make" to compile all of the C programs which are
  43. X   used by ISPIN.
  44. X
  45. X3. You are now ready to install the C programs which were just compiled.
  46. X   Take a look at the program "install.sh" to make sure your are comfortable
  47. X   with what it does. Now, execute the command "make install" (make will execute
  48. X   the program install.sh).
  49. X
  50. X4. Copy the executable ../obj/iq to a directory to which your users have
  51. X   a path for execution ( such as, generally, /z/bin ).
  52. X
  53. X5. Make provision in your system start-up script(s) (i.e., /etc/rc_csh)
  54. X   to invoke /usr/spool/queuer/ISPIN/iqueuer (the daemon) every start-up.
  55. X   Execute it now, just for the first start-up.
  56. X
  57. X6. Edit your system's startup and (if any) re-start script(s). The
  58. X   names of these scripts vary, but will almost always be something
  59. X   like "/etc/rc", "/etc/rc_csh", "/etc/rc2". You get the idea. These
  60. X   scripts usually also invoke other scripts along the way. Find the
  61. X   point at which the script gets rid of "old" lock files (files
  62. X   with names like "/usr/spool/uucp/LCK..tty*"). Usually the line
  63. X   in the script says:
  64. X                                 rm -f /usr/spool/uucp/LCK..tty*
  65. X
  66. X            CHANGE IT TO READ:
  67. X                                 rm -fr /usr/spool/uucp/LCK..tty*
  68. X
  69. X   The reason for this change is that the lock files ISPIN creates
  70. X   are actually directories. Adding the "r" flag to the rm(1) arg
  71. X   list permits the removal of any such lock files which remain on
  72. X   the system subsequent to an unexpected or otherwise ungraceful
  73. X   shutdown.
  74. X
  75. X7. Choose the tty(s) through which ISPIN will contact printer(s).
  76. X   Releases 2.0 (and later) of ISPIN support lock files.
  77. X   The tty(s) you choose may be used for other purposes like cu(1) and
  78. X   uucp(1) as well as support of the ISPIN printer(s). You may, however,
  79. X   support several such printers via one or more tty(s).
  80. X   Also refer to your SA manual. As with any other port which supports
  81. X   a printer, if the tty had previously been in use as a login port,
  82. X   the getty must be permanently disabled.
  83. X   Don't concern yourself with whether the tty is ttyconfig as "modem"
  84. X   or as "terminal". ISPIN handles all tty settings itself. 
  85. X
  86. X   ISPIN does, however, cooperate quite well with uugetty. So if you 
  87. X   have a need for bi-directionality (as I do with my little AT&T 3B1)
  88. X   ISPIN is ready to oblige.
  89. X
  90. X8. Connect tty(s) to network. Have your Data Communications Specialist
  91. X   do this while you read ALL of the documentation which came with this
  92. X   release.
  93. X
  94. X   Seriously, I can't make specific recommendations for every possible
  95. X   combo of cpu/data switch and printer/data switch. I will make a strong
  96. X   general recommendation that you connect all valid modem control
  97. X   signals. Don't try to fool the cpu or the switch by feeding their own
  98. X   modem control signals back to them. If you do this, you'll make your
  99. X   data communications less reliable, less fault-tolerant.
  100. X
  101. X   IN GENERAL: If the cpu is DTE and the data switch is DCE and you're
  102. X   using RS-232 25-pin "D" connectors, the pinning will be 1 through 8
  103. X   and 20, all straight through. If your cpu's ttys are DCE (and switch
  104. X   also DCE), you'll need null modem adapter or null modem pinning. Zilog
  105. X   ttys are DCE.
  106. X
  107. X   Some switches do end-to-end modem signal mapping and the pins on which
  108. X   certain signals are listened-for and asserted-upon are different from
  109. X   "normal" RS-232. For some switches, this can also vary depending upon
  110. X   how a given channel is configured.
  111. X
  112. X   Most switches I've seen or heard of (Tellabs, Equinox, David, Gandolph,
  113. X   Mitron, etc) allow channels or groups of channels to be configured to
  114. X   support software flow control, XON/XOFF. ISPIN needs this at both the
  115. X   cpu and printer sides. By the way, the less-expensive "dumb" Equinox
  116. X   which merely passes XON/XOFF from end-to-end with no internal buffering
  117. X   is not adequate (you'll lose characters due to flow control problems).
  118. X   The more sophisticated Equinox is fine.
  119. X   
  120. X   Our X.25 asynchronous pads allow this to be set "on the fly", during a 
  121. X   connect session. Under this facility, we can turn on software flow control
  122. X   via ISPIN's rtab entry for printing, and turn off software flow control 
  123. X   from uucp's L.sys (or Systems) entry to allow uucp "G" protocol. 
  124. X
  125. X9. Connect printer(s) to network. Be sure to configure your printer(s) for 
  126. X   software (XON/XOFF) flow control. Disable hardware (CTS/DTR) flow control.
  127. X   The same goes for all links in your network hardware (the ports or
  128. X   channels to which the cpu and printer are connected).
  129. X
  130. X   Some printers allow XON/XOFF flow control to be enabled or disabled,
  131. X   but they won't let you disable hardware flow control. I'm thinking
  132. X   specifically of the HP LaserJets, but there may be others. In these
  133. X   cases, you'll have to disable hardware flow control through creative
  134. X   pinning. In my case, the printer is DTE, my X.25 async pad is DCE, and
  135. X   all signals are asserted-upon/listened-for on what we consider "normal"
  136. X   RS-232 pin positions. Most of my pad-to-printer cables are straight
  137. X   1-8 & 20. My cable for the HPLJ has pins 4 & 20 swapped.
  138. X
  139. X
  140. X10. Edit the /usr/spool/queuer/ISPIN/rtab to add a line of
  141. X   connect info for each remote printer. If you have some experience
  142. X   setting up a uucp L.sys (or HoneyDanBer's Systems) file, rtab
  143. X   should be a snap.
  144. X
  145. X   The directory ISPIN.rel_2.2/ISPIN/install/lib_rtab contains a
  146. X   README file. READ IT!
  147. X
  148. X   The rtab file supplied with this release includes extensive 
  149. X   comment lines as documentation. Don't delete them. The rtab also
  150. X   includes commented-out printer entries as examples. Take a look.
  151. X   It's pretty straight-forward once you weed out the \p's and \d's.
  152. X   Most of what I'm about to describe is also included in rtab's
  153. X   comments. There are many IMPORTANT details included in rtab but
  154. X   not addressed here.
  155. X
  156. X   Notice that each entry is all one line. As you add an entry for your
  157. X   printer(s), allow the line to wrap around. Line feed or carriage 
  158. X   return terminates the entry. I have made no provision for escaping 
  159. X   newline with a backslash.
  160. X
  161. X   Leading # comments-out the entire line. (Do not use blank lines.)
  162. X
  163. X   The first field is the name by which the printer will be known.
  164. X   I strongly suggest that this be same as the name by which the
  165. X   dqueuer knows the queue member via /usr/spool/queuer/config.
  166. X   You'll see shortly why I can only strongly suggest but not enforce
  167. X   this policy via ISPIN. Use the same name to save yourself and 
  168. X   others from any possible confusion. Your choice of printer name
  169. X   is thus restricted to what is allowable under the dqueuer regime.
  170. X   See your SA manual under "Configuration File Description".
  171. X
  172. X   The second field defines the serial port(s) through which ISPIN
  173. X   may attempt to contact the printer. You chose these in item 6,
  174. X   above. This entry specifies primary and subsequent ports,
  175. X   separated by commas. A one port entry is just as acceptable.
  176. X   Eleven ports is max.
  177. X
  178. X   The third field specifies the speed setting for the port.
  179. X
  180. X   The "-B" flag & arg fields define portions of various "network
  181. X   busy" messages which may be encountered when ISPIN attempts
  182. X   to negotiate through the network. In the case of one example, 
  183. X   because we are calling out from the cpu, into a Tellabs data
  184. X   switch, then out into the X.25 async pad, I have included unique
  185. X   parts of "busy" messages from both the Tellabs and X.25 async pad
  186. X   environments. The usage of the "-B" flag and arguments is, like
  187. X   the other two flags, optional. 
  188. X
  189. X   I VERY STRONGLY suggest that your rtab entries include as many
  190. X   of these "busy" flags and args as you can possibly identify. They
  191. X   add immeasureably to the robustness of the application. Otherwise,
  192. X   the ISPIN won't be able to re-attempt contact of a network-supported
  193. X   printer which is currently being used by another ISPIN from the
  194. X   same (or different) cpu, or (heaven forbid) by an MDQS process,
  195. X   or which is otherwise busy for whatever reason. All looping which
  196. X   occurs under these conditions is strictly under the control of
  197. X   the ISPIN and the IQUEUER. The native lp spooler has no idea any 
  198. X   re-try is going on. Of course, the native cancel command may terminate
  199. X   the ISPIN at any time.
  200. X
  201. X   A "-I" flag and argument field defines a portion of a 
  202. X   network message which would be encountered when/if the line, the
  203. X   destination device, or some intermediate device is just plain dead.
  204. X   Define "-I" flags only for messages which indicate network conditions
  205. X   under which you would prefer that the requested print job simply
  206. X   give up and terminate itself. 
  207. X
  208. X   I personally would prefer my jobs to re-try even under such conditions.
  209. X   The looping algorithm for the "-B" cases described above is not
  210. X   going to cause your system to thrash. So I say "let 'em loop".
  211. X   You or the user who requested the print job should eventually notice
  212. X   things are not moving along. If the job is looping, you'll have an
  213. X   opportunity to correct the network problem or other problem and
  214. X   never lose a print request. Of course, if network conditions are so
  215. X   bad that you know the ISPIN will never get through, the job may be
  216. X   terminated by the native cancel(1) command.
  217. X
  218. X   The arguments to the "-D" flags are unique protions of strings which
  219. X   are messages we expect the network(s) to return when/if the printer
  220. X   is powered-down or disconnected. After each burst of characters which
  221. X   is written by ISPIN to the printer, ISPIN checks the port to see if 
  222. X   there are any characters to be read. Normally there will be none.
  223. X   If, however, the printer has been powered-down or otherwise disconnected,
  224. X   we expect the network device to recognize the situation and give us
  225. X   a message. If we have correctly specified parts of these messages as
  226. X   args to the "-D" flags, the program will immediately detect the "disconnect"
  227. X   situation and loop, attempting to re-establish contact with the printer.
  228. X   Once the connection is re-established, the job will be printed in its
  229. X   entirety. Since the letter "e" is the most frequently used letter in
  230. X   the alphabet, I'll usually have a "-De" field. This way, if we're
  231. X   disconnected from the printer and all the chars we send out are being
  232. X   echoed back to ISPIN, we'll detect the error condition very quickly.
  233. X
  234. X   The "-Q" fields define, in sequence, what signals or 
  235. X   messages should be issued to the network to accomplish a clean break
  236. X   at the end of a successful connect session. Let your knowledge of 
  237. X   your own local switch (if applicable) be your guide. What
  238. X   do you have to enter at your keyboard to assure a clean break?
  239. X   For the moment, ignore the \p's (1 sec pause) and \d's (3 sec delay).
  240. X
  241. X   In one example, remember, we went from cpu, to Tellabs, to X.25 async pad,
  242. X   to the printer. Now to disconnect, we conduct a clean break of each
  243. X   virtual connection under our control.
  244. X   The first "-Q" argument is "\K", which rtab's documentation tells us
  245. X   results in the issuance of a <BREAK>. This is the signal X.25 async pad needs
  246. X   to put the printer's channel into command mode.
  247. X   The next "-Q" argument is "clr" and carriage return, a readily recog-
  248. X   nizable X.25 async pad command which drops the virtual connection.
  249. X   The next two "-Q" flags and arguments issue <BREAK>bye to the local
  250. X   Tellabs data switch. This is my locally defined disconnect sequence
  251. X   for the Tellabs data switch in Indy.
  252. X
  253. X   Before we proceed to a discussion of the EXPECT and SEND sequences,
  254. X   I'll explain the necessity for all of the pauses and delays. In my
  255. X   testing, I found that when ISPIN is running on a lightly loaded cpu 
  256. X   and conversing with the X.25 async pad, the program is capable of shifting
  257. X   between writing to the network and reading from the network MUCH
  258. X   faster than the network is capable of responding. Before long, the
  259. X   EXPECT/SEND sequence gets lost. Rather than "hard code" the necessary
  260. X   delays into the application, I chose to allow the specification of
  261. X   pauses and delays by the user (you). This approach permits the greatest
  262. X   amount of flexibility in implementation. Experiment for yourself.
  263. X   Also, many printers need time to print the contents of their buffers
  264. X   after all characters have been issued by the cpu, but before the network
  265. X   connection is dropped. Increasing delay time in the first "-Q" sequence
  266. X   is the answer. If the last several lines of a document are being lost,
  267. X   try adding a "\w" or "\L" immediately after the first "-Q" flag.
  268. X   If you need more or less pause or delay, adjust your rtab entry.
  269. X
  270. X   Now for the EXPECT/SEND sequences.
  271. X   EXPECT and SEND are pairs.
  272. X   You must begin with EXPECT.
  273. X   You must end with a null SEND field.
  274. X   The best way to figure out what you need to say in these sequences
  275. X   is to call out through the port(s) you are using with cu(1).
  276. X   Once you have made a successful connection all the way through to
  277. X   the printer, any subsequent keyboard activity on your part should
  278. X   show up on the printer.
  279. X   In our example, notice the liberal usage of the compound construction,
  280. X   EXPECT-SEND-EXPECT. This construct exactly mimics uucp's similar
  281. X   feature. Use of this feature significantly enhances your chances of
  282. X   making a successful connection.
  283. X   There is a lot more info on rtab in rtab's comments.
  284. X
  285. X   The directory ISPIN.rel_2.2/ISPIN/install/lib_rtab contains a
  286. X   README file. READ IT!
  287. X
  288. X
  289. X11. Creation of a FIFO for each printer in /usr/spool/queuer/ISPIN/FIFO
  290. X    need not be done manually. The application will create a FIFO for
  291. X    each queue member as needed.
  292. X
  293. X    If you observe the example rtab entry, you'll note the printer is
  294. X    named "LSB1". The first time a request is issued to this queue member,
  295. X    the FIFO /usr/spool/queuer/ISPIN/FIFO/LSB1 will be created.
  296. X
  297. X
  298. X12. Add each remote printer as a member of the native queuer by
  299. X    editing /usr/spool/queuer/config. See your SA manual on this topic.
  300. X    After I added my first ISPIN-supported printer, my /usr/spool/queuer/config
  301. X    looked like this:
  302. X
  303. X#
  304. X# first queue ... lpr has the line printer
  305. X#
  306. XQlpr,R,N,S
  307. X# line printer 1
  308. XD1,R,/dev/lp,/usr/lib/lp
  309. X#Draft   Computer Room  rm. 420
  310. X# line printer 2
  311. X#D2,R,/dev/lp2,/usr/lib/lp
  312. X#Draft   Computer Room  rm. 420
  313. X#
  314. X# second queue ... text has the spinwriter
  315. X#
  316. XQtext,R,N,S
  317. X# spinwriter
  318. XD1,R,/dev/tty5,/z/bin/backend
  319. X# Letter  Exam           rm. 447
  320. XD2,R,/dev/tty6,/usr/lib/text -T "1200 -nl"
  321. X# Draft   Exam           rm. 447
  322. X# spinwriter 4
  323. X#D4,R,/dev/tty7,/usr/lib/text -T "1200 -nl"
  324. X# Letter  Exam           rm. 531
  325. X# spinwriter 5
  326. X# spinwriter 7
  327. XD7,R,/dev/tty17,/z/bin/backend
  328. X#Letter  EEO Office     rm. 556
  329. XQnet,R,N,F
  330. X# network supported
  331. XDLSB1,R,/dev/null,/usr/spool/queuer/ISPIN/ispin -P LSB1
  332. X# Draft  DP (via PACNET) rm. 428
  333. X
  334. X
  335. X    Two items of note. TWO ITEMS OF SIGNIFICANT IMPORTANCE.
  336. X
  337. X    note: I added a new queue named "net" to my config file. It is 
  338. X          not necessary that you do this. ISPIN-supported printers
  339. X          may belong to previously existing queues, if you choose.
  340. X    note: Our config file has many comment lines which are used by
  341. X      our ISPI application. The comment lines have no functional
  342. X          relationship to ISPIN, nor to anything you and I are doing
  343. X          here.
  344. X
  345. X    SIGNIFICANTLY IMPORTANT:
  346. X      The "device" we have specified in our config file entry for
  347. X          the ISPIN-supported printer "LSB1" is /dev/null. It is VITALLY
  348. X      IMPORTANT that the native dqueuer does not know the device
  349. X          ISPIN will be using. If you want to know why, dig into the
  350. X          code. I don't want to go into it here.
  351. X
  352. X    SIGNIFICANTLY IMPORTANT:
  353. X          The "backend" (in nq/dqueuer parlance) command line for
  354. X      /usr/spool/queuer/ISPIN/ispin REQUIRES the "-P" flag and
  355. X      an argument. The argument MUST BE the same as the first
  356. X          field in the printer's rtab entry (printer name). We need
  357. X          this flag and argument because the printer name is not
  358. X          among the arguments dqueuer passes to the backend upon
  359. X          invocation. ISPIN must, however, have the printer's name
  360. X          in order to find the correct rtab info.
  361. X
  362. X
  363. X13. Force the dqueuer to re-read its config file thus:
  364. X    dqueuer -r
  365. X
  366. X14. Use the new printer.
  367. X    The native nq and dqueuer commands will function exactly normally
  368. X    as they relate to the ISPIN-supported printer(s). xq still retains
  369. X    its control over the life and death of the print job.
  370. X
  371. X15. Also use the iq command to inquire the iqueuer daemon. In an active
  372. X    IQUEUER/ISPIN situation, xq may show several print processes as
  373. X    "RUNNING" simultaneously when you know they can't all possibly be
  374. X    printing simultaneously. This situation could arise when/if several
  375. X    ISPIN-supported members of the native queue have been configured by
  376. X    you to all use the same tty for access out to the network. As far as
  377. X    xq and dqueuer are concerned, once the "backend" process has been
  378. X    invoked, the process is "RUNNING". This is the situation the IQUEUER
  379. X    daemon is designed to accomodate. IQUEUER manages the ISPINs which
  380. X    are competing for the scarce resource. iq will show you which of the
  381. X    ISPIN processes are actually running or are actually waiting.
  382. X
  383. X16. Look to /usr/spool/queuer/ISPIN/log for ISPIN error messages and
  384. X    event logging.
  385. X
  386. X
  387. X        PS: I have a very strong theory on the cause of, and solution for,
  388. X            the Zeus 3.21 dqueuer's major problem. As you have probably
  389. X            observed, the dqueuer can get "locked up". It will continue
  390. X            to accept requests, but refuses to actually issue any jobs.
  391. X            Sometimes you can fiddle around with it and get things moving.
  392. X            Sometimes a reboot is the only "solution". 
  393. X            The cause lies in the "status" reporting by the "backend" 
  394. X            program. See /usr/include/spool.h under Zeus 3.21. The backend,
  395. X            on some regular basis, does an unbuffered disk seek and an
  396. X            unbuffered write to the dqueuer's status file. That alone is
  397. X            enough to negatively impact overall system performance. We
  398. X            already know that the overworked disk drive "zero" is busy
  399. X            enough. Servicing unbuffered disk operations drags it down
  400. X            just that much further.
  401. X            Even worse, and the apparent cause for the "lockups", is
  402. X            the competition for exclusive file locks on specific areas of
  403. X            the status file. If you have ever tried this yourself, you
  404. X            may have found, as I have, that the exclusive file locking
  405. X            procedures aren't too terribly reliable. Deadly embraces often
  406. X            result. Lockup city.
  407. X            The solution is to avoid the whole thing by not having the
  408. X            backend report status (pages, pages done, percent done) at
  409. X            all. 
  410. X            Do yourself, your users, and your system a favor and get rid of
  411. X            backend programs which report their status. The loss of the 
  412. X            status information is a small price to pay for a more robust
  413. X            dqueuer and the relief of system "busywork".
  414. X            The ispin backend does not report status. If you choose, you
  415. X            may even support "hardwired" printers through this application.
  416. X            All it takes is an rtab entry with no optional flags and (one
  417. X            each) null EXPECT and SEND strings.
  418. END_OF_FILE
  419. if test 19940 -ne `wc -c <'ISPIN/doc/NQinstall.doc'`; then
  420.     echo shar: \"'ISPIN/doc/NQinstall.doc'\" unpacked with wrong size!
  421. fi
  422. # end of 'ISPIN/doc/NQinstall.doc'
  423. fi
  424. if test -f 'ISPIN/doc/README.rel_2.2' -a "${1}" != "-c" ; then 
  425.   echo shar: Will not clobber existing file \"'ISPIN/doc/README.rel_2.2'\"
  426. else
  427. echo shar: Extracting \"'ISPIN/doc/README.rel_2.2'\" \(11207 characters\)
  428. sed "s/^X//" >'ISPIN/doc/README.rel_2.2' <<'END_OF_FILE'
  429. X
  430. X
  431. X
  432. X        date   :  August 29, 1991
  433. X
  434. X        to     :       
  435. X
  436. X        from   :  Systems Administrator, Information Systems Division
  437. X                  Internal Revenue Service
  438. X                  Indianapolis District Office
  439. X
  440. X        subject:  Indianapolis Standard Printer Interface (for Network printers)
  441. X                  ISPIN
  442. X                  production release 2.2
  443. X
  444. X
  445. X
  446. X        *** *** *** *** *** *** INTRODUCTION *** *** *** *** *** *** *** ***
  447. X
  448. X        This is the current version of the production release of ISPIN.
  449. X        ISPIN.rel_2.2 differs from the 2.1 release only in its documentation,
  450. X        which has been modified to support a public release of ISPIN.
  451. X
  452. X        To date, ISPIN has been successfully installed and tested on these
  453. X        systems:
  454. X                                     AT&T  3B1
  455. X                                     AT&T  3B2600G
  456. X                                     CCI 6/32 MP   (CCI SysV)
  457. X                                     Compaq with Intel 80286 CPU
  458. X                                             (running XENIX)
  459. X                                     IBM PC/AT with Intel 80386 CPU
  460. X                                             (running XENIX)
  461. X                                     IBM PC/AT with Intel 80386 CPU
  462. X                                             (running SCO UNIX V.3.2)
  463. X                                     Dell 325 with Intel 80386-25 CPU
  464. X                                     (Interactive UNIX V.3.2)
  465. X                                     Prime EXL 50
  466. X                                     Pyramid 90x
  467. X                                     Pyramid 9810
  468. X                                     Pyramid MIS-4
  469. X                                     Sequent Balance B8 (DYNIX)
  470. X                                     Sequent Symmetry (DYNIX)
  471. X                                     Unisys 5000
  472. X                                     Zilog Model 31
  473. X                                     Zilog Model 32
  474. X                                     Zilog Model 130 (Rev J OS)
  475. X
  476. X        The networks upon which ISPIN has been tested so far include:
  477. X
  478. X                                     CDN (IRS X.25 network with async interface)
  479. X                                     Teltone/Tellabs Switch
  480. X                                     Gandolph Switch
  481. X                                     David Switch
  482. X                                     Mitron Switch
  483. X                                     Equinox Switch
  484. X                                     Neac Switch/PBX
  485. X
  486. X
  487. X        *** *** *** *** *** *** THIS TRANSMITTAL *** *** *** *** *** *** ***
  488. X
  489. X        
  490. X        This transmittal creates a directory named ISPIN.rel_2.2. 
  491. X
  492. X        ISPIN.rel_2.2 will contain two subdirectories, namely ISPI and ISPIN.
  493. X
  494. X
  495. X        *** *** *** *** *** *** ISPIN subdirectory *** *** *** *** *** *** ***
  496. X
  497. X        ISPIN contains the source code, install documents, and install scripts 
  498. X        for the ISPIN application. The ISPIN application serves as a BACKEND, 
  499. X        a network/printer interface for the native queuer/spooler. ISPIN
  500. X        currently supports the UNIX Sys V lp/lpsched spooler and the Zeus 3.21
  501. X        (Zilog) nq/dqueuer.
  502. X
  503. X        We have organized the directory ISPIN into subdirectories using
  504. X        standard names "doc" (for documentation files), "h" (for header
  505. X        files), "install" (where install scripts exist, and from which they
  506. X        must be executed), "obj" (where the executables will be placed as
  507. X        they are compiled), and "src" (where the source code resides).
  508. X
  509. X
  510. X
  511. X        *** *** *** *** *** *** ISPI subdirectory *** *** *** *** *** *** ***
  512. X
  513. X        The ISPI directory contains the freshest version of our ISPI
  514. X        application. ISPI is an application which serves as a FRONTEND,
  515. X        a user interface, for the native queuer/spoolers. ISPI currently
  516. X        supports the UNIX Sys V lp/lpsched spooler and the Zeus 3.21
  517. X        (Zilog) nq/dqueuer.
  518. X
  519. X        ISPI includes its own source code and documentation. We sent
  520. X        ISPI along because we have found it to be an extremely useful tool
  521. X        to support the native queuer/spoolers. If you have any version of
  522. X        ISPI previous to this one, please use this one as a replacement. The
  523. X        ISPI included with this transmittal supersedes the ISPI which
  524. X        accompanied the ISPIN.rel_2.1 release.
  525. X
  526. X        ISPIN and ISPI are TWO SEPARATE AND DISTINCT APPLICATIONS.
  527. X
  528. X        Neither depends upon the other for functionality. You may use ISPIN
  529. X        without ISPI. You may use ISPI without ISPIN.
  530. X
  531. X
  532. X
  533. X        *** *** *** *** *** *** ISPIN documentation *** *** *** *** *** ***
  534. X
  535. X        The documentation for this application is informal in style, and the
  536. X        code is overflowing with comments. If you don't have time and inclin-
  537. X        ation to read everything in the ISPIN.rel_2.2/ISPIN/doc directory,
  538. X        AT LEAST READ:
  539. X                        TECH.doc, OVERVIEW, and rtab
  540. X
  541. X        Several files in the ISPIN/doc/OLD-DOCS directory document the 
  542. X        design, development, testing, and implementation history of ISPIN.
  543. X
  544. X/****************************************************************************/
  545. X/*                                                                          */
  546. X/*  Copyright (C) 1991                                                      */
  547. X/*  Larry Bartz                                                             */
  548. X/*  Internal Revenue Service                                                */
  549. X/*  Indianapolis District Office                                            */
  550. X/*                                                                          */
  551. X/*  This program is free software; you can redistribute it and/or modify    */
  552. X/*  it under the terms of the GNU General Public License as published by    */
  553. X/*  the Free Software Foundation, version 1.                                */
  554. X/*                                                                          */
  555. X/*  This program is distributed in the hope that it will be useful,         */
  556. X/*  but WITHOUT ANY WARRANTY; without even the implied warranty of          */
  557. X/*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           */
  558. X/*  GNU General Public License for more details.                            */
  559. X/*                                                                          */
  560. X/*  You should have received a copy of the GNU General Public License       */
  561. X/*  along with this program; if not, write to the Free Software             */
  562. X/*  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.               */
  563. X/*                                                                          */
  564. X/****************************************************************************/
  565. X
  566. X
  567. X        *** *** *** *** *** *** ISPIN installation *** *** *** *** *** *** ***
  568. X
  569. X        If you are installing this application under System V UNIX and
  570. X        the lp spooler, install per LPinstall.doc.
  571. X
  572. X        If you are installing this application under ZEUS 3.21 and its
  573. X        nq/xq/dqueuer queuer family, install per NQinstall.doc.
  574. X
  575. X
  576. X
  577. X        *** *** *** *** *** *** FEEDBACK, please *** *** *** *** *** *** ***
  578. X
  579. X        We are maintaining a list of sites which use ISPI/ISPIN and of
  580. X        contact persons at those sites. Unless you tell us, however, we will
  581. X        have no idea whether or not you actually use these applications
  582. X        in production. Our hope is that you will, but we will not 
  583. X        presume it. Please confirm installation and usage of ISPI/ISPIN
  584. X        via e-mail sent to me as shown at the end of this document.
  585. X
  586. X        Confirmed users will receive all subsequent update and informational 
  587. X        distributions. We will notify users of updates via an electronic mail 
  588. X        group, also shown below.  If possible, we would like your site to have
  589. X        a user included in this group. An administrative e-mail address which
  590. X        is aliased to an actual user(s) at your end is preferred (i.e.
  591. X        "dat1!sysadm" instead of "dat1!jdoe"). Please notify us of the e-mail
  592. X        address at which you would like to receive ISPIN information.
  593. X
  594. X        There is no bug-free software. Although the alpha site and beta site
  595. X        testing has been extensive, and ISPIN has been in heavy production
  596. X        use for two years, we recognize the possibility of bugs which
  597. X        have not yet been exposed. Please report them to me by electronic mail
  598. X        as decribed elsewhere.
  599. X
  600. X        If you install and use ISPI/ISPIN on hardware/software platforms which
  601. X        are not listed in this memo, please let me know. This software is 
  602. X        intended to be portable.
  603. X
  604. X        If you develop "rtab" entries which you feel others may find useful,
  605. X        share them! Use the e-mail alias "ispinusr". Anything you send to
  606. X        that address will automagically be distributed among all participating
  607. X        ISPIN customer sites. Same thing applies for any other information
  608. X        you may wish to share, such as printer set-ups, weird pinning
  609. X        configs, etc.
  610. X
  611. X        
  612. X
  613. X
  614. X
  615. X                                                             Larry Bartz
  616. X
  617. X
  618. X|::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::|
  619. X|  Larry Bartz                                                               |
  620. X|                                                                            |
  621. X|   UNIX/uucp e-mail:                                                        |
  622. X|                                                                            |
  623. X|   {pharaoh, MWR, INDY_3, BUFFALO, ARC_CO, BSC05,                           |
  624. X|      clt2, TEPS!indy6, ln3, pscs27!indy6, uunet!sir-alan}!ispin!lbartz     |
  625. X|                                                                            |
  626. X|   IRS-private MMDF:                                                        |
  627. X|                                                                            |
  628. X|   lbartz@indy6                                                             |
  629. X|                                                                            |
  630. X|::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::|
  631. X|::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::|
  632. X|  ISPIN customer sites - broadcast to all known ISPIN users                 |
  633. X|                                                                            |
  634. X|   UNIX/uucp e-mail:                                                        |
  635. X|                                                                            |
  636. X|   {pharaoh, MWR, INDY_3, BUFFALO, ARC_CO, BSC05,                           |
  637. X|      clt2, TEPS!indy6, ln3, pscs27!indy6,                                  |
  638. X|                                   uunet!sir-alan}!ispin!indy6!ispinusr     |
  639. X|                                                                            |
  640. X|   IRS-private MMDF:                                                        |
  641. X|                                                                            |
  642. X|   ispinusr@indy6                                                           |
  643. X|                                                                            |
  644. X|::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::|
  645. END_OF_FILE
  646. if test 11207 -ne `wc -c <'ISPIN/doc/README.rel_2.2'`; then
  647.     echo shar: \"'ISPIN/doc/README.rel_2.2'\" unpacked with wrong size!
  648. fi
  649. # end of 'ISPIN/doc/README.rel_2.2'
  650. fi
  651. if test -f 'ISPIN/doc/wholeGNUdoc' -a "${1}" != "-c" ; then 
  652.   echo shar: Will not clobber existing file \"'ISPIN/doc/wholeGNUdoc'\"
  653. else
  654. echo shar: Extracting \"'ISPIN/doc/wholeGNUdoc'\" \(12789 characters\)
  655. sed "s/^X//" >'ISPIN/doc/wholeGNUdoc' <<'END_OF_FILE'
  656. XThis is the copyright notice and warranty disclaimer we propose using
  657. Xwhen releasing ISPIN into the public domain. It is pretty much self-
  658. Xexplanatory. We should use it "as is" but we should not take the step
  659. Xrecommended in the appendix in which the employer divests itself from 
  660. Xcopyright interest.
  661. X
  662. X
  663. X            GNU GENERAL PUBLIC LICENSE
  664. X             Version 1, February 1989
  665. X
  666. X Copyright (C) 1989 Free Software Foundation, Inc.
  667. X                    675 Mass Ave, Cambridge, MA 02139, USA
  668. X Everyone is permitted to copy and distribute verbatim copies
  669. X of this license document, but changing it is not allowed.
  670. X
  671. X                Preamble
  672. X
  673. X  The license agreements of most software companies try to keep users
  674. Xat the mercy of those companies.  By contrast, our General Public
  675. XLicense is intended to guarantee your freedom to share and change free
  676. Xsoftware--to make sure the software is free for all its users.  The
  677. XGeneral Public License applies to the Free Software Foundation's
  678. Xsoftware and to any other program whose authors commit to using it.
  679. XYou can use it for your programs, too.
  680. X
  681. X  When we speak of free software, we are referring to freedom, not
  682. Xprice.  Specifically, the General Public License is designed to make
  683. Xsure that you have the freedom to give away or sell copies of free
  684. Xsoftware, that you receive source code or can get it if you want it,
  685. Xthat you can change the software or use pieces of it in new free
  686. Xprograms; and that you know you can do these things.
  687. X
  688. X  To protect your rights, we need to make restrictions that forbid
  689. Xanyone to deny you these rights or to ask you to surrender the rights.
  690. XThese restrictions translate to certain responsibilities for you if you
  691. Xdistribute copies of the software, or if you modify it.
  692. X
  693. X  For example, if you distribute copies of a such a program, whether
  694. Xgratis or for a fee, you must give the recipients all the rights that
  695. Xyou have.  You must make sure that they, too, receive or can get the
  696. Xsource code.  And you must tell them their rights.
  697. X
  698. X  We protect your rights with two steps: (1) copyright the software, and
  699. X(2) offer you this license which gives you legal permission to copy,
  700. Xdistribute and/or modify the software.
  701. X
  702. X  Also, for each author's protection and ours, we want to make certain
  703. Xthat everyone understands that there is no warranty for this free
  704. Xsoftware.  If the software is modified by someone else and passed on, we
  705. Xwant its recipients to know that what they have is not the original, so
  706. Xthat any problems introduced by others will not reflect on the original
  707. Xauthors' reputations.
  708. X
  709. X  The precise terms and conditions for copying, distribution and
  710. Xmodification follow.
  711. X
  712. X            GNU GENERAL PUBLIC LICENSE
  713. X   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  714. X
  715. X  0. This License Agreement applies to any program or other work which
  716. Xcontains a notice placed by the copyright holder saying it may be
  717. Xdistributed under the terms of this General Public License.  The
  718. X"Program", below, refers to any such program or work, and a "work based
  719. Xon the Program" means either the Program or any work containing the
  720. XProgram or a portion of it, either verbatim or with modifications.  Each
  721. Xlicensee is addressed as "you".
  722. X
  723. X  1. You may copy and distribute verbatim copies of the Program's source
  724. Xcode as you receive it, in any medium, provided that you conspicuously and
  725. Xappropriately publish on each copy an appropriate copyright notice and
  726. Xdisclaimer of warranty; keep intact all the notices that refer to this
  727. XGeneral Public License and to the absence of any warranty; and give any
  728. Xother recipients of the Program a copy of this General Public License
  729. Xalong with the Program.  You may charge a fee for the physical act of
  730. Xtransferring a copy.
  731. X
  732. X  2. You may modify your copy or copies of the Program or any portion of
  733. Xit, and copy and distribute such modifications under the terms of Paragraph
  734. X1 above, provided that you also do the following:
  735. X
  736. X    a) cause the modified files to carry prominent notices stating that
  737. X    you changed the files and the date of any change; and
  738. X
  739. X    b) cause the whole of any work that you distribute or publish, that
  740. X    in whole or in part contains the Program or any part thereof, either
  741. X    with or without modifications, to be licensed at no charge to all
  742. X    third parties under the terms of this General Public License (except
  743. X    that you may choose to grant warranty protection to some or all
  744. X    third parties, at your option).
  745. X
  746. X    c) If the modified program normally reads commands interactively when
  747. X    run, you must cause it, when started running for such interactive use
  748. X    in the simplest and most usual way, to print or display an
  749. X    announcement including an appropriate copyright notice and a notice
  750. X    that there is no warranty (or else, saying that you provide a
  751. X    warranty) and that users may redistribute the program under these
  752. X    conditions, and telling the user how to view a copy of this General
  753. X    Public License.
  754. X
  755. X    d) You may charge a fee for the physical act of transferring a
  756. X    copy, and you may at your option offer warranty protection in
  757. X    exchange for a fee.
  758. X
  759. XMere aggregation of another independent work with the Program (or its
  760. Xderivative) on a volume of a storage or distribution medium does not bring
  761. Xthe other work under the scope of these terms.
  762. X
  763. X  3. You may copy and distribute the Program (or a portion or derivative of
  764. Xit, under Paragraph 2) in object code or executable form under the terms of
  765. XParagraphs 1 and 2 above provided that you also do one of the following:
  766. X
  767. X    a) accompany it with the complete corresponding machine-readable
  768. X    source code, which must be distributed under the terms of
  769. X    Paragraphs 1 and 2 above; or,
  770. X
  771. X    b) accompany it with a written offer, valid for at least three
  772. X    years, to give any third party free (except for a nominal charge
  773. X    for the cost of distribution) a complete machine-readable copy of the
  774. X    corresponding source code, to be distributed under the terms of
  775. X    Paragraphs 1 and 2 above; or,
  776. X
  777. X    c) accompany it with the information you received as to where the
  778. X    corresponding source code may be obtained.  (This alternative is
  779. X    allowed only for noncommercial distribution and only if you
  780. X    received the program in object code or executable form alone.)
  781. X
  782. XSource code for a work means the preferred form of the work for making
  783. Xmodifications to it.  For an executable file, complete source code means
  784. Xall the source code for all modules it contains; but, as a special
  785. Xexception, it need not include source code for modules which are standard
  786. Xlibraries that accompany the operating system on which the executable
  787. Xfile runs, or for standard header files or definitions files that
  788. Xaccompany that operating system.
  789. X
  790. X  4. You may not copy, modify, sublicense, distribute or transfer the
  791. XProgram except as expressly provided under this General Public License.
  792. XAny attempt otherwise to copy, modify, sublicense, distribute or transfer
  793. Xthe Program is void, and will automatically terminate your rights to use
  794. Xthe Program under this License.  However, parties who have received
  795. Xcopies, or rights to use copies, from you under this General Public
  796. XLicense will not have their licenses terminated so long as such parties
  797. Xremain in full compliance.
  798. X
  799. X  5. By copying, distributing or modifying the Program (or any work based
  800. Xon the Program) you indicate your acceptance of this license to do so,
  801. Xand all its terms and conditions.
  802. X
  803. X  6. Each time you redistribute the Program (or any work based on the
  804. XProgram), the recipient automatically receives a license from the original
  805. Xlicensor to copy, distribute or modify the Program subject to these
  806. Xterms and conditions.  You may not impose any further restrictions on the
  807. Xrecipients' exercise of the rights granted herein.
  808. X
  809. X  7. The Free Software Foundation may publish revised and/or new versions
  810. Xof the General Public License from time to time.  Such new versions will
  811. Xbe similar in spirit to the present version, but may differ in detail to
  812. Xaddress new problems or concerns.
  813. X
  814. XEach version is given a distinguishing version number.  If the Program
  815. Xspecifies a version number of the license which applies to it and "any
  816. Xlater version", you have the option of following the terms and conditions
  817. Xeither of that version or of any later version published by the Free
  818. XSoftware Foundation.  If the Program does not specify a version number of
  819. Xthe license, you may choose any version ever published by the Free Software
  820. XFoundation.
  821. X
  822. X  8. If you wish to incorporate parts of the Program into other free
  823. Xprograms whose distribution conditions are different, write to the author
  824. Xto ask for permission.  For software which is copyrighted by the Free
  825. XSoftware Foundation, write to the Free Software Foundation; we sometimes
  826. Xmake exceptions for this.  Our decision will be guided by the two goals
  827. Xof preserving the free status of all derivatives of our free software and
  828. Xof promoting the sharing and reuse of software generally.
  829. X
  830. X                NO WARRANTY
  831. X
  832. X  9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  833. XFOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  834. XOTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  835. XPROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  836. XOR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  837. XMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  838. XTO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  839. XPROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  840. XREPAIR OR CORRECTION.
  841. X
  842. X  10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  843. XWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  844. XREDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  845. XINCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  846. XOUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  847. XTO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  848. XYOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  849. XPROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  850. XPOSSIBILITY OF SUCH DAMAGES.
  851. X
  852. X             END OF TERMS AND CONDITIONS
  853. X
  854. X    Appendix: How to Apply These Terms to Your New Programs
  855. X
  856. X  If you develop a new program, and you want it to be of the greatest
  857. Xpossible use to humanity, the best way to achieve this is to make it
  858. Xfree software which everyone can redistribute and change under these
  859. Xterms.
  860. X
  861. X  To do so, attach the following notices to the program.  It is safest to
  862. Xattach them to the start of each source file to most effectively convey
  863. Xthe exclusion of warranty; and each file should have at least the
  864. X"copyright" line and a pointer to where the full notice is found.
  865. X
  866. X    <one line to give the program's name and a brief idea of what it does.>
  867. X    Copyright (C) 19yy  <name of author>
  868. X
  869. X    This program is free software; you can redistribute it and/or modify
  870. X    it under the terms of the GNU General Public License as published by
  871. X    the Free Software Foundation; either version 1, or (at your option)
  872. X    any later version.
  873. X
  874. X    This program is distributed in the hope that it will be useful,
  875. X    but WITHOUT ANY WARRANTY; without even the implied warranty of
  876. X    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  877. X    GNU General Public License for more details.
  878. X
  879. X    You should have received a copy of the GNU General Public License
  880. X    along with this program; if not, write to the Free Software
  881. X    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  882. X
  883. XAlso add information on how to contact you by electronic and paper mail.
  884. X
  885. XIf the program is interactive, make it output a short notice like this
  886. Xwhen it starts in an interactive mode:
  887. X
  888. X    Gnomovision version 69, Copyright (C) 19xx name of author
  889. X    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  890. X    This is free software, and you are welcome to redistribute it
  891. X    under certain conditions; type `show c' for details.
  892. X
  893. XThe hypothetical commands `show w' and `show c' should show the
  894. Xappropriate parts of the General Public License.  Of course, the
  895. Xcommands you use may be called something other than `show w' and `show
  896. Xc'; they could even be mouse-clicks or menu items--whatever suits your
  897. Xprogram.
  898. X
  899. XYou should also get your employer (if you work as a programmer) or your
  900. Xschool, if any, to sign a "copyright disclaimer" for the program, if
  901. Xnecessary.  Here a sample; alter the names:
  902. X
  903. X  Yoyodyne, Inc., hereby disclaims all copyright interest in the
  904. X  program `Gnomovision' (a program to direct compilers to make passes
  905. X  at assemblers) written by James Hacker.
  906. X
  907. X  <signature of Ty Coon>, 1 April 1989
  908. X  Ty Coon, President of Vice
  909. X
  910. XThat's all there is to it!
  911. X
  912. X
  913. X
  914. END_OF_FILE
  915. if test 12789 -ne `wc -c <'ISPIN/doc/wholeGNUdoc'`; then
  916.     echo shar: \"'ISPIN/doc/wholeGNUdoc'\" unpacked with wrong size!
  917. fi
  918. # end of 'ISPIN/doc/wholeGNUdoc'
  919. fi
  920. if test -f 'ISPIN/doc/OLD-DOCS/README.rel_1.2' -a "${1}" != "-c" ; then 
  921.   echo shar: Will not clobber existing file \"'ISPIN/doc/OLD-DOCS/README.rel_1.2'\"
  922. else
  923. echo shar: Extracting \"'ISPIN/doc/OLD-DOCS/README.rel_1.2'\" \(8273 characters\)
  924. sed "s/^X//" >'ISPIN/doc/OLD-DOCS/README.rel_1.2' <<'END_OF_FILE'
  925. X
  926. X
  927. X
  928. X        date   :  January 29, 1990
  929. X
  930. X        to     :       
  931. X
  932. X        from   :  Chief, Operations Branch, Information Systems Division
  933. X                  Indianapolis District Office
  934. X
  935. X        subject:  Indianapolis Standard Printer Interface (for Network printers)
  936. X                  ISPIN
  937. X                  production release 1.2
  938. X
  939. X
  940. X
  941. X        *** *** *** *** *** *** INTRODUCTION *** *** *** *** *** *** *** ***
  942. X
  943. X        This is the current version of the production release of ISPIN.
  944. X        The following instructions should be followed by those sites which
  945. X        have not previously installed ISPIN. If you already have ISPIN
  946. X        release 1.1 installed on your system, you should follow the 
  947. X        instructions in the file "UPDATEto1.2".
  948. X
  949. X        June 30, 1989 marked approximately one year since ISPIN was just a
  950. X        gleam in our eyes, and approx nine months since the first keystrokes
  951. X        were struck in its development. Alpha site testing of ISPIN commenced
  952. X        approx December 27, 1988. Beta site testing commenced approx Feb 14,
  953. X        1989. Ultimately, seven sites were actively involved in testing three
  954. X        successive "beta" versions of the application. This is not experimental
  955. X        software.
  956. X
  957. X        ISPIN.rel_1.2 contains all of the functionality and features laid out
  958. X        in our initial analysis and those which were identified and suggested
  959. X        by those beta test sites which actively helped us test. Except for bug
  960. X        fixes, this is the way the application is going to look and work.
  961. X        We are not planning any added features, nor are we soliciting any
  962. X        suggestions for added features. This application is simple, flexible,
  963. X        robust, and adequately functional. We intend for it to remain stable.
  964. X
  965. X        ISPIN has been successfully installed and tested on:
  966. X
  967. X                                     Zilog Model 31
  968. X                                     Zilog Model 32
  969. X                                     Zilog Model 130 (Rev J OS)
  970. X                                     AT&T  3B1
  971. X                                     Sequent Balance B8
  972. X                                     Sequent Symmetry
  973. X                                     Prime EXL
  974. X                                     Pyramid 90x
  975. X                                     Pyramid MIS-4
  976. X                                     IBM PC/AT with Intel 80386 CPU
  977. X                                             (running XENIX)
  978. X                                     Compaq with Intel 80286 CPU
  979. X                                             (running XENIX)
  980. X                                     CDN 
  981. X                                     Teltone/Tellabs Switch
  982. X                                     Gandolph Switch
  983. X                                     Mitron Switch
  984. X                                     Equinox Switch
  985. X                                     Neac Switch
  986. X
  987. X
  988. X
  989. X        Except for conditional compile statements required to resolve the
  990. X        differences between Zeus 3.21's nq/dqueuer and System V's lp and
  991. X        between System V UNIX and UCB UNIX, the source code is the same for
  992. X        all target environments.
  993. X
  994. X        *** *** *** *** *** *** THIS TRANSMITTAL *** *** *** *** *** *** ***
  995. X
  996. X        The tape upon which we have transmitted the application was created
  997. X        in cpio format. cd to a directory in which you want this release to
  998. X        be written, then execute the command:
  999. X                        cpio -iudmvBc < your_tape_drive
  1000. X
  1001. X        The result of this cpio will be the creation of a directory named
  1002. X        ISPIN.rel_1.2. ISPIN.rel_1.2 will contain two subdirectories, namely
  1003. X        ISPI and ISPIN.
  1004. X
  1005. X
  1006. X
  1007. X        *** *** *** *** *** *** ISPI subdirectory *** *** *** *** *** *** ***
  1008. X
  1009. X        The ISPI directory contains the freshest version of our ISPI
  1010. X        application. ISPI is an application which serves as a FRONTEND
  1011. X        for the two queuer/spoolers. The ISPI application is fully self-
  1012. X        contained, with its own source code, documentation, etc. We sent
  1013. X        ISPI along because we have found it to be an extremely useful tool
  1014. X        to support the native queuer/spoolers. If you have any version of
  1015. X        ISPI previous to this one, please use this one as a replacement. The
  1016. X        ISPI included with this transmittal supersedes the ISPI which
  1017. X        accompanied the ISPIN.beta.3 release.
  1018. X
  1019. X        ISPIN and ISPI are TWO SEPARATE AND DISTINCT APPLICATIONS.
  1020. X
  1021. X        Neither depends upon the other for functionality. You may use ISPIN
  1022. X        without ISPI. You may use ISPI without ISPIN.
  1023. X
  1024. X
  1025. X
  1026. X        *** *** *** *** *** *** ISPIN subdirectory *** *** *** *** *** *** ***
  1027. X
  1028. X        ISPIN contains the source code, install documents, and install scripts 
  1029. X        for the ISPIN application. The ISPIN application serves as a BACKEND 
  1030. X        for either of two native queuer/spoolers, lp or dqueuer. We have 
  1031. X        organized the directory ISPIN and its contents into subdirectories
  1032. X        using standard names "doc" (for documentation files), "h" (for header
  1033. X        files), "install" (where install scripts exist, and from which they
  1034. X        must be executed), "obj" (where the executables will be placed as
  1035. X        they are compiled), and "src" (where the source code resides).
  1036. X
  1037. X
  1038. X
  1039. X        *** *** *** *** *** *** ISPIN documentation *** *** *** *** *** ***
  1040. X
  1041. X        The documentation for this application is informal in style, and the
  1042. X        code is overflowing with comments. If you don't have time and inclin-
  1043. X        ation to read everything in the ISPIN.rel_1.2/ISPIN/doc directory,
  1044. X        AT LEAST READ: LPinstall.doc, NQinstall.doc, README.beta.3, design, and
  1045. X        rtab.
  1046. X
  1047. X
  1048. X
  1049. X
  1050. X
  1051. X        *** *** *** *** *** *** ISPIN installation *** *** *** *** *** *** ***
  1052. X
  1053. X        If you are installing this application under ZEUS 3.21 and its
  1054. X        nq/xq/dqueuer queuer family, install per NQinstall.doc.
  1055. X
  1056. X        If you are installing this application under System V UNIX and
  1057. X        the lp spooler, install per LPinstall.doc.
  1058. X
  1059. X
  1060. X
  1061. X        *** *** *** *** *** *** FEEDBACK, please *** *** *** *** *** *** ***
  1062. X
  1063. X        We are maintaining a list of sites to which we have sent ISPI/ISPIN
  1064. X        and of contact persons at those sites. Unless you tell us, however,
  1065. X        we will have no idea whether or not you actually use these applications
  1066. X        in production. Our expectation is that you will, but we will not 
  1067. X        presume it. Please confirm installation and usage of ISPI/ISPIN. We
  1068. X        prefer confirmation via mmdf mail sent to "ispin@indy1", but written 
  1069. X        confirmation or a phone call will do. Confirmed users of ISPI/ISPIN 
  1070. X        will receive all subsequent update and informational distributions.
  1071. X        We will notify users of updates via a mmdf electronic mail group, 
  1072. X        "ispinusr@indy1".  If possible, we would like your site to have an 
  1073. X        user included in this mmdf group. An administrative mmdf address which
  1074. X        is aliased to an actual user at your end is preferred (i.e.
  1075. X        "sysadm@det1" instead of "jdoe@det1"). Please notify us of the mmdf
  1076. X        address at which you would like to receive ISPIN information.
  1077. X
  1078. X        There is no bug-free software. Although the alpha site and beta site
  1079. X        testing has been extensive, we recognize the possibility of bugs which
  1080. X        have not yet been exposed. Please report them to us by telephone or by
  1081. X        sending mmdf mail to "ispin@indy1". We are committed to supporting this
  1082. X        application.
  1083. X
  1084. X        If you install and use ISPI/ISPIN on hardware/software platforms which
  1085. X        are not listed in this memo, please let us know. This software is 
  1086. X        intended to be portable, especially among machines which support a 
  1087. X        System V UNIX environment. 
  1088. X
  1089. X        If you develop "rtab" entries which you feel others may find useful,
  1090. X        contact us. We'd like to be the clearinghouse for such information.
  1091. X        We have plans to implement a software distribution facility for 
  1092. X        users of Indianapolis applications.  The establishment of the mmdf 
  1093. X        group "ispinusr@indy1" is the first step in the implementation of 
  1094. X        this distribution facility. If you have any questions, please
  1095. X        feel free to contact Kevin Fannin.
  1096. X        
  1097. X
  1098. X
  1099. X
  1100. X                               Larry Bartz
  1101. X
  1102. X
  1103. END_OF_FILE
  1104. if test 8273 -ne `wc -c <'ISPIN/doc/OLD-DOCS/README.rel_1.2'`; then
  1105.     echo shar: \"'ISPIN/doc/OLD-DOCS/README.rel_1.2'\" unpacked with wrong size!
  1106. fi
  1107. # end of 'ISPIN/doc/OLD-DOCS/README.rel_1.2'
  1108. fi
  1109. echo shar: End of archive 12 \(of 15\).
  1110. cp /dev/null ark12isdone
  1111. MISSING=""
  1112. for I in 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 ; do
  1113.     if test ! -f ark${I}isdone ; then
  1114.     MISSING="${MISSING} ${I}"
  1115.     fi
  1116. done
  1117. if test "${MISSING}" = "" ; then
  1118.     echo You have unpacked all 15 archives.
  1119.     rm -f ark[1-9]isdone ark[1-9][0-9]isdone
  1120. else
  1121.     echo You still need to unpack the following archives:
  1122.     echo "        " ${MISSING}
  1123. fi
  1124. ##  End of shell archive.
  1125. exit 0
  1126.  
  1127.