OFCONTENTS TABLE Programmer'sGuide FUNCTIONS l—lUser l—2 l—3Network l—4 1_9User l—122]TURBO-PLUSINSTALLATION Tables 2—l 2—2 2—4 TWX GEN+PAR A] FILELISTINGS

Texte intégral

(1)

(2) Turbo-Plus 1.3 Programmer's. I]. TABLE. OF. CONTENTS. Guide. FUNCTIONS User. Defined ............................................... Routing Calls Functions............................ Network Functions .................................... Local Functions ................................ Tables User Information ..N.....**.....¶....0...........P.. .............*..........&.. 2]. TURBO-PLUS. INSTALLATION. .................................. Files TWX ...........N.............................,.. Customizing. ................................0.. A]. GEN. +. PAR. FILE. LISTINGS. .................................. l—l l—2 l—3 l—4 1_9 l—12. 2—l 2—2 2—4. A-l. i.

(3) Turbo-Plus 1.3 programmer's. FUNCTIONS. Guide. Turbo-Plus makes extensive Cuse of the TurboDOS user defined function call, in which the register is set to 7fh or 29H, in TurboDOS versions l.2x and 1.30 respectively. Subfunctions are defined by the d and E registers. own user functions, but must not use any has reserved the hex Turbo-Plus. Turbo-Plus Thus, use through 7F in the e register. if you wish FFto hex convention, you should use values of 80 through you wish to use other registers as in the E register, and and the DE pair for parameters, you must function definitions, 7F. insure that the value in the e register is greater than when installing any such functions, you must use Furthermore, the public entrypoint USRFCI, rather than the usual USRFCN.. your install used by. You may parameters values 00 the same. if. l-l.

(4) FUNCTIONS. Turbo-Plus 1.3 Programner's Guide na!zL Note: E and. R!mjleg In. El. F!1r1ctick11Fp. this section, refers to the. User. riti1i"M bjt Eh. low. Defined Functions. T11rbQ-p1l1pl. refers to the hicM nibble of register nibble of reqister E.. Turbo-Plus utilizes a number of user-defined functions genned in These as an extension operating of the TurboDOS system. functions all maintain various tables in memory, containing logged onto the information about all of the users currently The tables are rnaintair.ed system. in each of the users and in the server. user-defined function in TurboDOS is always called with the C 7FH equal 29H, for TurboDOS version 1.2x or 1.30 register to or The B register respectively. determines how the call is to be as well routed over the network, and all OF the other registers, as parameters. as the DMA, the following In are available functi.on calls, the B register shoUd be set to O for all local calls, to OFF hex for all calls to the server, and as described on this page for calls in the bottom paragraph routed to remote users. The following function calls all refer to the tables described in above The 'local functions' refer to a nine byte the paragraph . The 'network functions' refer to table maintained on the user"n a 128 byte table of users one of five tables in the server: all currently logged on, a 128 byte table of data about those users, a the server's ID, an eight byte table nine byte table keeping holding data about the server, and an eight byte table holding the system user uptime. Note that the local table calls to the are compatible with the network calls to the server's table about himself, allowing the server to use the 'local calls' to himself without conflict. All of the tableA are outlined in the section following the description of the function calls. The. l-2.

(5) Turbo-plus 1.3 Programtier's Guide. FUNCTIONS. Routing. Routing calls to remote users: In order to route other than the one to which you are attached, should be set as follows: User. B. Reg.. User. a. call to a user the B register Ej. Reg.. B. 28H 29H. J. I. 38H 39H. C. 2AH. K. 3AH. D. 2BH. L. 3BH. E. 2CH. F!. 3CK. F. 2DH. N. 3DH. G. 2EH. O. 3EH. H. 2FH. P. 3FH. A. calls. l-3.

(6) Turbo-Plus 1.3 Programner's Guide. FUNCTIONS Network. Functions. the functions described in this manual, register the all of be set to to 7FH or 29H, TurboDOS versions 1.2X or for The 1.30, respectively. register is used to define the C. In. 8hou1a. E. functions.. Network (B (. FtÍnction. register. QQM. OOH. A. =. A. =. if successfulnot -l if. moctim QlM =tuLa Called with: With:. Returns Notes:. Upon. TPLUSM. 'm"'. cl"."" C) '. user. =. OIH. a. =. A. =. if successfulnot -l if TPLUSM. Q3Hl. With:. Clmt. Called With: Returns. l-4. system. included in. system. from the function the record buffer 128 byte table containing the userids of currently logged onto the system.. call,. return. Called with:. Ewactim. included in. O. Q2HL NQÁiiÉY. Returns. server). RajiK. will contain the every. user). O. SYskewi jIáexÁ9 e. from from. =h1e. =. e. With:. Returns. (JOOH. Fllnctio.ns when called when called. n=ía. clmat. Called with:. OFFH. set to. With:. AáocÁá. D. =. 02H User. a. =. O. A. =. e. =. Ta2Le. number (O-lS) to which user is attached. of record buffer contain First eight bytes userid of user being modified.. if successfulnot -l if TPLUSM. KQatmE e. =. included in. system. included in. system. Ramid. 03H. a. =. O. A. =. -1. if successfulnot if TPLUSM.

(7) Turbo-Plus 1.3 Programier's Guide. "l"'. clf. ' n". QÁÁl. :. with:. e. =. 04H. a. =. O. A. =. Functions (Continued). n=i9. Mkutt 9uxent. Called With: Returns. FUNCTIONS Network. if successfulnot -l if TPLUSM. included in. system. Notes: Upon return from the function call, the first bytes of the record buffer will contain userid of the currently logged onto the server processor. EmckiQKl. n=Lig. Chalage 8%olqk. Called With:. e. eight person. 05H. =. First eight bytes of record buffer contain new userid of server processor.. Returns. Emctim. With:. 1QHÁCl&aL. Called with: Returns. With:. a. =. A. =. if successfulnot -l if C. TPLUSM. included in. system. =. IOH. a. =. A. =. if successfulnot -l if TPLUSM. included in. system. =. llH. a. =. A. =. if successfulnot -l if. included in. system. =Lt¿em e. ñaka. O. Mnctim LWl Mkiun Called With: Returns. with:. Ratá E. O. TPLUSM. Notes: Upon return from the function call, the record buffer the 128 byte table containing the data records will contain of every user currently logged onto the system.. l-5.

(8) Turbo-Plus 1.3 Programmer's. FUNCTIONS. Guide. Functions. Network. (Continued). Fnncti. mi. UÁl. MQáiÉ!L. Called With:. Returns. EjjnckiQn. with:. RaU e. =. 12H User. number (0-15) to which user is attached. eight bytes of record buffer contain First data record of user being modified.. D. =. a. =. A. =. if successfulnot -l if O. TPLUSFI. JAM Chutt Sqkjlql. Called with:. E. Returns with:. a. =. O. A. =. -1. "1"7cl-.'o'". JAM. RÁhLe. R9=jcn. =. included in. system. included in. system. included in. system. :TahLe. Rata. 13H. if successfulnot if. =rjiL%L. TPLUSM. Raka. RecctM. Called With:. e. =. 14H. Returns with:. a. =. A. =. if successfulnot -l if G. TPLUSM. Notes: Upon return from the function call, the first eight bytes of the record buffer will contain the data record describing the current state of the server processor. Ft1nct.inn. 15At. ChÁLLgte. Called With:. RátÁi e. =. Rec.nrcl. 15H. eight bytes of record buffer First new data record of. contain. server processor.. Returns With:. l-6. a. =. A. =. O. if successful -l if TPLUSM not. included in. system.

(9) Turbo-Plus 1.3 Prograiumer's. FUNCTIONS. Guide. Functions. Network. (Continued) EsuictíQñ. ]suL. Time. Sjzt. Called with:. e. 16H. =. eight bytes of record buffer First system time and date of last. With:. Returns. Eunckim 1IHz. =. A. =. if successfulnot -l if TPLUSM. With:. =. 17H. A. =. O. A. =. -I. e. Cj&Q1e. Called With: Returns. EuñckiQñ. with:. ájüákm. TPLUSM. e. =. 20H. a. =. O. A. =. Returns With: Notes:. =. A. =. A. =. return the being run. Upon. will contain processes. E. system. the function. buffer date. of. included in. the first eight call, contain the record. willlast. the. system. system. reset.. PrQce"". if successfulnot -l if TPLUSM. 21= Rekun smkm. Called With:. included in. R%aek Time. if successfulnot if. Notes: Upon return from bytes of the record containing the time and 2QHl. contain. O. Mkun Last sjuákm. Called with: Returns. a. reset.. proc.esFk. included in. system. included in. system. Table. 21H. if successfulnot -l if C). TPLUSM. from the 128 byte by every. function call, the record buffer table containing the current onto the system user logged. l-7.

(10) FUNCTIONS. Turbo-Plus 1.3 Programmer's guide Eunckion. 22Át. 1_8. with:. Functions. (Continued). MÁiÉY. Called with:. Returns. Network. SjLáktm E. Prorre"kef. = 22H = User. number (0-15) to which user is attached. contain First eight bytes of record buffer loaded in the user the process currently indicated by the D register.. D. a A. = =. if successfulnot -l if Cl. TPLUSM. included in. system.

(11) Turbo-Plus 1.3 Prograiumer's. FUNCTIONS. Guide. Local Functions ÁQCÁí. B. register. EynctÁQR. set to. Q3M. when calling yourself 28H- 2PHwhencallingusersA-H 38H- 3FHwhencallingusersl-P O. Returns with:. QÁÁl. with:. locally respectively respectively. TakLe. =. 03H. a. =. A. =. if successful not -l being if TPLUSS called,. e. O. included in user or if user being called is currently down.. LQCái. Mkjrñ. Called With: Returns. LtQCÁí jEáeU9. Cí=. Called With:. EwicUut. F!1ncti,ons. M%LÍ!j. E. =. C4H. a a. =. O. =. if successful not if TPLUSS -l being called,. includeá in user or if user being called is currently down.. Notes: Upon return from the function call, the first eight bytes of the record buffer will contain userid of the person user board currently logged onto the to which the function call was routed. EúñcüQñ. Q5M. lqcai Aaerí9. chsme. Called with:. e. =. 05H. contain First eight bytes of record buffer which the userid of user processor to. new. function. Returns. With:. a a. = =. call. was. routed.. if successful not if TPLUSS -l being called, O. included in user or if user being called is currently down.. l-9.

(12) Turbo-Plus 1.3. FUNCTIONS. Guide. programmer's. Local Functions (Continued). Eunckimi. LQCÁL Aáer. Called with: With:. Returns. e. =. IOH. a a. =. C. =. -I. if. successful. included in user or if user being down. currently. not if TPLUSS being called,. is. called. successful return from this call indicates that the board to which the call was routed has been (or is by the server. being) downloaded. Notes:. A. user. l'r". cl-,'. Cl". 2QM. Send. Called with:. MeFIp)4'íqe e. =. kQ. ConeFc)1. e. QÉ. Lctcal. 20H. buffer. Record. will. be sent, the console of routed, preceded followed by a. contains up to 80 bytes which through comm channel zero, to the user to which the call is by a shift-in character, and. shift-out.. Returns With:. a. =. A. =. if successful not if TPLUSS -l being called, O. called. is. included in user user being or if currently down.. this indicates that the Notes: successful return sent in the record buffer was received by the message user, and displayed on the console of that user. that user TWX a has (see special console manager genned Guide the to Turbo-Plus), bytes may cause the message to be displayed in a special manner on the screen. A. Installation. l-lO. from. call. If in, shift-in/shift-out.

(13) Turbo-plus 1.3 Prograiumer's. EjmckiQD. FUNCTIONS. Guide. Local Functions (Continued). 2jÁl. Lq LQQái. .Me'°l"kaqe"F. Ás!áí. Called With:. E. =. 21H. Returns with:. a. =. O. A. =. not if TPLUSS -l being called,. if. successful. included in or if user called is currently down.. user being. successful return front this call indicates that the to which the call was routed will one again be able to 20H, receive messages reversing the sent via function effects of function 22H.. Notes:. A. user. EunctíQñ. ==. Pi. "M'l. Called with: with:. Returns. (". Me,"h"kqiqrq. Kq LQQái. Áá!át. =. 22H. a. =. O. A. =. not if TPLUSS -l being called,. e. if. successful. included in or if user called is currently down.. user being. successful return from this call indicates that the which the call was routed will ignore any calls of function 20H, until messages are enabled again, using function 21H.. Notes:. A. user to subsequent. i-: i.

(14) Turbo-Plus 1.3 programmer's. Guide. User. TnrMMS 9sai. TnformAti.on. Network. A=jLig. Tables. n'"q("'""Tq"t'cp'"". Ejttma. l-12. FUNCTIONS Tables. Information. pe"pcription. 0..7. Usericí. A. userid of the user currently logged nobody is currently onto user A. logged onto the Ifuser, the first byte will be O. If user A is currently attached to the server processor, the first byte will have the high bit set.. 8..15. Userid. B. 16..23. Useriá. C. 24..31. Userid. D. 32..39. Úserid. E. 40..47. Userid. F. 48..55. Userid. G. 56..63. Userid. H. 64..71. Userid I. .. 72..79. Userid. j. .. 80..87. Userid. K. 88..95. Userid. L. 96..103. Userid. M. 104..111. Userid. N. 112..119. Userid. O. 120..127. Userid. P. The. . . . . . .. .. . .. . . .. ..

(15) Turbo-Plus 1.3 programner's Guide. &ujlck. nÉ&rijd. Tattle. FUNCTIONS User. O'j"qr. "I ':. 7|' t'". Information Tables (Continued). M7 ". Ejtkmá. Eí!ua. Pe'"lcript.inn. 0..7. Userid. The onto. 8. ID. Contains. useriC of the user currently logged the server processor. If nobody is logged onto the the currently server, first byte will be O. user For IOH.. byte corresponding to the assigned to each user. the server, this entry is fixed at a. number. l—13.

(16) Turbo-Plus 1.3 Progranuner's. Sjüátjáo. Guide. User. R=La. Ráká. FUNCTIONS Tables (Continued). Information. TsLhL!zL. ÉjLt©á. Eíeí9. pe¶kcription. 0..7. A. The data record, as described below, for the user currently logged onto user A. nobody is currently logged onto user a, this record is to be ignored, and may contain the data pertaining to the last user logged onto user A.. Data. If. still. 8..15. b Data. 16..23. C. Data. .. 24..31. d Data. .. 32..39. E. Data. .. 40..47. f. Data. .. 48..55. G. Data. .. 56..63. H. Data. .. 64..71. I. Data. .. 72..79. j. Data. .. K. Data. .. 88..95. L. Data. .. 96..103. M. Data. .. l04..llí. N. Data. .. 112..119. O. Data. .. 120..127. P. Data. .. 80..87. .. £ ÉjLÉé Recor(í· l. I. E!. H,M,S R. l-14. =. M. =. l. S. Logon. Reserved. i. R. I. Time Bytes. R. I. R. l. D. l. D. I. DD. =. julian. Logon. Date.

(17) Turbo-Plus 1.3 programmer's. &u=L. Ráta. FUNCTIONS. Guide. User. =gQKg. Ejtkes. Eítdbd. Pp"fr.ript.iQn. 0..7. Data. The. yRkiu&. Information Tables (Continued). data record, as described above nobody the server processor. currently logged onto the Ifserver, record is to be ignored, and may contain the data pertaining to the onto the server. user logged. for. is this still last. =h1e. nrq1'| 1" i "t'. t. ". nr. ". Ejtkesi. EijúÁ. Pe°)criptinn. 0..7. Uptime. A. data record, with. a. format. that. the described for and. system. was. containing. the time last reset.. the. same as. users, the. date that. 1_15.

(18) Turbo-Plus 1.3 programmer's. FUNCTIONS. Guide. User. Information. Tables. (Contínued). User PrnceFisi. Process. Table: (Called with. Eh. =. 2). Lahlm. Éjtkeia. EiÁL9. 0..7. A. Proc.. Deqcript.ion The. process in memory currently loaded user currently logged onto user nobody A. onto is currently logged the user, this record is to be ignored, and may the data pertaining to the last user logged onto the user.. in the. If. still. l-16. 8..15. B. Process. .. 16..23. C. Process. .. 24..31. D. Process. .. 32..39. E. Process. .. 40..47. F. Process. 48..55. G. Process. .. 56..63. H. Process. .. 64..71. I. Process. .. 72..79. j. Process. .. 80..87. K. Process. .. 88..95. L. Process. .. 96..103. PI. Process. .. l04..11l. N. Process. .. 112..119. O. process. .. 120..127. P. process. .. contain.

(19) Turbo-Plus 1.3 prograurmer's. FUNCTIONS. Guide. User. LQGái JÍ&qk RaeU9. EjL=i 0..7. 8. =hLe. Lahlm. nrqií1]i"Át.ínn'". Eíejid Userid. ID. Information Tables (Continued). De"r.riptinn userid of the user currently logged the user processor. If nobody is logged onto the user, the currently first byte will be O. The onto. Contains. a. byte corresponding to the assigned to each user. this will be O, for user l, etc.. number user For user A, be b,. it will. l-17.

(20) Turbo-Plus 1.3. '. TURBO-PLUS. INsTALLATroN. Guide. c)¶/er¶/i.p\d. Turbo-Plus makes extensive use of the TurboDOS User Defined 7FE in TurboDOS version 1.2x, and 29H in TurboDQS Function (call version 1.30). Therefore, if you wish to add your own functions parameters with this call, is imperative that you not use any The which values willby conflict with those used by Turbo-Plus. reserved Turbo-Plus are described in the FrjNcTT.oN,s section, Chapter 1.. it. Furthermore, in order for Turbo-Plus to properly route calls users, reserves eight queues and eight printer" in the server and the users. Thus, you may not use queues I through P or printers I through p in your system configuration. between. it. SeriA1i7ation Each. to be is serialized The. copy of Turbo-Plus TurboDoS operating system. coincides with that of the operating system None of the modules in Turbo-Plus run. own. with a serial number different that. particular. its. on. will. run. only. on a number is to be any system. serial which. run. on. it. 2-l.

(21) Turbo-plus 1.3 Programier's Guide. Re1ocatab1e These code. are. distributed DIRDUMP.REL. ÍÁJ&s. proqram. of the files containing the assembled source all programs They are Turbo-Plus. constituting in relocatable form, main. the patching. to allow. which by user. Program. sorted. gives a area.. directory. master. GO.REL. which program moves users by a user-defined name.. to. GONAME.REL. Utility. to define. areas. HELP.REL. which on the. allows system. LCGOFF.REL. specified. area. user. disk,. any. names. for. user. providing help on facility commands. Users may. files.. Utility to. search certain or template.. Utility to log file.. make. given. LOG.REL. users. a. of. of. TurboDOS on-line help TurboDOS and Turbo-Plus add their own help. all. LOCATE.REL. INSTALLATION. Files. ,an9 eKecl1FaPÍe. for the. parameters.. TURBO-PLUS. file. Enhanced pending. of. entries. or in. a. all. system. date. and. drives for time. stamped. version of system logoff, notifying users mail, and displaying system bulletins.. LQGON.REL. Enhanced version of system logon, notifying of pending mail, displaying system bulletins, providing addition levels of security.. MAIL.REL. TurboDOS mail be sent among users. users and. mail to. electronic facilityon to allow system. the. PROFILE.REL RESET.REL SERVER.REL. Program Enhanced. providing STATUS.REL. to reset. user. from. another. version of the TurboDOS better control of access. user.. 'SERVER'. command,. to the server.. monitor activity of Facility to continuously and. users, printers, TWX.REL. a. TWX. to facility to other. messages. system. buffers.. allow. consoles. users to send on the system.. immediate. 2-2.

(22) TURBO-PLUS. Turbo-Plus 1.3 Programmer's. Files (Continued) display all current users facility to they and are. System status on the system, current system. WHO.REL. Re1oc&tab1e. number of routines include the followina. running. processes. characteristics.. other. íLLes. ,s!1hrol!tine. A. are. shared. by. files:. various. program. modules.. They. LCGCHK.REL MROUTE.REL TPFIOD.REL. GBUFF.REL MBUFF.REL TABLES.REL. DBUFF.REL LCGDAT.REL PTABLE.REL SYStéjO. INSTALLATION. Guide. f|Inct.i.on. system where your files must reside in the user area onandthewhere system's .GEN and .PAR files reside, your system Some of them must be genned into your generation takes place. There system in order for Turbo-plus to work. are six such These. files:. TPLUSM.REL TWXTV.REL CONBB.REL. TPLUSS.REL TWXNUL.REL CON96TP.REL. £Ü&s. and. You must create .GEN + .PAR files if you wish to change your Turboplus installation from the standard NorthStar configuration. B + .PAR files are listed in Appendix The NorthStar .GEN of the TurboDOS North preface. Star. All of the following accompanied. DIRDUMP. LOCATE MAIL STATUS. by. .PAR. programs. have. .GEN. files: GO. LOG SERVER TWX. files,. GONAME. LOGOFF PROFILE. some. of. which. are. HELP. LOGON RESET. WHO. 2-3.

(23) Turbo-plus 1.3 programmer's. TURBO-PLUS. Guide. c11stomi.zi.nq. =. INSTALLATION. Customizing. £qje Specj.fi.c. TWX. TerInj.nÁ1s. module. in the user operating system necessary for TWX on the screen without the placing of TWX messages are using a interrupting normal console input/output. If you which Televideo terminal, you may use the TWXTV module, places For any terminal status line. all received TWX messages on the other terminal you may use the TWXNUL module, which simply prints each line at the current cursor position, followed by a carriage A sequence. of theqe modules source listing return-line feed in case you wish to rnodify them for your specific follows, terminal. Modification niay be done either by writing your own TWXNUL in the user .PAR driver, or patching file. NorthStar you have Televideo terníinals, you can Turboplus uses TWXNUL. If TWXTV TWXNUL. change OSU8BASE.GEN to say instead of A. handles. TWX TWXNUL. - Null. Console. Null. Console. Manager. Manager. for Turbo-Plus. 0 T. .IDENT. TWX. program. TWXNUL. * V ;. Default Shift-ln/Shift-Out. f0 ;. controls. Author: jim Gabriel Microserve, Inc.. ; Ie. ; .INSERT {*. 0000" 0000" 0000". SICODE: 0DOAO0000O00 f* SOCODE:. 0D0A0O0000OO {*. 0000'. .DATA.#. .LOC. t0. 0O(JA" OOOA". DREQUATE. : .BYTE. ACR,ALF,O,0,0,0,0,0,O,O. : .BYTE. ACR,ALF,0,0,0,0,0,O,O,O. .LOC. .PROG.#. 0 P. 0000' 0000' 0001' 0002' 0003' 0006'. TWXSI:. :. PUSH. PSW. PUSH. B. ; ;. SAVE. C5 E5. PUSH. H. ;. 0000" 1806. LXI. H,SICODE. ;. . SET. JMPR. SCONT. ;. .. F5 21. REGISTERS. . HL. FOR. (Continued). 2-4. SHIFT. IN.

(24) TURBO-PLUS. Turbo-Plus 1.3 Programmer's. INSTALLATION. Customizing. Guide. TWX. (Continued). 0008' 0008' 0009'. *t TWXSO:. F5. :. C5. OOOA'. E5. 0006'. 21. OOOA". PUSH. PSW. ;. SAVE. PUSH. B. ;. .. REGISTERS. PUSH. H. ;. .. LXI. H.,SOCODE. ;. SET. ;. FOR. HOV. A,M. ;. GET. ;. .. OOOE' DODE'. FOR. ..LP:. EACH. BYTE BYTE IN. DODE'. JE. OOOF'. 137. ORA. A. 0010' 0012' 0013' 0015' 0016' 0017'. 280D 5F. JRZ. SRET. ;. .. MOV. OE59. MVI. E,A C,36. ; ;. . SET. D5. PUSH. D. ;. SAVE. Y. E5 CD. PUSH OQQO:. C4. í;. NOTE:. ;. ODIA' QOIB' OOlC' OOID' OOIF' 0020' 0021' 0022'. OUT. SHIFT. HL. ; SCONT:. CALL. "CA"LL POP. El Dl. POP. 23. INX. 18EF. JMPR t9. El Cl. SRET:. El. C9. E. CONOU!. FOR. CHANNEL. NUMBE!. SAVE ; POINTER -_g ._ ÓTNTRY#'>TO COM CHANNEI SEND ;_ OSNTRY iiz TurboDOS versions RESTORE H POINTER ; RESTORE CPI NO. D ; EI ; INCREASE POINTER. l.2x. ..LP. ;. END. POP. H. ;. RESTORE. POP. B. ;. .. POP. PSW. ;. . RETURN. RET. PARM. DO. ;. DO. REGISTERS. W g. .END. ·.. To modify this driver you may either write your own, or use The primary reason symbolic patch facility. to write your a would be to perform operations other than simple console output of a string of bytes, such as code to also keep track of the cursor position before the message. the own. the following points TWXSI, the which will be before every TWX line, to position which and TWXSO, be called after as desired, every will cursor TWX line, to restore the cursor. All console output must be done via calls to the COlñlñ channel, which is defined in register D upon entry to the routine. you wish If specifications:. to. It called. do this, the module must meet have must the global entry. 2-5.

(25) Turbo-Plus 1.3 progr=mer's Guide. TURBO-PLUS. INSTALLATION. Customizing. TWX. (Continued). your only modifications involve changing the string of each message, be sent out before and be more convenient to use the TurboDOS symbolic patch The routine allows for up to ten bytes to be patched and SOCODE SICODE at locations at the beginning and end, For example, you wish respectively. to send out five bells and and a and a clear screen at the beginning,the end, feed sequence at for carriage return-line your .PAR the user could be patched as follows, using TWXNUL:. If. bytes to probably. it. after. will. facility.. if. SICODE. =. SOCODE. =. five bells file. 07,07,07,07,07,OC 07,07,07,07,07,OD,OA. using one type of terminal frequently, a special driver for it, even it only involves changing the bytes, so that you need not change a which An example .PAR you use. driver is of such every TWXTV, below, shownfile written for the Televideo 800, 925, and 950 This driver is designed to take advantage of the terminals. status line of the terminal. All TWX messages will appear on this line, leaving the user's screen intact.. if. However, you are ínay be easiest to. it. Televideo. TWX TWXTV. - Televideo. if. write. 950 Console. Console. Manager. « t. .IDENT ; ; * P ;. ;. Manager. for Turbo-Plus. TWX. program. TWXTV. Shift-ln/Shift-Out. controls. for Televiáeo. Author: jim Gabriel Microserve, Inc.. ;. .INSERT ;. 0000" 0000" 0000" 0006". *f. SICODE: 071B671B661B 473cci0oo. OOOA" QOOA". 0000'. SOCODE:. 0DO0000000OO ;. DREQUATE. .LOC. : .BYTE .BYTE : .BYTE. .DATA.# ABEL,AESC,67H,AESC,66H,AESC 47H,3cH,00íi. ACR,0,0,0,0,0,0,O,O,O. .PROG.# .LOC (Continued). 2_6.

(26) Customizing. Guide. ProgramAer's. INSTALLATION. TURBO-PLUS. Turbo-plus 1.3. TWX. (Continued). 0000' 0000' (JODI' 0002' 0003' 0006'. TWXSI:. :. PUSH. PSW B. ; ;. SAVE. PUSH. E5. PUSH. H. ;. 0000" 1806. LXI. H,SICODE. :. . SET. JMPR. SCONT. ;. .. PUSH. PSW. ;. SAVE. PUSH. B. ;. .. ; ;. . SET. ;. FOR. F5 C5 21. t0 TWXSO:. 0008' 0008' 0009'. F5. OOOA'. E5. OOOB'. 21. :. C5 OOOA". OOOE'. REGISTERS. . HL. IN. REGISTERS. PUSH. H. LXI. H,SOCODE. MOV. A,N-. ;. GET. t T. SHIFT. HL. FOR. ..LP:. EACH. BYTE BYTE IN. ÜOOE'. 7E. OOOF'. B7. ORA. A. ;. .. DOlO' 0012' 0013' 0015' 0016' 0017'. 280D 5F. JRZ. SRET. ;. .. MOV. ;. OE59. MVI. E,A C,36. ;. . SET. D5. PUSH. D. ;. SAVE. E5. PUSH. H. CALL CALL. OTNTRY#. El Dl. POP. H. POP. D. 23. INX JMPR. H. CD. 0000: 04 NOTE:. ;. OOIF' 0020' 0021' 0022'. SEIFT. OUT. SCONT:. DODE'. ODIA' 0018' OOlC' 0010'. FOR. 18EF. OSNTRY. ..LP. SAVE. ;. in. SRET:. FI C9. POP. H. POP. B. POP. PSW. RET. FOR. CHANNEL. E. CONOUT NUMBER. POINTER TO. COM. CHANNEL. TurboDOS versions 1.2X RESTORE POINTER ; RESTORE CH NO. ; INCREASE POINTER ; ; END DO. t0. El Cl. SEND. ;. PARM. DO. ; ; ; ;. RESTORE. REGISTERS. . . RETURN. f*. .END. 2-7.

(27) 1.3 Guide. Turbo-Plus Programmer's. TURBOPLUS. GEN AND PAR. GEN. FILES. PAR. FILE. LISTINGS. BBE(3IN.PAR USER = IF DRIVE = O. BB.(3EN BE: TPMOD MROUTE. BBLIST.GEN. BB.PAR. BBLIST TPMQD MR(JUTE. DRIVE = O USER = IF. BmIsT.pAR USER = IF DRIVE = O. BBACK.ON BBACK TPMOD MROUTE. BBLOG.GEN BBLOG TPMOD. BBACK.PAR DRIVE. +. =. O. BBLOG.PAR. BBCANCEL.GEN. DRIVE. BBCANCEL TPMOD MROUTE. DIRDUPF'.GEN. BBCANCEL.PAR BSLAVE = 8 DRIVE = O USER = IF BBDEL.6EN BBDEL TPMCÍD MROUTE. = C). DIRDUMP MROUTE TF'MOD DBUFF GONAPE.GEN GONAME MRDUTE TPMOD 6BUFF GCNAPE.PAR. BBDEL.PAR. SDRIVE. USER = IF DRIVE = O. HELF'.ON. BBEGIN.EN. HELP MRQUTE TF'MOD. BBEGIN TABLES TF'MOD. FELP.PAR S[)RIVE. = Ol. = O!. A-l.

(28) Turbo-Plus 1.3. GEN. +. PAR. LocATE.fm4. reset.6en. LOCATE MROUTE TPMOD LO6.GEN. RESET MROUTE. LOG MROUTE TPMOD. SERVER TPMOD MROUTE. LOGOFF.GEN. STATUS.=N. LOGOFF LOGCHK TPMOD MROUTE. STATUS TPMOD MROUTE. =FNJER.EN. STATUS.PAR LCJGOFF.PAR CLSCR SDRIVE. = 01. 1MX.6EN. LOGON.6EN TWX MROUTE TPMOD. LOGON LOGCHK LO6DAT MROUTE TABLES TPMOD. WHO.6EN WHO TPMOD MROUTE. LOGON.PAR SDRIVE. =. 01. MAIL.6EN MAIL TPMCID MROUTE MBUFF I'QAIL.PAR SDRIVE. = Ol. PROFILE.GEN PROFILE MROUTE TPMOD. A-2. FILE. LISTINGS. (Continued). Guide. Programmer's. = 4,!E,OO,OO,OO.

(29)