Appendix B. Programs available for the Run command79Appendix B. Programs available for the Run commandThe programs listed in this appendix are available for use with the Run command (section 3.6).These programs are supported by the Laurel group and are available on the directory onyour neighborhood file server.You may wish to keep these programs on your local disk, or you may retrieve them "on the fly"using the Run command. When programs have been retrieved in the latter manner, they arecopied to your disk and are left there even after you are finished with them. You may wish toinclude a RunPath: entry in your Laurel profile to make this process a little simpler (section 5).Many programs that run via the Run command use the composition region of Laurel as atypescript. This typescript is limited to 60,000 characters, i.e., only the last 60,000 characters areretained for any session. When you are finished with such a program, this typescript remains inthe composition region, where you may edit it, file it, deliver it, etc. Normally, this typescriptreplaces the previous contents of the composition region. It may be restored after the Run command isfinished by invoking U (CANCEL). If you begin another Run command immediately after finishing aRun command (no editing in between the two Run's), then the typescript (if any) for thesubsequent program is appended to the previous typescript (if any).Many of the programs listed here allow you to invoke other Laurel screen commands. Thecommands that are typically enabled are Copy in the lower menu and all commands in the upperand middle menus except for Quit and Hardcopy.Shifted selection is always available as an alternative to type-in. This makes acting on lengthyrequests contained in a received message considerably easier.In the modeless editor, the PASTE key reverts back to a LF key when the Run command is executing. It is restoredto a PASTE key when the Run command finishes.fpX(qpFf g^r2 gZCp$qp gXx#< gV gS<7& gQq qpG gOG gM<& gJjqp & gHH gFJ gE T gC@:sts gAu pqp& g?qp(qp% g=C g:nR g8(qp* g6qpqp g3ga g1= g.MsHts& g,ts g,=;eLAUREL MANUAL80B.1. ChatChat.laurel provides a teletype interface to servers that support the Telnet protocol. Chat.laurel issimilar to Chat.run, etc. in its effect, but it does not support the variety of commands available inthe other Chat programs. Chat.laurel interacts with you via a typescript in the composition regionof the Laurel screen.Starting and stopping ChatWhen you start Chat (by invoking the Run command with program name Chat), it greets youwith the lines:Laurel Chat of date(CTRL DEL closes connection and returns to Chat command level.)C(onnect to), L(ogin to), or Q(uit)?A blinking caret appears after the question mark, inviting you to begin your Chat session. At thispoint you are at Chat command level. Only the three characters C, L, or Q are valid inputs atthis level (upper or lower case does not matter).A "Q" typed at command level will terminate both the Chat program and the Run command.A "C" typed at command level will produce the prompt:Connect to host: with a blinking caret following the colon, inviting you to type the name of a server machine(terminated with a CR) to which you wish to connect. If you type a DEL character before the CR,then you will return to Chat command level. Once you have connected to the server machine, allinteractions are as defined by that server.An "L" typed at command level will produce the prompt:Login to host: with a blinking caret following the colon, inviting you to type the name of a server machine(terminated with a CR) to which you wish to connect. This command behaves identically to the"C" command, except that "L" also issues an automatic Login command to the server after theconnection is established. The name and password used for this Login command are the mostrecent ones entered via the User command (section 3.1.1), or the ones on your local disk if youhaven't used the User command yet in this Laurel session.Note: characters are only placed on the screen when they are echoed by the server to which youare connected. Most servers will not echo your password. Also, if the server is heavily loaded,there may be a slight delay between the time that you type characters and the time that they aredisplayed.$fpspXs gfp g^r gZCpE! gXx(= gVK gT gPWu gLpqp/ gK]H|u]Fp?]D$ gAuE g?up* g=1 g:nAqp g65]4^ g1#9 g/sp/spsp g.*[ g,_+ g(6]&O g##9 g!sp : g J gQ(2 gqp? gqp$ gJC g@! g T g  g# gE* gBI)2 g@~\ g>c g<[ g;F g7"> g5"sp< g4Lsp g2L8+ g0N g. g.p=9LAUREL MANUAL82B.2. MaintainMaintain.laurel is useful for interacting with Grapevine servers for various purposes includingchanging your password, updating public distribution lists, etc. The Maintain program is onlyuseful to you if you are in a registry served by Grapevine (currently only PA and ES, most otherswill be soon).This section is an abbreviated guide to the use of Maintain. It contains descriptions of thecommands needed by the casual user, i.e., a person who is not an owner of a list or a registry. Amore complete explanation of Maintain will appear in the near future. A thorough technicaldescription (not intended for casual users) of the facilities provided by Grapevine is contained inthe file [Ivy]Interface.press.Using MaintainWhen you start Maintain (by invoking the Run command with program name Maintain), it greetsyou with the lines:Grapevine Registration Server Maintenance ProgramVersion of dateLogin Name.registry ...GV:A blinking caret appears after the GV:, which is the command prompt, inviting you to type aMaintain command. If you type a question mark, a complete list of commands will be typed out,and the GV: prompt will be issued again. Most of these commands are quite technical; we willdeal with only a small subset of them here.To issue a command to Maintain, you must type only the initial letters that uniquely distinguishthat command from the others. As soon as enough of a command word (usually only one letter)has been typed, Maintain will complete that word for you. If you type any subsequent letters inthat word beyond the unique prefix, those letters will be used for the rest of the command, whichalmost always results in an error. In the list of commands that follow, the complete commandname will be given first, with the unique letters you should type to issue that command followingin parentheses.Most commands require names as arguments. Maintain will generally suggest a name for eachargument based on the names you have entered to previous commands. If the name is correct,just confirm it by typing a space or CR. Otherwise, type in the name (shifted selection works)and terminate with a space or CR (may be included in the shifted selection). All names given toMaintain must be fully qualified, i.e., they must include the registry extension.If you type a DEL character at any time during command input, that command will be cancelledand a new GV: prompt will be given.$fpspXs gfp g^r gZCp.1 gXx^ gVZ gT gQqK gOS gMF gL$? gJG# gEu gBIpqp/ g@~]=1]< u]:Kpupup]6 g3C-. g1y@ g/K g-+ g*rA g(P g&=# g%a g#GU g!}W g g@Z guF g$sp8 gsp- gQ g sp5 g# g]TVN]P H]O/!]MO7qp]K gH]Du p]B'4]A X]?A0']=v.&]; g89]4up6]28]125]/h+up ]-5ups]+Lts]*r@ g*O8=Appendix B. Programs available for the Run command85B.3. InsertMail.laurelInsertMail is a program that inserts the contents of the message composition region as a messageinto your current mail file. The message is inserted as is; unlike the Deliver command, no From:or Date: fields are added in this process. If you wish to include such fields in the inserted mail,you must edit them in yourself prior to running InsertMail. The T (COM-T) command is useful inpreparing a Date: field, should you wish to do so.InsertMail inserts the message after the last selected entry in the table-of-contents. If no messagesare selected in the table-of-contents, then the message is inserted at the beginning of the mail file,i.e., it becomes message number 1.When the message is inserted, the table-of-contents is reformatted, and the newly insertedmessage is selected and displayed. If the message as inserted does not conform to legal messageheader rules, or if some header fields are missing, then the table-of-contents display for that entrymay have some parts missing or filled in with question marks.InsertMail does not use the composition region for a typescript. It does its job, terminates, andleaves the text in the composition region as it was.Uses for InsertMailHave you ever wanted to annotate or otherwise edit a message in your mail file? The simple wayis to move that message into the composition region (Display the message, use E (COM-E), andreplace the contents of the composition region with a shifted selection of the entire messagedisplay region--use multi-clicks to select it.) Then, edit the message and Run InsertMail. If youhaven't moved the table-of-contents entry, then the new version will be inserted immediately afterthe original version. If you wish, you may select the original version and invoke Delete.To prepare a command file from which a shifted selection will be taken as input to some otherrunnable program, just prepare that command file in the composition region and InsertMail itinto your mail file. You may wish to prefix the command file message with a portion of amessage header, say the Date:, From:, and Subject: fields, to have that command file appearreasonably in the table-of-contents.To print text that you are preparing in the composition region, InsertMail it into your mail fileand invoke Hardcopy.fpX(qpFf g^r gZCpL gXxCqp gVQ gT<sp gS2 gOupB gMJ gL" gHG gFO gE R gC@= g?G g>4 g9wu g6pO g4: +qpsp g2pB g0Kqp g.3/ g-:qp g)./ g'> g& E g$>:! g"s$ gR g7 qp 2 gA blinking caret appears after the greater-than sign, inviting you to issue a Files command. The">" characters is the prompt character, and always indicates that Files is ready for anothercommand.When giving a command to Files, any unique prefix of that command may be typed (as in theAlto Executive). ESC command completion is not supported; typing an ESC will insert that (illegal) character inthe command. Terminate command lines with a CR.Typing CTRL-DEL will cancel commands in progress. This is particularly useful for interruptinglong typeout from the List or Type commands.Most commands allow a file pattern wherever a single filename would be acceptable. A filepattern is expressed using the # and * characters, meaning match exactly one and match zero ormore characters respectively, as in the Alto Executive. Files commandsCopy NewFile _ FilePattern FilePattern . . .The Copy command is similar to the Copy command in the Alto Executive. Thecontents of the old files to the right of the arrow will be concatenated and copied into thenew file mentioned to the left of the arrow.Delete FilePattern FilePattern . . .The Delete command is similar to the Delete command in the Alto Executive. TheDelete command requests confirmation for each file before it actually deletes that file. ACTRL-DEL to cancel the entire Delete command will not be acted on until after you finish confirming orcancelling the current file.FileStat FilePattern FilePattern . . .The FileStat command is similar to the FileStat command in the Alto Executive. Thelength and create, read, and write dates for each file specified are listed.$fpspXs gfp g^r gZCpK gXx gUqp0 gS<]Pu]Np]M gI\ gG+1 gF gBR g@sQ g> p!sp g;spC g9, g6KE g4&8 g29 g.*u g*pupu pu]'Fp8]%|C]#, g%u pu p]+$](2s]AG] g pu pu]p G] Lx g <[Appendix B. Programs available for the Run command87List FilePattern FilePattern . . .The List command is used to list all files on the local disk that match the patternsspecified. In the Alto Executive, this function is provided by the TAB character. TABused in this way is not supported in Files.laurel; use the List command instead. Thematching files are listed in the order in which they occur in your directory. Although theoutput may look alphabetized, that only reflects the periodic sorting done in the Altodirectory by the Alto Executive. You may find files out of alphabetical order near theend of your List command output.Rename OldFile NewFileThe Rename command is similar to the Rename command in the Alto Executive.QuitThe Quit command terminates the Files program and the Run command.Type FilePattern FilePattern . . .The Type command types the contents of the specified files one after the other, withoutpausing. Each file is preceded by a short length description. You may terminate itsoutput by typing CTRL-DEL.fpX(qpFf g_u pu][p<]Y0']XU]VD:!]TyV]R8]P gLXupu]Hp+ gDZ]@6qp g<\u pu]8p#4]7G ]5Usp g572LAUREL MANUAL88B.5. SearchMailThe SearchMail.laurel program will search through your entire current mail file, looking for textthat matches a pattern. The message number of any message in which a match is found will bedisplayed in the typescript, and that message is selected in the table-of-contents. WhenSearchMail is finished, it terminates the Run command, leaving in its typescript the messagenumbers of all messages that contain a match, and with all such messages selected.The patterns that are allowed are the same as those allowed by the Find command (section 4.4.5).Only one pattern is allowed per run of SearchMail; each subsequent run of SearchMail begins anew table-of-contents selection. You must terminate the pattern with an ESC character. Once thepattern is terminated, the search begins.After SearchMail is finished, you may operate on the set of matched messages in a variety ofways. You may invoke any of the commands in the middle menu to delete, move, or hardcopythe entire set. If the set of selected messages contains two or more messages, then the Displaycommand (section 3.2.1) will display each selected message in turn, without destroying the table-of-contents selection.SearchMail thus provides a rudimentary keyword search capability to Laurel. It is limited tosearching for only one pattern (no combinations of patterns are allowed), and it will search withinthe current mail file only.$fpspXs gfp g^r gZCp"? gXxE gV9 gT%qp/ gSR gOCqp gMI gLIsp gJG) gFY gE M gC@Xq gAupC g? g<8] g:nI g8 g8\=/Appendix B. Programs available for the Run command89B.6. MailFileScavengerIn the unlikely event that your mail file becomes damaged, there is a remedy in the form of theMailFileScavenger.laurel program that usually restores the internal structure of your mail file to areasonable state. It cannot deal with disk errors; use Scavenger.run first if you suspect disk errors. TheMailFileScavenger copies the damaged mail file into a new scratch file as it operates, thereforeyou must have slightly more free disk pages available for this scratch file than the number of diskpages that your damaged mail file occupies. The MailFileScavenger will warn you if there is not enoughroom.To run the MailFileScavenger, just invoke Run with the program name MailFileScavenger. TheMailFileScavenger will ask you to type the name of the mail file to be scavenged. Terminate thisname with a CR. If you type a name without a period, .mail will be added to the nameautomatically. MailFileScavenger will proceed to copy your mail into its scratch file (namedMailFileScavenger.scratch$). After each fifth message, MailFileScavenger will print out thatmessage number, just to let you know it is still working.When anomalies are detected in your mail file, MailFileScavenger will print out a short messagesuch as "Message 53: existing count was 231 bytes too small." These messages indicate that theformatting information present in the mail file that Laurel uses to distinguish individual messageswas inconsistent with what the MailFileScavenger believes to be distinct messages. When theMailFileScavenger is finished, it is a good idea to check any messages it complained about; thesemessages may be missing several characters or be malformed in other interesting ways. Youshould also check neighboring messages--some of the characters in those messages might really bepart of other messages.After the MailFileScavenger has finished copying (and reformatting) your mail into its scratchfile, it will pause and ask if it should copy that file back into the original mail file (Type CR or Yto confirm). If there have been few error reports, this may be done without any trepidation; theMailFileScavenger will do the copy, delete the scratch file, and terminate. You may at this pointinvoke Mail file on your mail file once again and gaze upon the damage. On the other hand, ifthere have been many error reports, you may wish to type a DEL character to deny the automaticcopy, and examine the MailFileScavenger.scratch$ mail file before performing the copy yourself.You may invoke Mail file on the MailFileScavenger.scratch$ file merely by typing (or SHIFT-selecting) that name into the Mail file brackets.The mail file that MailFileScavenger produces should always give you a readable mail file, i.e.,one that Laurel will not complain about. This mail file may have "messages" that are fragmentsof messages in the original file and/or duplicate messages. As long as Laurel will allow you toread that file, you may repair the damage with the Laurel editor and the InsertMail program(Appendix B.3). If the file produced by the MailFileScavenger is not readable by Laurel, pleasesend a message describing your difficulties to LaurelSupport.PA.fpX(qpFf g^r gZCpY gXxP gVs2"p gTF gS%> gQN-s3 gO gLXp6% gJ*7 gH sp2 gF;" gE-T gCc9 g?@ g>&>! g<\O g:0, g8C g60* g51 U g3g g/0. g.*-2sp g,_F g*P g(qp7 g'3sp g%50/ g#jqp'sp g!qp g.Z gc3, g;% gL gP g9@ g=S7LAUREL MANUAL90 $fpspXs gfp g_ g^ < TIMESROMAN  TIMESROMAN  TIMESROMAN  TIMESROMAN TIMESROMAN TIMESROMAN / P"$*/z3f7 @Bj/E C^laurel6-b.bravoBrotzJuly 23, 1981 11:24 AM