XEROX1108 Users Guide41SECTION 6INPUT OUTPUTInput Output on the Xerox 1108 is supported in many ways: keyboard, display, mouse, rigid disk,ethernet, floppy disk, and RS232. This section only covers aspects of the last two: floppy diskand RS232.6.1FLOPPY SUPPORTThis documentation describes the Interlisp-D file device {FLOPPY}, used to interact with floppydrives on Xerox 1108 machines. In general, Interlisp-D can be used to read, write, and otherwiseinteract with files on Pilot formatted floppy disks through standard Interlisp input/outputfunctions. All familiar operations such as LOAD, OPENFILE, READ, PRINT, READC,GETFILEINFO, SETFILEINFO, GETFILEPTR, SETFILEPTR, etc. work with file device {FLOPPY}.COPYFILE is commonly used to archive and unarchive files between {FLOPPY} and other filedevices. Files on {FLOPPY} can be compiled, edited, hardcopied, etc,. just as files may be on allother ordinary file devices.The user should be aware that the occurrence of certain events (i.e., opening the floppy drivedoor, performing a (LOGOUT), etc.) while a {FLOPPY} stream is open can result in the files onthe floppy being inaccessible. Recovery techniques are available which attempt to repair suchdamage. See FLOPPY.RESTART and FLOPPY.SCAVENGE described below. (OPENP) can beused to determine if any files are currently open for input or output; (CLOSEALL) will close allopen files except T and the current typescript file, if any, and return a list of the files closed. SeeSection 6.1 of the Interlisp Reference Manual for more information on file manipulationfunctions. The following functions and capabilities are supported in the current software release. (FLOPPY.FORMAT NAME AUTOCONFIRMFLG SLOWFLG)[Function]This function is used to erase and establish track information on floppies, especially floppieswhich are brand new. The NAME arg becomes the name of your floppy. It's a good idea to labelthe outside of your floppies with the same NAME. AUTOCONFIRMFLG controls questioning theuser about destroying floppies that appear to contain valid information. If AUTOCONFIRMFLG isT, the user will not be asked to confirm. SLOWFLG determines how thorough a formatting job isto be done on the floppy you format. If SLOWFLG is T, FLOPPY.FORMAT will completely eraseyour floppy, setting down track information and critical Pilot records on your floppy. WhenSLOWFLG is left NIL, only Pilot records needed to give your floppy an empty directory arewritten. Use SLOWFLG = T with brand new floppies. Your floppies should always be 8" doubleÿîgïdõpôXqî@†pîgïd*þ?dFî*jï)pî(;ï]ßsî&¦ï[«îgïV(pô… ô†ðLîgïSôô¨ðVîgïQÀô€îgïMäsîüspsîgïJpô™ôšð?îgïGÔô†ð?ô‡îgïE ôô ð5îgïCl ôgðDîgïA8ô ô¡ð=îgï?ô©ôªð?îgï<ÐôðOô‚ îgï:œô€îgï6Àô¤ðNô¥îgï4Œô”ðHô•îgï2Xô¬ð=ôîgï0$ôÈð@ôÉîgï-ðô ð\îgï+¼ô€ôðLîgï)ˆôátpôâð&îgï'T ô€îgï#xðXîgïœspupu pusîDìp îgïÀôºô»ðOîgïŒô†ô‡ð;îgïXôœ ôðJîgï$ôðDôîgïðôˆðTô‰îgï¼ô”ô•ðTîgïˆôØðJôÙîgïTôËôÌð@îgï ôôðB ìTVk( XEROX1108 Users Guide42sided/double density soft sectored floppy disks. Floppies are inserted into the floppy drive faceup, the edge of the floppy with two 2" long cover holes (one hole per side) going in first. Thewriteprotect notch will be on the same edge as and to the left of a cover hole as you look downon the floppy from above. If you attempt to write on an unformatted floppy a break will occurand the mesage "Floppy: Not a Pilot Floppy" will appear in the Prompt Window. (FLOPPY.SET.NAME NAME)[Function]This function resets the NAME put onto a floppy by FLOPPY.FORMAT. (FLOPPY.GET.NAME)[ Function]This function returns the NAME put onto a floppy by FLOPPY.FORMAT or FLOPPY.SET.NAME. (FLOPPY.CAN.READP) [Function]This predicates tests if there is a floppy in the floppy drive. FLOPPY.CAN.READP does notprotect against not fully closing the floppy drive door. You may wish to useFLOPPY.WAIT.FOR.FLOPPY (see below).(FLOPPY.CAN.WRITEP)[Function] This predicates tests if there is a write-enabled floppy in the floppy drive. It does not checkwhether the floppy has been properly formatted. (The floppy drive can only write on floppieswhose writeprotect notches are covered with tape.)(FLOPPY.WAIT.FOR.FLOPPY NEWFLG)[Function]When NEWFLG = NIL, this command waits until there is a floppy in the floppy drive beforereturning. When NEWFLG = T, the function first waits until the existing floppy in the floppydrive, if any, is removed, and then waits for a floppy to be inserted into the drive beforereturning. (SYSOUT '{FLOPPY})[Function]SYOUTs may be created on floppies with the Interlisp SYSOUT function, and later installed onthe same or other Xerox 1108s by using the "Installation Utility" floppy distributed with yoursoftware set. SYSOUTs may also be taken from other file devices and be put onto floppiesthrough the use of the function FLOPPY.MODE (see below). The user is prompted to insert newfloppies as they are needed. It will generally take 3 to 5 floppies to store a sysout. The floppiesare automatically formatted and named appropriately. Presently the logical names of the sysoutfloppies must be "LispSysout#1". "LispSysout#2", etc. See Section 3 for a description of theÿîgïdõpôXõqî@†pîgïd*þ?dFî*jï)pîgï]ßô˜ô™ðMîgï[«ôžôŸðLîgïYwôˆô‰ð9îgïWCô¨ð)ô©ð2îgïUô€ðKîgïQ3spusîDìp îgïMWðBîgïI{sîDlp îgïEŸðVîgïAÃspîDì îgï=çôÑðQôÒîgï;³ô™ð+ôšîgï9ô€îgï5£sîDìp îgï1Çô¿ðIôÀîgï/“ô¹ôºðFîgï-_ô€ð-îgï)ƒspusîDìp îgï%§ô¼ðMô½îgï#s ô¾ô¿ðMîgï!?ôÞðUîgï ô€îgï/sîDìp îgïSô¡ô¢ð6îgïô¾ô¿ðVîgïëôÊð/ôËð!îgï·ôŒôðPîgïƒô”ð[îgïOô›ôœðCîgï ô—ð9ô˜’TVk(ú XEROX1108 Users Guide43procedure for installing software from floppies. Note that when you return from this functionFLOPPY.MODE is set to SYSOUT. You must use (FLOPPY.MODE 'PILOT) to restore the normalmode of operation for {FLOPPY}. Note: before writing a sysout to unformatted floppies, or tofloppies of suspicious origin, do (FLOPPY.FORMAT NIL NIL T) to ensure the formatting iscomplete and correct.( FLOPPY.MODE MODE) [Function]The normal mode of operation for {FLOPPY} is to be (FLOPPY.MODE 'PILOT). Two otherspecial modes of operation for {FLOPPY}, SYSOUT and HUGEPILOT, are available. In SYSOUTmode, the user may use COPYFILE to move a sysout off another file device onto floppies. To dothis, the user must first set {FLOPPY} into SYSOUT mode, then do the COPYFILE. For example,(FLOPPY.MODE 'SYSOUT)(COPYFILE '{PHYLUM}CURRENT>FULL.SYSOUT '{FLOPPY})would put the current Interlisp-D FULL.SYSOUT onto floppies. The Installation Utility is thenused to load these sysouts onto a Xerox 1108. Similarly, sysouts can be copied off floppies ontoanother file device using COPYFILE when in SYSOUT mode. It is possible to write and read Pilot huge files across multiple floppies in HUGEPILOT mode(FLOPPY.MODE 'HUGEPILOT). This mode is practically identical to SYSOUT mode, with theexception that the user has control over the names of file and floppies. (FLOPPY.TO.FILE TOFILE) & (FLOPPY.FROM.FILE FROMFILE)These two functions support the ability to copy Pilot floppies. FLOPPY.TO.FILE copies thecontents of the current floppy to a file and FLOPPY.FROM.FILE is FLOPPY.TO.FILE's inverse.Typically, you may insert a floppy into the floppy drive, use FLOPPY.TO.FILE to move thecontents of the floppy to a file (on a file server or some logical volume of your machine with2500 free pages), remove your floppy, insert a blank floppy, and use FLOPPY.FROM.FILE tomove the contents of the file onto the blank floppy. The new floppy will automatically beformatted and given the same name as the original floppy. FLOPPY.FROM.FILE can be usedmore than once if you would like to make more than one copy. As an alternative to usingFLOPPY.SCAVENGE (described below), the TOFILE produced by FLOPPY.TO.FILE can beusefully edited to salvage the contents of a floppy that has been damaged.(FLOPPY.FREE.PAGES) [Function]This function returns the number of unallocated free pages on the current floppy. Pilot floppyfiles are contiguously represented on floppy disks. If you are going to use your floppyîgïdõpôXõqî@†pîgïd*þ?dFî*jï)pîgï]ßôÂðFôÃ îgï[« ô•ð4ô–îgïYwô°ð<ô±îgïWCôáð6ôâîgïUô€îgïQ3spuspîDì îgïMWôÝðOîgïK#ôð!ô‘ð/îgïHïô†ðCô‡îgïF»ô€ðVîCïCùîCïA7ð7îgï=[ôËðSôÌîgï;'ôˆô‰ðAîgï8óô€ð1îgï5ô¹ð/ôºð+îgï2ãôÌôÍð2îgï0¯ô€ð@îgï,Óspuspspu pîgï(÷ôá ôâðFîgï&Ãô¯ô°ð7îgï$ ôÞðJôßîgï"[ôð*ô®ð,îgï 'ôÂð0ôÃð$îgïóôãôäðEîgï¿ô¼ðAô½îgï‹ôÌ ôÍðIîgïWôú ôûð5îgï#ô€ðBîgïGsîDlp îgï kô¬ð9ôð!îgï7ô ð9ô ¼TVk( XEROX1108 Users Guide44interactively (you are not just doing a simple series of COPYFILEs after a FLOPPY.FORMAT), itis suggested you do not fill the floppy to capacity. Try to keep such a floppy < 75% full. (FLOPPY.COMPACT) [Function]If your floppy is stable--there are no extant {FLOPPY} streams--FLOPPY.COMPACT may be usedto compact your floppy, moving files toward the front of your floppy so that all free blocks onyour floppy can be combined into one free block. (A compactor that works well when there areopen {FLOPPY} streams is in the pipeline.) (FLOPPY.SCAVENGE) [Function]This function attempts to repair a floppy whose critical records have become confused. (FLOPPY.RESTART) [Function] A last resort to try to restart {FLOPPY} if you think {FLOPPY} is smashed. FLOPPY.RESTARTwill recreate all {FLOPPY} internal globals. Be warned that any outstanding {FLOPPY} streamswill be lost if you do (FLOPPY.RESTART). Try switching floppies or opening and then closingthe floppy drive door first. ÿîgïdõpôXõqî@†pîgïd*þ?dFî*jï)pîgï]ßô˜ð+ô™ð%îgï[«ô€ðYîgïWÏspîDì îgïSóô‚ðXîgïQ¿ô¥ô¦ðUîgïO‹ô”ðNô• îgïMWô€ð'îgïI{spîDì îgïEŸðWîgïAÃspîDì îgï=çô¡ðXîgï;³ô™ôšðKîgï9ô¬ôðTîgï7Kô€êTVk( XEROX1108 Users Guide456.2RS232 SUPPORTThis section describes techniques for connecting the Xerox 1108 via the PRINTER/DTB port.Xerox software supports a Chat facility and file transfer to any machine implementing the Modemprotocols.A special cable is required for the PRINTER/DTB port. The 1108 end requires a 25 pin D-shellmale connector with pins 9 and 22 broken off. Pins 4 and 8 must be shorted together. The otherend of the cable depends on the particular device: a Xerox 1100, a Xerox 1108, a modem, or anEpson FX-80 printer.Xerox 1108 to Xerox 1108 (or Modem)Pin 1 to Pin 1 (optional chassis ground)Pin 2 to Pin 3Pin 3 to Pin 2Pin 7 to Pin 7Pin 6 to Pin 20Pin 20 to Pin 6 Xerox 1108 to Xerox 1100, Epson FX-80 Printer, or dumb terminalEpson FX-80 end: 25 pin D-shell maleXerox 1100/dumb terminal end: 25 pin D-shell femalePin 1 to pin 1 (optional chassis ground)Pin 2 to pin 2Pin 3 to pin 3Pin 6 to pin 6Pin 7 to pin 7Pin 20 to pin 20 Testing the connectionTo test for a working RS232 connection between Machine A (a Xerox 1108) and Machine B (aXerox 1108 or a Xerox 1100), proceed as follows:(LOAD 'RS232CHAT.DCOM) on both machines.(RS232INIT 300 8 NIL 1) on both machines.ÿîgïdõpôXõqî@†pîgïd*þ?dFî*jï)pîgï]ßsîüô€îgïZpô¶ð0ô·ð%îgïWÏô€ôðAîgïU› îgïQ¿ô›ð.ôœð-îgïO‹ô„ô…ðKîgïMWô‡ôˆðEîgïK#ô€îgïGGsð#îCïD?pð(îCïB îCï?× îCï=£ îCï;oîCï9;îgï5_sð?îgï1ƒpð$îgï/Oð3îCï,ð(îCï*Y îCï(% îCï%ñ îCï#½ îCï!‰îgïsîgïÑpôžðSôŸîgïô€ð+î‰ïÁð(î‰ïð)¢TVk(² XEROX1108 Users Guide46(RS232CHAT) on both machines. This will prompt you to open a window on each system. Whatyou type on Machine A should be echoed on Machine B, and vice versa. ÿîgïdõpôXõqî@†pîgïd*þ?dFî*jï)pîgï]ß ô‚ðAôƒ îgï[«ô€ðBºTVk(.ÿ Helvetica ÿLogoÿ Helveticaÿ Helvetica ÿ Helvetica ÿ Helvetica ê îNÒÿÿj/ “0ÞÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿM69S6.BXknowlesJuly 2, 1984 8:22 AM