UD3 DOC 8507241535 8507241535îè/—occur at arbitrary places (eg., in the middle of a paragraph of text). So it is recommended that you use the dot commandæferent name for the destination topic or give it a drive prefix so that the new topic will be on a different drive from tH@€ ! B€ J ¡   @€ Nal on the console. You are prompted for the CP/M file name. Then, you control the display with the following single keyåMAS. This program shows the old drive search path and prompts you for a new one. You enter the drive letters without sp(( €€@!  @ %€@!€@ P €€@ €€@H  ÀB@ €€@ •€@@ ¥€B@ (!€ J…€  BK€¡@R@   @ €H€@  €-–st recent traverse resulted in dropping to a new lower level. A good example of using the TRAVERSE command is in the OUT”ered into the specified destination leaf until the leaf overflows or one of the structuring commands is executed (see belã€@@ @ (  J€K B   €H€ WThis branch of the MISC UTILITIES topic contains jex leafs that configure KAMAS better for specific systems. Some of theis available to KAMAS by mounting it. Or you can edit it directly from the Outline Editor. n. Zey are all aimed at programmers. DEBUG MDUMP JEXBRANCH DEBUG, MDUMP, and JEXBRANCH are documented in the KAMAS User'’The CP/M FILE I/O package is an extension to the KAMAS programming language. It provides commands that programmers can uáThe MISC UTILITIES topic on Utiltiy Disk 3 contains various KAMAS programs that are aimed at programmers and others who wBThe Utilities topic on this Utility Disk 3 is meant to replace the older one available on Utility Disk 1. Basically, thi‘at you have adequate free space on the destination disk. You can find out the free space using the TS (topic status) fun!(ˆ€À@ !  @ %€B@!@ P$€B!€@(B €€H!ÀB@ $€@(A„¾CP/M FILE I/O UGDE - File Variables and how to program with themŠñõ…Fwß@ @ @¡€@@  J„€@ BK ¡R@ „ !@$ H€„  ˆ€@name) at the same hierarchy level (or one level down if the top leaf overflows). As the outside text is read in, FINPUTJ€H@ ¡€@  J€@ FBK €R@  PB „H@€ 4€ãsseparately when you request it, the UTILITIES topic must always be available to KAMAS if you choose to use the utilities.(( €À@!0 „ %@ €H€@ PBJ€@@ €ÀH  !…À@` €€€zÝlk¼-w FLASHCARDSGUGUGE - Learn content of a topic by Flashcarding $j#… !!af write the program for your job. >€@@ €@ ($„ J%€@K€€€À@ @ €€€H€ @Žstems. These AUTOJEX leafs automatically load the AUX ROVE menu if the UTILTIIES topic is available and most contain reaä up a topic called BBSMESSAGES and that you have inserted a stem called WELCOME in the BBSMESSAGES topic. It also assumes=f jobs is listed as the AUX ROVE menu. To run one of the Jobs, you type J followed by the number of the item followed byUTOJEX to init the printer. SETDATE contains a program that is developed in Chapter 10 of the KAMAS User's Guide. It coÛdestination branch. In the case of any duplicate keys (which will always occur when copying within the same topic) you acopied intact. This program is adapted from one originally written by KAMAS user Tom Almy on Utility Disk 1. Üontains SYSTOPIC. For example, if your drive array is AB, then drive A must contain SYSTOPIC. In other words, SYSTOPIC <taining: 2 blank lines, Header line, 3 blank lines (2) Print lines: 54 of them (3) Footer containing: 3 blank lines, Foot&e prompted for the topic to search and for the partial key. Each matching candidate is displayed and you can type Y to sA+%ÖE hCONFIG UTILITIES UG - System Configuration UtilitiesŠ:4…);This branch contains documentation for programmers who may want to use the primitive commands supplied in the UTILITIES tŠarchy. Use it when you are done inputting sibling stems on the same level. Any subsequent text gets appended to the steÙably continue to distribute future versions of the UTILITIES topic on Utility Disk 3. No install of this Utilities-4 is :leaf copying in Issue 4 of The KAMAS Report ("Strategies for Loading AUX ROVE, Suggestion 2"). On page 4-12, Steps 8 thru&rompt, type G (GO) J (JEX) and KAMAS will load and run the BBS program. ØCLOSE Closes the file opened in the file variable, eg: CLOSE MYFILE READ Reads a specified random record, eg: 4 READ M¿FLASHCARDS is simple and self-explanatory--run it and see! Its for learning the content of your topics. I sure wish I hˆr System Disk onto a temporary work disk. Place this temporary disk in drive B: and run KAMAS (with its new 8K SYSTOPIC)A1ŒšÅUD3 DOC - Documentation Topic for KAMAS Utility Disk 3ˆ3+…$5‡ary parameters. When you are asked for the page size, this is the number of lines that KAMAS prints before it prints the4/8 which follows. The stem key is given in the command, truncated if greater than 31 characters. If the stem key is not u7 into your outside text file and thus instruct FINPUTJOB as to how you want the text structured. If none of these dot co9† this branch for more detail on each job in the menu. Incidentally, since the KAMAS menu mode is used, you can easily adA1× file to display. The program will properly display Wordstar document files. This program is a model example of the useE6nd is separated from the key with a backslash (\). The ..ID must always start at the beginning of a text line and a space… must separate the ..ID and the start of the key. The \ character is used only if you want a subtitle, in which case theÔmmands are used, then FINPUTJOB will create its own titles and insert their stems as brothers on the same level in the ou5nique, the program will request a new key. An optional subtitle (which will be truncated to 63 characters) is allowed, aA3˜¼è MAKE 8K SYSTOPIC UG - Resize factory SYSTOPIC to a much smaller one ƒ*2…$E 11 describe copying a stem manually from one topic to another. Aopic. The TOPIC PRIMITIVES leaf contains low-level commands to access the formatting marks on the current stem and the lƒer line, 2 blank lines PRINTJOB will center the footer line and will print the page number at the right end of the Heade3 the RETURN key. The job will then be loaded and run. It will prompt you for any needed parameters. See the content of(( €€€@!0„P%B@D €@€@ PB!€€B  „!À@`€@ ÑRESIZEJOB lets you copy an entire topic and change its size. It can be used to make a topic larger or smaller than it cu2OB scans it looking for 3 different structuring commands. You can use your word processor to insert these 'dot' commands`4Õogical record number of the current stem. The TREE TRAVERSE leaf contains a command that is a universal tree traverse prCÐs one is faster to load and presents a menu that is easier to use than the one on Utility Disk 1. Each job is loaded sepADB|ID¼‚ FINPUTJOB UG UGE - How to Read CP/M text into KAMAS topics +!…FAWCCë€FINPUTJOB UG 2GE - The 'dot' structuring commands +!…FA5Œ&/“MISC UTILITIES UG - How to Use the MISC UTILITIES topic on UD3 2<"…FG0PRINTJOB allows you to print out a topic branch with headers, footers, and page numbers. You are prompted for the necessANF˜l¼Ï½ FDUMPJOB UGUGUGE - Interactively Dump files in Hexidecimal S)!…F  €À@!  !€€!€@  €€ À@@ €€@€AJCr¼F PRINTJOB UGG UGE - Print an Outline with Headers, Footers, and Page numbers V+!…KI1S IS THE KEY\ - This is the subtitle The ..ID drops down a level in the hierarchy and creates a new stem containing textLJÎng the size, allow at least 2% of the space extra for elbow room. For example if you are resizing a 100K topic that is 6OK4FLISTJOB displays a CP/M text file on the screen without leaving KAMAS. You are prompted for CP/M file name for the text)À@!0P % € PB€B €@H!À@H €@€PG commands: N next sector P previous sector G goto an absolute sector F change files F and G both prompt for parametRL~upplied SYSTOPIC. In fact, the reduced size SYSTOPIC retains only the AUTOJEX leaf from the factory SYSTOPIC. Ofcourse,QN.ing them from a copy of the factory SYSTOPIC. You can get the copy by PIPing the file SYSTOPIC.TOP from your KAMAS MastePÌles are maintained. The DEPTH variable counts the current traversal depth. The UPCOUNT variable maintains the number ofnO} To use the CP/M FILE I/O package in your program, Jex it in with the following command: "CP/M FILE I/O" KJEX (This aË, console, or CP/M text file. You are prompted for what you want to output, where you want the output to go, and whether,e using the file variable eg: 'B:OLDFILE.TXT OPEN MYFILE --Also sets the ?OPEN flag if file was found and opened {In the UTILITIES topic, the Utility Jobs branch contains the programs for the AUX ROVE utility jobs menu. The main itemsÒves the FCB address FOR gives the buffer address, eg: FOR MYFILE MAKE Makes a new file using the file variable eg:ZD€se jex leafs are machine specific, but can be modified to accomodate different systems. They are: CUSTOM AUTOJEX LEAFS ( €€@! @ %€@€D €B P H€ €€H € À@@ @*E ESC HELP Help Screen for the Outline Editor ESC options You can find more details on how to do this kind of manual W`s Guide and were formerly in SYSTOPIC (prior to KAMAS V. 1.2). DEBUG shows the stack activity while a program is runningÊns earlier than KAMAS 1.2. This command also clears the current context (i.e., like TN in ROVE mode only without a promp)e Utilities topic will continue to evolve, and we thank all those KAMAS users who sent us in contributions. We will probxh that contains code to initialize printers. The example one supplied is for the Panasonic 1092 (PANASONIC 1092). You cÇ @@ ¡€@ ( @ € J€,BBK€ R!  @ @€€@€„@ (formed instead. This command is otherwise identical to the ..ID command. ..GU This command goes up a level in the hierAÚ. MDUMP displays memory on the screen. JEXBRANCH jexes in all the leafs in a branch starting at the lowest level and baTJOB was adapted from programs largely written and contributed by KAMAS fan Thomas Almy. Thanks again, Tom! "(€€À@ !0@@P %€B@€D!€J€@ P @(@  €@H!¡À@` $€€@(vtination topic to hold the branch you are copying. A good rule of thumb is to assume 1 to 2K per title especially if youohis software is released into the Public Domain provided it is not sold for profit. quCOPYJOB lets you copy a branch of text from one place in a KAMAS topic to another place in the same or another topic. YoÄCP/M files, you use file variables created by the :FILE command. This defining command defines such file variables, For %KEYFINDJOB is a program that allows you to search for a stem in a single topic by specifying only a partial key. You art€@ A €@@ €„ J€@ BJ€¡ R@ @ @  €H„€@  ˆkÃUTJOB is a modified version of a program originally written by Thomas Almy. Modified by A.Trent to use the general CP/M $e 66 lines per page (8 1/2 inch by 11 inch paper) then a pagesize of 60 will allow the following spacing: (1) Header conAlizȼg KEYFINDJOB UGUGE - Find a Stem using a Partial KeyŠQ+!…FAkGz¼L FLISTJOB UGUGUGE - List an ASCII CP/M text file to the console $+!…F#l operations. You should not run this job unless the first drive specified in your drive search path is the drive that csRe phone lines. RKAMAS can be used as a message system or bulletin board system (BBS) that allows users to dial in and cld+MAS, KAYPRO, just type G (GO) K (KEY) at the ROVE prompt and answer with RKAMAS, KAYPRO for the key. Then, at the ROVE p" have enough space, the program will abend (TOODENSE) when it runs out of space. All the stems up to that point will be eenter a new date and time and sets the KAMAS time stamps accordingly. AI¼ÍÆ OUTPUTJOB UG UGE - Output Outline to Printer, File, or Consoleˆ+!…Fn (( €Â@`!0 @@ %€BD €H@ P€B ! @ €H ¡À@@ €@€!u are prompted for the top key in the branch that you wish to copy (the source branch) and for the destination topic and pr leafs are about full. The unused space in the destination topic is shown by the TC command in ROVE mode. If you don'ty €  €K €  @ €€@€ € an adapt it for your own printer. Consult your printer manual for the necessary details. You can add a Jex of in your Aß( €€@  € @ € …€B@ €€€ Alk¼-w FLASHCARDS UGUGE - Learn content of a topic by Flashcarding $j#… !! in that branch are jobs that you access and Jex via the KAMAS menu mode. After you type U at the ROVE prompt, a set oAÈC¼e‹ COPYJOB UGUG UGE - Copy a Topic Branch to the same or other topicŠ!)…Fssumes that the UTILITIES topic is mounted). See FLISTJOB or FDUMPJOB as model examples of how to use the package. m you should only run this Job using your KAMAS Working System Disk. NEVER use your KAMAS Master System Disk for any normaers as needed, i.e., filename and sector number.  PRINTER INIT SETDATE CUSTOM AUTOJEX LEAFS is a branch that contains AUTOJEX leafs that are customized for specific sy~assify messages by subject matter. The RKAMAS included in the UTILITIES topic (RKAMAS, KAYPRO) assumes that you have set»FINPUTJOB lets you read outside CP/M ASCII text files into KAMAS topic files. You are prompted for the destination topic,r line. Before running this job, be sure your printer has the paper aligned to the top of form. A¼Œ'´PROGRAMMER'S GUIDE - How to Use the Programming Packages in UTILITIES &^w…$Eº \ character separates the key from the subtitle. A space is not required before or after the \. ..IN key ..IN key\subd your own jobs to the Utility Jobs menu. Just insert a new title for your job as a child of UTILITY JOBS, and in the lej footer, issues a formfeed, and prints the header. The header and footer always take six print lines each. So if you hav¹ from drive A:. Then, you may want to manually copy the following stems into your 8K SYSTOPIC (There is enough room for im at the new next higher level. Typically, this command is immediately followed by a ..IN or another ..GU command. FINP€H @ €@ (  J„€@ FBK€ ÀR@  @$@¡H€@ 4€AE¼/^OPERATOR'S GUIDE - How to Use the UTILITIES topic on Utility Disk 3ˆak'… FŽ‹¸elect that candidate or N to reject it. If you select a candidate, the program ends, you are returned to ROVE mode with ·l-time clock routines for specific computers. You can substitute one of these for the factory supplied AUTOJEX leaf if y ( €Â@!PP %€‚B€ €H€@ P‚B¡ B  €PJ )À@`  ” Œqntains examples of error checking and other programming techniques in the KAMAS programming language. It prompts you to ction in ROVE mode. fse to create and access CP/M files. The I/O provided is random I/O by logical sector. To build programs that work with ¶€¡€@ (  J€ B €¡   €H€ ˆow). If a leaf reaches maximum capacity, a new leaf is created with a synthesized title (constructed from the CP/M file *( € À@! „@ %„B@€ €À P H!¥B¨€€PH !À@H ‰€@(„ PUT LOOP program in the UTILITIES topic. ¿s. A™9G¼Éâ SETDRIVES UGGUGE - Set the KAMAS Drive Search PathŠc)„Fœ˜³ KAMAS.COM files. The first drive that you specify becomes the new KAMAS default drive. This drive is assumed as the thdThe contents of this topic file are Copyright (c) 1985 by KAMASOFT, Inc., POB 5549, ALOHA, OR 97007 (503) 649-3765. Tµlso contains jex leafs that are documented in the KAMAS User's Guide. They used to be included in SYSTOPIC but were remo™oted for other computers by redefining the NOCARRIER? command, the SETBAUD command, and the INITSIO command. To start RKAc You will have to estimate the size of the source branch so you can be sure that you have enough unused space in the des²ble to KAMAS when you run KAMAS. If you have room, just copy the UTILITIE.TOP file onto your KAMAS Working System Disk. A¤ @0 P€ J€P FBK€¡ @ @ @ €€ €b€H@¡€@ ( € B…€ !@,FBK ¡RB € @ €¡PH€€B@ 5€±test Version of the Utilities topic (v. 4) is also meant to accompany Version 1.2 of KAMAS. Utilities-4 works with oldercopying, so it can take a long time to run depending on the sizes of the topics. Before running this program, be sure thact to output to an outside CP/M text file, you can additionally opt to have that file be a WordStar document file. OUTPU°ROVE, it will still be loaded and if you try to do any utility jobs by typing U, the UTILITIES topic will be re-mounted a(€@!   $€ €€ €!€$@ €€@!À@H €¯haracters IFNOTSO command structure string case command structure NZDUPD non-zero dup double stack operation WO! fact (  À@ !1 P€P ¥€B@D!€”@B T %€!€(@¡ €H”B!À@@  …€@ _e previous stem. If an attempt is made to create a new stem next to the top level of the hierarchy, a ..ID command is per®edit the leaf of your choice from the CUSTOM AUTOJEX LEAFS branch and copy it to the swap buffer (with the ESC C option). (€€À@ !0B %€@€ € P@ !€@@ €€H !À@@ €@(u can then always access the Utilities Menu by simply pressing the U key at the ROVE prompt. Because each job is loaded ­ removed from the most recent version. All of these commands are useful for programmers and are useful models of extending the KAMAS language. The branch below LANGUAGE EXTENSIONS contains several larger programs to extend the language. Th] Finally, go to the empty AUTOJEX leaf in SYSTOPIC and yank back the leaf that you just copied. PRINTER INIT is a branc¬orial command These commands are documented in the KAMAS User's Guide. They were in older versions of SYSTOPIC but were utomatically. Exercise caution in running this command. The drive search path must include the drive that SYSTOPIC is o\ versions of KAMAS for the most part--it's just that Utilities-4 has some utilities that ONLY work with KAMAS v. 1.2. Th« Then, when you invoke version 1.2 of KAMAS from CP/M, KAMAS will find the UTILITIES topic and automatically load it. Yoµ[e drive prefix for CP/M file names and topic names unless you specify otherwise. This command does NOT work with versioª@ ¤€@  J…€ BK €R@  @ @  €B@€ €¶³ ved to free up valuable space. They are now available here (on UD3). To use the MISC UTILITIES topic just make sure it µ (À@ !  @@ %€€@D @ P€!€@ @  €PH€!…À@` €@©ou find one for your machine. Use the leaf editor to delete the factory supplied AUTOJEX (ESC W and then ESC Q). Then, your topic cursor on the candidate that you selected. Ythem): EDIT HELP Help Screen for the Leaf Editor OUTLINE HELP Help Screen for the Outline Editor OUTLIN¨title For example, ..IN NEWKEY\: a subtitle about NEWKEY The ..IN creates a new stem at the same hierarchy level as th the destination topic branch name (where insertion begins), and for the name of the CP/M text file. The text will be entA½„rŒUÝUTILITY JOBS UGE - How to use the Jobs in the UTILITY JOBS MenuˆC+!„F¾¼X€@¤€  B@€K @@   H€€ €½§€H(€ ¥ P (!@ J€€ $K  PR@  !@ €H A€ - €—ad had this simple tool when I was in college. Just sit back, tap the spacebar, and learn. -- A.T. ¦The LANGUAGE EXTENSIONS leaf contains some short commands to extend the language: range commands for strings and word cFILE I/O package. VExample: 'MYFILE :FILE Such a file object (in the previous eg, MYFILE) obeys the following modifiers: No modifier gi¥@€@ ( € B@@ J €P €@€@€@ €@@ €@ (  J…€$BK  @  @$ €@€ €È (€À@ ¡0T€B%€@!€H@ P ‚!@  €€H )…À@` €BAÊÇk|¼? RESIZEJOB UG UGE - Copy and Resize a TopicŽ"…FSETDRIVES allows you to temporarily change the KAMAS drive search path that was permanently set during installation of KAÒȤt for changing disks.) The only topic mounted when you finish this command is SYSTOPIC. However, if you had loaded AUX £ you wnat things like Section numbers and leafs printed. You can elect to print only titles without leafs. When you ele levels traversed when going from a lower to a higher level. The ?DOWN variable is a flag variable that is set if the moÎSOUTPUTJOB is a general KAMAS output utility that lets you direct different kinds of formatted topic output to the printerÏÍ¢0% full, use 64K instead of just 60K for the destination size. This program exhaustively re-indexes the text that it is ÞÎFDUMPJOB is for programmers and for the curious. It lets you interactively display sectors of any CP/M file in hexadecim¡arately so that the loading time is more evenly distributed and doesn't take so long when you first start KAMAS. This larrently is. RESIZEJOB prompts for the source topic name, the destination topic name, and the new size. Either use a difÊT 'B:NEWFILE.TXT MAKE MYFILE Any pre-existing file of the specified name is overwritten. OPEN Opens an existing filge 4-12, Steps 8 thru 11 describe copying a stem manually from one topic to another. tline. In this latter case, the outside text is read into leafs until they overlfow and title-boundaries will generally Qogram for KAMAS topics. It is similar to the GF command already provided in the langauge except that three status variabAÚÞ&EÀŸLANGUAGE EXTENSIONS UG - Jex leafs to extend the KAMAS languageŒ%*S„F of the CP/M FILE I/O package for programmers. RYFILE --Also sets the ?EOF flag if no such record in file WRITE Writes a specified random record, eg: 0 WRITE MYFILE žrequired (an install was required with Utility Disk 1). You need only make sure that the new UTILITIE.TOP file is availaçÖcking up to the higher levels. Üre prompted for a new key name. This program assumes that the destination topic exists. It does not create a new topic.äÛPmust be on the current KAMAS default drive. You can restore some of the help screens back into the 8K SYSTOPIC by copyM€@$€B (  J…€,K PB @€€H€@ €AÏÖEàç RKAMAS UGEXTENSIONS UG - How to Run an RKAMAS programŽR*…Fy(( €€@ !°P $€@ %„‚@!€@@ P BH¡€@$@ €€@H€!À@@ €†@nAn RKAMAS (remote KAMAS) is a program that allows you to function the ROVE mode of KAMAS remotely through a modem over th›ant to configure KAMAS more closely to unique aspects of their system (eg., printers and real time clocks). This topic aê H@ ¡€@ (  J@€P K€ R@  @!€H€@@ € (À@! P €@ € P€@ €H$!…À@@ …@€ Üí that you have properly hooked up a Hayes Compatible modem to the modem RS232 port of your computer. See issue #3 of theéaces or commas or colons. Just use the letters. The new drive search path takes effect immediately. The change only laKhe source. It's a good idea to use a drive prefix even if you use a different name to avoid ambiguity. If you are reduciÚî€@  €B (  €!J!,FK€ "@ B €@‰€€ €ììMAKE 8K SYSTOPIC is a job that is most helpful for those who are cramped for space on floppy disk systems. It returns to™sts for the duration of the current session or until you run SETDRIVES again. The change is not saved permanently in the (!€À@ !0@@ %€B@!€@@ P € B ¤€@H€@!À@` €@(€JThe ascii text file may contain the following structuring commands: ..ID key ..ID key\subtitle For example, ..ID THIíèO ROVE when it is done. This job creates a new SYSTOPIC that does not contain the extensive help screens in the factory sîìœ KAMAS Report for more suggestions on how to set up and run an RKAMAS. RKAMAS, KAYPRO is for the Kaypro, but can be adapí((„€À@ !0PP %€B@D €@ P‚H!€€@ @ €H ¡À@@  @„