s)0s()sn|d·oqjnL ep!n9

Volltext

(1)ep!n9. s)0s(). sn|d·oqjnL.

(2) Turbo-Plu8 1.3 Wer's Guide. 2]. OF. CONTENTS. .............................. ii Overview .............................................. l-l Commands 2-l .............................................. 2-l 2-3 Command .......................................... 2-4 BBDEL .................................... BBLIST Command ....................................... 2-5 Command ...................................... 2-7 Command ..................................... 2-9 Command 2-lO .......................................... 2-12 ...................................... 2-13 ........................................ 2-15 ...................................... 2-16 Command ......................................... 2-17 Command ...................................... 2-20 MAIL ....................................... 2-23 PROFILE Command ........................................ 2-25 Command ..................................... 2-27 Command ....................................... Command ...................................... 2-28 2-30 ...................................... 2-32 ......................................... ......................................... and. Features. l]. TABLE. BB. Facilities. Command. BBCANCEL. Command. DIRDUMP. GO. GONAME. Command. HELP. Command. LOCATE LOG. Command. LOGOFF LOGON. Command. RESET. SERVER. STATUS TWX. Command. WHO. Command. i.

(3) Turbo-Plus 1.3 User's Guide BB. FEATURES. Utility optional. BBCANCEL. Cancels. BBDEL. Deletes. BBLIST. with which users may submit jobs, schedule time, to the batch processor and. executed. FACILITIES. AND. a. by. logs. the. the. job. from the batch submitted the job.. who. user. an. queue.. active batch job.. currently. pending. with. if. queue,. and. jobs running in the batch processor Lists all the pending batch on. queue.. DIRDUMP. Gives server area.. GO. Moves name.. GONAME. Allows users to define and to system, or by user alphabetically. user. to. directory a. of. area. user. any. specified names. these. list. disk,. area. sorted by. a. by. user. user-defined. for user areas on the sorted area names number. TurboDOS may add. HELP. On-line help facility providing help on all and Turbo-Plus commands. users Additionally, their own help files to this global function.. LOCATE. Searches certain or template.. LOG. Allows user to make time-stamped entries in a daily useful for .DO files submitted log file - particularly to the batch processor.. LOGOFF. Enhanced pending. L(JGON. version of system logon notifying users o: E and pending mail, displaying system bulletins, providing additional levels of privilege.. MAIL. TurboDOS mail sent between users. PROFILE. ii. all. system. drives for. given. a. version of system logoff notifying mail, and displaying system bulletins.. file. users. of. Enhanced. allow electronic mail to facility to system.. Menu-driven. file.. RESET. or. Program. on. utility. to reset. a. user. be. the. to maintain from. another. system. user.. USERID.SYS.

(4) Turbo-Plus 1.3 User's Guide. FEATURES. SERVER. Enhanced version providing better processor.. STATUS. TurboDOS system users,. AND. FACILITIES. command, of the system 'SERVER' control of access to the server. monitor activity of facility to continuously and printers,. buffers.. facility to allow users to send immediate multi-line messages to other consoles on the. TWX. TWX. TurboDOS single or system.. WHO. TurboDOS system status to display current users on the system, the processes which they are running, and other current system characteristics.. facility. all. iii.

(5) Turbo-Plus 1.3 User's Guide. OVERVIEW. Turbc-Plus is a set of utilities and function calls which enhance the TurboDOS Operatiiy; Syst«ti, rtzaking extensive use of the User Defined Function, (call 7FH in TurboDOS version 1.2X, and 29Fl in TurboDOS version 1.30) This manual is designed in the process. to fully utilize to provide all of the necessary information commands and functions. these package,. into sections providing on using each command, instructions of the new function calls.. Lbmu. operati.on. The. manual. about. all :Qí. is. Civicied. an. overview of the and information. Turbo-Plus consists of two primary divisions: the background batch processor, and the inter-user oriented utilities. background (BB) enables batch an extra user board, processor not attached to any console, to run jobs submitted by other users on the system, thus allowing the other users to keep their BB aceeptss terminals from being tied up by long-running jobs. command as a command, suffixed, any valid TurboTjOS line Each subntitted job is placed on ifa desired, by a schedule time. by the batcb then serviced disk-resident queue which issystem monitor the on the able to processor. users are All status of the processor, and any user may delete a job which he submitted while is still in the pending state, or abort a job while it is running. The. it. of the reIhaining utilities in Turbo-Plus use the exterísions These to the TurboDOS function calls included in Turbo-Plus. functions maintain iistg in memory containing information about TIÁS each station on the system as well as the server. information create,"' the ability' to have additional comIr?aDds, such logged as the WHO command, to find out who is currently onto each station; the MAIL command, a complete inter-user mail facility; the TWX comnarzc3, to other users on the system, to send xessages the RESET command, to reset stations whiSh are down (like the RESET command of TurboDOS Version l.lx) , and a new SERVER cominand, stations simultaneously attached limitinq the number ofone, and any thus eliminatinc' to the server processor to Turbo-Plus also contenticm problems that may currently occur. adds the ability to restrict users to specified disk drives on the system, providing an additional level of system security. Most. *NqÉ!zl. Tbe. RESET. an¿. BBCANCEL. hardware configurations. commands, these consult. your. commands you are. Ifdealer.. will not work on certain having óifficujty usinq l-1.

(6) Turbo—Plus 1.3 User's Guide. BB. Command. COMMANDS. The onto. BB. the. command enables batch queue.. you. to enter. a. job. Syntax l. I. l. BB. !. BB. I. BB. command command command. I @hh:. nun. l. @hh:. nun+d. l. I. Explanation. l. is. The 'command' argument any legal TurboDOS command which not require any console Such input would cause the batch input.. will. to reset processor CONBB module has. generation.. providing that the itself, user included in your. been. second form of the command is used for scheduling jobs. hh: mm is the time which the job should run in 24 hour time. The +d is a option, shown in the third form of further the number of the command, which specifies days later that the job is to be run. (e.g* @00: 00+2 means 'Run the job at midnight. The. tomorrow. night.').. multi-command string may be entered onto the batch queue. This command's format command should be similar to a multiple entered directly onto the Command Line Interpreter, except that the vertical bar character (i) should be substituted for the back-slash character (\) expected by A. TurboDOS. Examples. I. I. l. wüm rq BATCH. l. OÉÚEE. i. BATCH. l. I. ©M·ñl)+1 JOB 0308 QUEUED-WAITING ERINT FTTFIPO ERINT JOB 1969 QUEUED-WAITING. I. REEQBT. 02. TO. RUN. Dl. TO. RUN. ! l l l.

(7) Turbo-Plus 1.3 User's Guide Error. COPQIANDS. (Continued). Messages l. l I l I l. line. Command Bad format Bad format. in in. is. empty schedule schedule. { l. time day. l l. Parameters l. l I. USER. Dl. =. l. BB. i I l j l. 2-2. User. DRIVE. =. Dl. number. where. processor resides.. Drive. where. (0=A, BB. resides.. I=b, etc.) processor. l l l I l I l.

(8) COMMANDS. Turbo-Plus 1.3 User's Guide. (Continued). The. Command. BBCANCEL. BBCANCEL. execution processor.. of. command enables you an active job in. to stop the the batch. Syntax I. I i. I. BBCANCEL. I. I. there is at most no job number command line.. Since. Explanation. time,. one. job running at. is required. on. any. the. This command must be issued by either a privileged user or by a user under the userid from which the job was queued. Otherwise, the warning: "***User Unauthorized to Delete job" will be issued. deletion is If theappear a message on the successful, will console stating the job number and user area from which is was queued. Examples !. I I. 2F}BFlCP.NCFT. I. JOB. #:. I. 1120. QUEUED. l. Error. BY. SYSTEM. FROM. 08-J. ----. l. CANCELLED. !. Messages l. ! I ( !. User There. l. Unauthorized to delete job is no job currently running. I I. 2"3.

(9) Turbo-Plus 1.3 User's Guide. comANDs. (Continued). Parameters l l. I USER. Dl. =. User. l. BB. I l. Dl. =. Drive. (0=A,. where. I. resides.. l l l. BUSER. =. Dl. where. processor resides.. I. I. 2"4. DRIVE. number. User 1=8,. BB. etc.) processor 1=8,. number. etc.) of processor.. I l I l l I. (0=A, BB. I l l.

(10) COMKANDS. Turbo-Plus 1.3 User's Guide. (Continued). The. BBDEL Command. command. BBDEL. pending. enables you to delete from the batch queue.. job. a. Syntax I l. l. BBDEL nnnn. I. l. 'nnnn' argument is the job number to deleted (leading zeroes may be left off).. The. Explanation. be. This command must be issued by either a privileged user or by a user under the userid from which the job was queued. Otherwise, the warning: "***User Unauthorized to Delete deletion is job" will be issued. If theappear a on the message successful, will console stating the job number and userid and area from which is was queued. Examples l. l l. ioHERREL JOB #: 0046. u. !. l QUEUED. SYSTEM. BY. IO-F:. FROM. -----. l. Error. l. DELETED. Messages. l. I I I I I. Illegal. job. l. number. l. found. job not User unauthorized to delete job. l l. Parameters l. I i. USER. 01. =. l. BB. I l i l l. User. DRIVE. =. 01. number. l. where. processor resides.. Drive where. (0=A, I=B, processor. BB. etc.). I { i I I. resides.. I. 2-5.

(11) Turbo-P1u8 1.3 User's Guide. BBLIST. Command. COKMANDS. (Continued) The. BBLIST. the current. command enables and pending. the. jobs. list. user to on the batch. queue. Syntax l. I. I. {;options}. BBLIST. Í. Explanation. The. report. consists. l I. of. sections.. two. only present when there is first, currently running, lists that job. The. half lists all jobs waiting. on. The a. job. second. the batch. queue.. the id For all jobs, lists the job number, it requested the user area of the user who it, was queued, and the request from which For the current job time. also includes the time the job began running, and for the pending jobs includes the time for which the job is scheduled.. it it. Options. I. Option. !. it. Explanation. l l l l l. 2-6. l I. ;F. report will include with job line, the command string which was queued.. The each. l I i I.

(12) Turbo-Plus 1.3 User's Guide. COMMANDS. (Continued). Examples l l. 5F}EBÁIST. l. BACKGROUND. 13-Aug-83. BATCH:. AT 17: 10 I. l I. CURRENT. I. JOB. l. PROCESS:. #. 045. QUEUED. BY. RJ. 2-J. FROM. l l. PENDING. I. JOB. AT. 15:. BEGAN:15:06:39. 06:22 -. 046. QUEUED. BY. JG. IO-F. FROM. 17:. AT. I. I. 5F}BBT,TST. !. BACKGROUND. I. CURRENT. I. JOB. I I. PROCESSES:. #. l. 09:51. FOR. l. 00: 00. l. I. iE. 13-Aug-83. BATCH:. I. AT 17: 10. I. 045. #. I. I. PROCESS:. *. DO. QUEUED. BY. RJ. 2-J. FROM. STAMlOl. AT. 15:. BEGAN: 15:06:39. 06:22 -. l l. l I. PENDING. I. JOB. PROCESSES:. #. i. 046 *. DO. QUEUED. BY. JG. FROM. IO-F. AT. 17:. 09:51. FOR. I. 00: 00. REPORT. I. Parameters. I. i I. USER. Dl. =. l I l. DRIVE. =. 01. User number where bb processor resides.. Drive. where. I. resides.. I. etc.) processor. (0=A,. I. BB. I=B,. 2-7. l I l I.

(13) Turbo-P1u8 1.3 Guide. COMKANDS. User's DIRDUMP. Command. (Continued) The DIRDUMP command master directory of a. enables you disk drive.. to get. a. Syntax l. l. !. DIRDUMP. I. DIRDUMP. {;options} {;options}. l. Explanation. l. d:. specify If you example, first. obtained for current drive. [ I. a drive the master that drive.. as in the letter, directory will be Otherwise, the listed.. will be heading The report will have consisting of the disk's label and the current date and time. Following this it will list the user a. O to 31, omitting any areas in order from which are empty, producing in each area a directory sorted alphabetically. give the total disk usage for eachIt will area consisting of number of files, and number of K in use.. program take a few minutes to sort will Once the sort is complete, directory. will send the report eitherby tothe the screen or as specified option. the printer, If sent after each to the screen, it will pause RETURN key. screenful for you to press the The the. Options. I. it. Options. !. t. Explanation. I. l I. ;L. l ! l. directory listing is to to the printer instead of the console.. be. The sent. l I l l. Examples l l. I. 6D}pTpnT|Mp. I. l l I. 2-8. ...(display. of. all files. on. drive D).... I.

(14) Turbo-Plm 1.3 User's Guide. COMMANDS. (Continued). parameters l I ! I I l I i. I CLSCR. = 1,1A. This may be a string of up to 10 bytes for the terminal clear—screen sequence.. The. first. byte. specifies the length of the string.. 2-9. l l ] I l l.

(15) Turbo-Plus 1.3 User's Guide GO. Command. COMMANDS. (Continued). The. GO command enables you to move around between user areas whose names were predefined usina the GONAME utility. (cf. GONAME. Command).. Syntax i I. l GO. argument. I. Explanation. I. The. argument is the predefined name of a user area, up to eight characters GOin length. If look for the argument is not matched, will any area name whose agree firstn isn letters where with 'argument', the length of GO no such name exists, 'argument'. will If 'No Such User Area return the message a non-privileged user attempts Defined'. If to use this command, the same message will be printed.. Example I. l I. l. 6F}GQ. l. l I l. 0A}GQ JJJ Such User. No. I l. 0A}GQ. I. Area. Defined. I l. 5F}GQ SX. I. l l. l. TJIRBQ. I i. I. I. DA}. I. Error. Messages I I. No. i. No. I. 2-lO. Area Such. on Command Line User Area Defined. t.

(16) Turbo-PluB 1.3 User's Guide. COMANDS. (Continued). parameters I. l I l I. SDRIVE. =. Oí. l. System search drive (1=A, 2=B, etc.). I I. 2-ll.

(17) Turbo-Plus 1.3 User's Guide GONAME. Command. COMMANDS. (Continued) The GONAME names for. command. various. enables you user areas on. to establish the system.. Syntax l i. l GONAME. !. I. Explanation. l. The you and. program, which is menu driven, enables to create area names, delete area names, produce listings of the user areas and their names, both in user number order and in alphabetical order. Upon. will. command, issuing the GONAME the user presented with the following menu:. be. l) 2) 3) 4) 5). Enter. User. Area. Names. Delete User Area Names List Areas Alphabetically List Areas in User Number Exit. Order. the user specifies choice l, he will be the drive, for the user number, then finally the assigned name. Pressing the two return key for either of the prompts will return the user to first the main menu. If a duplicate name is given, an error message will be returned.. If. prompted and. will be If the user specifies choice 2, he Pressing prompted for the name to delete. the return key will return him to the main menu. Giving a name will result in either the name being deleted, or, is not found, an error message being returned.. if it. If. be. the user specifies asked whether the. choice output. 3. or. should. 4, he go to. will. the Terminal or the Printer. Following this choice, the areas will be listed in two columns, where the first is the user area (e.g. ll-G) and the second is the name associated with it. For choice 3, the order be alphabetical by name. For choice 4, will the order will be by user area, which means 2-12.

(18) COPIKANDS. Turbo-Plus 1.3 User's Guide. (Continued). that user. of first all order,. number. A. will be listed in all of drive, etc. choice 5, he will be system.. drive. then. B. the user specifies If returned to the operating Parameters I i. SDRIVE. =. I. 01. I l l l l l l I. CLSCR. =. l,lA. i. System search drive (1=A, 2=b, etc.). l l l. This may be a string of up to 10 bytes for the terminal clear-screen sequence.. The. first. I l. byte. I l. specifies the length of the string.. I I. 2-13.

(19) Turbo-Plus 1.3 User's Guide HELP. Command. COMANDS. (Continued) The. command about commands.. HELP. information. Plus. enables you to obtain various TurboDOS and Turbo-. Syntax l. l. i. HELP. i. HELP. I l. command. l. Explanation. I. 'command and 'argument is optional, present indicates the command for which require assistance. The. if. you. is omitted, HELP will provide allAnythe topics for which help is of these topics may then be used as an argument to obtain more specific information.. If. the. argument. list of available. a. When. an. provide. matching. argument is present, the information on the string provided.. will all topics HELP. each is screenfulpauseof information and wait HELP will printed, for a carriage return input from the console before To abort at this point, continuing. press 'X'.. After. you wish to add your own help files to the Iffacility, simply create a file called cominand.HLP on user zero of your search drive; set the global attribute on the file, and will be included in future HELP. it listings.. Parameters. I. I l. 2-14. SDRIVE. =. Dl. System search drive (1=A, 2=B, etc.). l [ i.

(20) Turbo-Plus 1.3 User's Guide LOCATE. Command. COMMANDS. (Continued). The. command. LOCATE. more. or given. active. file. or. enables on. drives. files.. you. the. search one system for a. to. Syntax l. l I. LOCATE. i. LOCATE. l. Explanation. l. filename {;options} {;options}. contains wild-cards, If "filename" can be used to find more file the system. command on. I ). the LOCATE than one. "options" argument inay be any combination of the letters A-P, S, or 'm. A-P and '*' specify the drives on which to search, andS the order in which to perform the search. should means that the program stop after The default setting finds the first match. and is to search every drive on the system, not stop, i.e. ';*'. The. it. from the command is omitted If "filename" command operates in an then the LOCATE line, commands from mode. accepts interactive the console, prompted It by an asterisk, until a The commands in is entered. null command mode do not accept options of interactive their own, but rather obey the options set in the initial program invocation. Examples [. i i. 0A}TOCRTF. I. * ppjq·cip*. I. l l. ????????.PRN j. l l. Searching. l. SYSTEM. l. PROGRAM. l. Searching. I. STAM. l. Searching. l. CON96. l. Searching. Drive. 1. G. l. 5-G 21-G. .PRN .PRN. Drive. D. Drive. A. Drive. B. .PRN. .PRN. l (. 2-D. l. O-A. I. I l. (continued) 2-15.

(21) Turbo-P1m 1.3 UserW Guide. COMMNDS. (Continued) l ! l. Searching Searching Searching. l. LOCATE. l. Searching Searching. l. Drive Drive Drive. l. C E. l. F. I I. 3-P. .PRN. I. Drive H Drive I. {. i l. l. l. !. 0A}TocATF¶|q. l. * TFST. l. TEST. { l {. BAS. l l. .BAS. l l l ! l I. l. Searching Searching Searching Searching TEST. Drive Drive Drive Drive .BAS. A. l. B. l. C. l l. D. 10-D. l. l i. *. THE'*. PAS. l l. I I I 1 l i. LAB?????.PAS. I. 2-16. [ [ l l l l I l. *. I !. I l. l I. Searching Drive a Searching Drive bC Searching Drive Searching Drive d Searching Drive E Searching Drive F LAB2A 13-F .PAS. l l. l I. l l. l. DA}. l l.

(22) COMANDS. Turbo-Plus 1.3 User's Guide LOG. Conunaná. (Continued). The. enables you to log job in a special file.. command. LOG. of. progress. a. the. Syntax I. l i. LOG. I. comments. l. l. Explanation. This command will get the system date, and create a file of the name mrnddyy.LOG if Then does not already exist. willandappend preceded by the itdate comments, time your to the end of the file, as well as printing them on the console.. ít. useful for a job This command is particularly of a .DO running in a batch processor as part LCG commands insert possible is to file. It points in the so that as the at various file can log job passes each critical point, into the file, allowing another progress its user to check on it.. it. Example. !. ] ! I. ioHLQg 10/19/83. I. ·. I. ! I i ! l I I. 09:. =. 12:54. !. STARTING. l. JOB. l I. .. l i. STAPTTNG. I. ·. I. ioHL,Qg. JOB coMPhFTF 10/19/83 10: 23:38. JOB. l. COMPLETE. l l. ioHTYEE. 1M¶í3 TAXI 10/19/83 09: 12:54 10/19/83 10: 23:38. STARTING JOB JOB COMPLETE. I I. IOF} I. ]. 2-17.

(23) Turbo-Plus 1.3 User's Guide. LOGOFF. Command. (Continued). The. LOGOFF. configurations session.. is. command used of TurboDOS to. in multi-user terminate your. Syntax ! I. I I. LOGOFF. i. Explanation. I. The. LQGOFF command sets the user number to a reserved value (31), selects the system drive as the default disk, and makes the TurboDOS function call to log the user off. The user have then, under normal configurations, will WARMSTRT.AUT LOGON.COM, containing the file, loaded, prohibiting automatically, further a has been successful LOGON activity until. accomplished.. there is If the system. a BULLETIN.OFF on user O of file search drive! contents get its The printed on the screen prior to logoff. must have the global attribute set in file order for non-privileged users to receive it. the user logging off has any mail Also, pending, he will receive a message stating so and will be asked whether he wants to log he says no, he remains on the system off. and mayIf receive his mail. (Cf. MAIL Command). if. for user 31 on the system If the library named contains drive also command will "SYSLOG.SYS", then the LOGOFF file automatically record your log-off in that file, and will on display the information going into the file your screen. a. NqjÉql The Turbo-Plus maintained any. SYSLOG.SYS has a format by TurboDOS. which read programs. the normal modified. SYSLOG.SYS. 2-18. maintained by file from different that you are running If file, expecting this. structure, Figure 2-l file.. they. shows. should a. be. typical.

(24) COKKANDS. Turbo-Plus 1.3 User's Guide. (Continued). Example l !. 5C}LQGQEE. l. Logged. I. I. !. Off.... l. 2-19.

(25) Turbo-Plus 1.3 User's Guide. LOGON. Command. COMMANDS. (Continued) There are substantial command and. differences. between as supplied with TurboDOS.LCGON Please read this The command provides section carefully. password-type security inThe multi-user configurations of TurboDOS. purpose of command to prevent unauthorized this is access to the system and to protect private. this. the. LOGON. command. file libraries.. Syntax l. l l. I. LQGON. I. I. Explanation. WARMSTRT.AUT as is 31normally used file system of the disk, rather boot user command. Upon entering than as a explicit you are prompted to enter your user-ID The user-ID is from the console keyboard. validated against the file USERID.SYS in the USERID.SYS is an ASCII text user 31 library.. LCGON. a. on. LOGON,. file. containing entries. userid,. [password],. of the form:. userno[P]Y. [drive],. [access]. "userid" and "password" are up to 8 "userno" is a user in length, characters and "drive" number 0...30, is a drive letter and access The password, drive, A...P. fields are optional.. where. your user-ll) has an If specified in USERID.SYS,. password associated LOGON then. prompts. to enter a password, and validates it. you enter both log-on succeeds only which password and in the user-ID correctly, logged onto the case your console is and the specified specified user number, drive is selected as the default disk. If your entry in USERID.SYS has the user number as a "P", you are logged-on suffix to access "privileged" user, enabling youTurboDOS. various protected facilities of you The. 2-20. if.

(26) Turbo-Plus 1.3 User's Guide. COMMANDS. (Continued) and, field is optional if present, sixteen string between one and bytes long, containing any combination of the A-P. Any letters present indicate letters may have disk drives which The access should be. a. that. to. The. user. should include the system listspool drive and drive, as well as any other drives desired. If the field is absent, the user may access all drives. access. search. 31 the user named SYSLOG.SYS,. If. also contains library then command a. the LCGON record your log-on. automatically. file.. SYSLOG.SYS has a format by TurboDOS. which read programs. NÁKQt. The. Turbo-Plus maintained any. the normal modified. SYSL(JG.SYS. If. user. file. will in that. maintained by file from different that you are running If file, expecting this. structure, 2-l file. Figure. they. shows. should a. be. typical. O search on the system drive contains named BULLETIN.ON, then the contents be printed on the screen. file file will This following successful logon. of announcements facilitates the broadcast The about the system. file must have the global attribute set in order for nona. of that. a. privileged. users. to receive. it.. has any new mail the userid logging a message on the pending, LOGON screen stating: "*** You have new mail ***" W He may then use the MAIL (Cf. MAIL Command) to receive his mail.. If. on. will print Facility. 2-21.

(27) Turbo-Plus 1.3 User's Guide. (Continued). Parameters l. l l. SDRIVE. =. 8. l I I. LOGMSG. =. l. 'x...x'. I l l l I l I I. 2-22. CLSCR. =. l,lA. System searcb drive (1=A, 2=B, etc.). User-specified logon message, terminated with '$' This may be a string of up to 10 bytes for the terminal clear-screen The first byte sequence. specifies the length of the string.. i l l I ! l I l l t i l.

(28) Sample The. structure. of. SYSLOG.SYS. Cqjjjiuj. is: contentq. ÍÁÁSt CQiwán 9. I. Date Time. 18 27 29 34 36 64. li. 20 29 32 36 42. 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 Oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 Oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct 19 oct. Figure 2-l Turbo-Plus SYSLOG.SYS. 83. 06: 51:50 LV 06: 57:26 LV 83 08: 26:14 JG 83 08: 49:36 SKA7 83 09: 28:49 RJ 83 09: 35:31 LV 83 09: 40:31 JG 83 10: 48:47 SKA7 83 10: 49:03 LV 83 10: 49:30 JG 83 10: 52:01 LV 83 11: 03:29 LV 83 11: 03:35 LV 83 11: 05:33 SKA1 83 SKAI 1l: 83 11: 58:59 SKAI 83 12: 00:20 SKAI 83 12: 01:05 JSG 83 12: 36:22 HB 83 12: 58:01 HB 83 12: 58:26 SKA 83 13: 05:43 LV 83 13: 14:21 LV 83 l3: SKAI 83 13: 18:20 SKAI 83 13: 21:16 LV 83 14: 13:41 SKAI 83 14: 23:10 ML 83 14: 42:18 SKAI 83 14: 46:09 JG 83 16: 06:24 RJ 83 16: 50:12 JG 83 17: 04:27 SKA1 83 17: 09:53 RJ 83. 5l:0l. 16:ll. Userid Station Letter User. Number. Drive. Activity (I) (I). (C) (F). (I). 2P. K. 02. ON:. *ú. ON:. 12. E. BP. L *m' K 'U'*. 2P. K. (FI). 12 12 12 12 lOp 12 12 14. E. 2P. K. 2P. K. (P) (E) (A) (F) (H) (F) (C) (C) (G) (F) (C). *m'. P. 2P. (I). ON:. 3P. (A) (C) (F) (A) (C) (A) (A) (A) (F) (F) (F) (G) (H) (H) (II) (A). +'* ***. 10. 12 08 3P. F. 2P. K. 02 E E E E E. 12 12. E. 2P. K. *** *** *** 'u'* *m' m'* *m'. 'n'* *** *'u' m'* *m' *m'. ***. ---------------------. -----ON:. -------------. LOG. OFF. -----. LOG. OFF. GEN PRINTS. ----ON. 9E. ON:. ------. LOG. OFF. -----. LOG. OFF. -----. LCG. OFF. -----. LOG. OFF. -----. LCG. OFF. LOG. OFF. ---------. ON:. ------. ON:. ON:. ------. 12 10. E. u*. ON:. *** ***. OFF. ON:. ON:. 12 02. LCG. ON:. m'*. 3P. OFF. ON:. FI. 'U'* L m'* F m'*. OFF. LOG. ON:UPSYS. 2P. BP. LCG. ON:. u* *'U' *m'. -----. ON:. ON:. ***. OFF. ON:. ON:. m'*. LOG. ON:. m'*. ***. 12. ------. ------. ON: ON:. -----------. 2-23.

(29) Turbo-Plus 1.3 User's Guide. MAIL. Command. COMKANDS. (Continued) The MAIL command enables and receive mail from system.. you. other. to. send. users. mail to on the. Syntax I i ! l. Explanation. I. MAIL MAIL. i !. userid. l. it. userid parameter is optional. is absent, the program will put you into Ifcommand mode, with a prompt of 'Mail>>>'. In this mode, you have eight valid commands: The. d. gives. pending. the. you. a. mail.. directory of all of your The directory includes. letter number, the userid of. unread, date and. time when subject of the letter.. it. a. is '*' sender, if it the. the was. sent,. and. the. L. This will give you a alphabetically, of all the system who have mailboxes.. R. next new letter. will read your appear on the screen will letter header you who sent with telling it, and when The letter will it wasassent. having been read. then be marked. list, users. sorted on the. This. The. a. S. This permits you to send a letter to another user. You will first be prompted for the userid of the person to whom you are sending the letter. be prompted You for the will ofthen subject the letter and for the The letterand mayendedbe letter aborted itself. with control-Q, a. with Kn. 2-24. a. control-E.. command will specified 'n', asnumbers. letter. This. letter number kill by the directory.

(30) Turbo-Plus 1.3 User's Guide. COKMANDS. (Continued). n. This command displays letter number 'n' on the screen in the same format as the enables you to reread 'R' command. has not been killed. old mail which It. H. This displays a brief help menu for the command options. '?' will also produce. X. This takes you out of MAIL, you to the operating system.. A. This is a privileged command. puts sub-command you into an administrative mode, with a prompt of 'Admin>>>', which has the following options:. this. menu.. and. returns. It. C. This and. will. prompt. will. prompt. create specified user.. d. This and. it Q. delete exists.. This. a. you for mailbox. a. userid,. for the. you for a userid, that user's mailbox. if. returns. command mode.. you. to. the. maín. h. This displays a brief help menu for options. the administrative '?' produce menu. this also will. X. This takes you out mail MAIL, and returns you to the operating system.. userid is present in the initial command the program will go directly into send mode, asking you for the subject, and then the remainder of the letter. Upon completion of the letter, you will be returned to the TurboDOS command level.. If line, a. onto the user receiving mail is logged when the mail receive sent, he a You have on his screen saying message where XXXXXXXX the mail from XXXXXXXX', userid of the person who sent the mail. the If system. is. will '***. is. 2-25.

(31) Turbo-Plus 1.3 User's Guide. Error. COMMANDS. (Continued). Messages l l l I l i I l l. I. Corrupt mail directory file Letter number out of range That mail box does not exist That mail box already exists No specified letter number System I/O error file Unauthorized user. { l i I l I !. Parameters l I. SDRIVE. =. Dl. l l l. CLSCR. =. l. l,lA. l l I l l l. ECHAR. =. '"E'. i. System search drive (1=A, 2=b, etc.). This may be a string of up to 10 bytes for the terminal clear-screen The first byte sequence. specifies the length of the string. character used for indicating the end of a letter on input for. The the. l. send. command.. l l I. 2-26. i l I I l l I l I l I l l. I l. l. QCHAR. =. '"Q'. The. used to on input command.. character abort a letter for the send. 1 l l.

(32) Turbo-Plus 1.3 User's Guide ppofttf. comm'ína. COMMANDS. (Continued) The. to. PROFILE add and. file in. user. command. delete a. enables. userid's. menu-driven. privileged users from the system environment.. Syntax I. l l. PROFILE I. I. Explanation. Upon. will. issuing the PROFILE command, the user presented with the following menú:. be. User A D. l e. Identification. Add a System User Delete a System User System Users List Exit Program. All. Enter. If the. a. user,. as. Choice. >>>. specifies choice series of questions follows:. user. asked. Maintenance. 'A',. he. will. about the. be new. I. l. Enter Userid (Max 8 characters): Accn{TNT MYpj'\ss characters): ¡EnterPassword(Optional: lfpresent,max8 I : LO User Number (0-31) Enter [ Is the user to be privileged (Y/N)? N l Drive to log on to (Optional: If present, A-P)? 12 I user to(Optional: lfpresent, combinations Drivestorestrict l of A-P)? ARHI. l. l. exit from this mode, the user must press the return key when prompted for a userid.. To. specifies choice 'D', he will be the userid to delete. Pressing the return key will return him to the main Giving a userid will result in either menu. that userid being deleted, or, if it is not found, an error message being returned.. If. the user prompted for. 2-27. I { l I l i.

(33) Turbo-Plus 1.3 U8er's Guide. COMMANDS. (Continued). If. the. choice the specifies will be displayed 'L', five in file userid, password, user number,. user. USERID.SYS. columns: The program default drive, and access. will and wait for the pause after eacb screenful, return key to be depressed before continuing. the user specifies choice 'E', he will be If returned to the operating system. Error. Messages l [ l I l. l. Duplicate Userid Non-privileged user Userid not present in. There. l. is. no USERID.SYS. I. file. file. l. on the system. l. l. disk. i l. Parameters l l I i I I l [. 2-28. l CLSCR. =. l,lA. This may be a string of up to 10 bytes for the terminal clear-screen. The first byte sequence. specifies the length of the string.. l l i l i l.

(34) Turbo-Plus 1.3 User's Guide RESET. Command. COMMNDS. (Continued) The RESET command which enables you system.. is. privileged. a. to reset. any. station. command on the. Syntax I. l l. RESET. l. RESET. l. station. l l. l. Explanation. if. is optional, and, "station" parameter present, identifies the station to be reset. absent, the program prompts the user for If the station to be reset: "Station to reset (A-P)? ". The user must respond with a valiá station letter or he will be asked again.. The. has been station to be reset the user is prompted for "Okay the question: to verification, xwith(Y/N)?" the reset station says user If that the station is to be reset, then that by the server. station is downloaded If not, he is simply returned to the operating happens. and system,. the determined,. Once. nothing. Example. I. l i. 8L}E=ET. I. Okay 8L}. l. I. C. to reset station. C. {Y/N)?. l. Y. l l. Error. messages. ! i ! I. Note:. You can reset your own user processor [CONTROL _J [CONTROL _] key down and press (Hold the CONTROL. twice). l. Non-Privileged user Illegal Station Letter by. I I. typing. the underline. key. 2-29.

(35) .. Turbo-Plus 1.3 User's Guide. SERVER. Command. COMMANDS. (Continued) The Turbo-Plus SERVER command replaces the TurboDOS commaná of the same name. In a networking configuration of TurboDOS which a has remote the SERVER server console, command allows you to attach your console to. the server processor.. Syntax l l. I SERVER. l. Explanation. I. TPÁs. command attaches your console to the from the server To detach server processor. (and resume normal local console processor operation), enter an Attention-Abort sequence <CTRL-S><CTRL-C>.. While attached to the server, you can make attention requests of the server processor by usina CTRL-A (instead of the usual CTRL-S). In order to use the SERVER command, is that the server operating system be generated with the remote console driver. it. necessary module. j. (CONREM).. Turbo-Plus server command differs from does noe that which replaces because allow more than one user into the server at and keeps once, track of who is in the server for the WHO command. (Cf. WHO Command) you Furthermore, attach to the SERVER while of executing a is in the process job, you will receive a warning giving you the name of the program which is running, so any give that you do not accidentally no job is unwanted console input. If running, you will receive the normal TurboDOS The. it it. it. it. if. it. prompt.. 2-30.

(36) COMMNDS. Turbo-plu8 1.3 UserW. (Continued). Guide. Example. !. { l. I. l. l. I. Console. i l l l l l l. I. attached to server processor. OMBACKUE. I l. Al Bl. !. . .. ! I. .. QA} <CTPTt-S. l I. CTPT,|-C>. l. l. !. l l l. Console 3B}. detached. from. I. server processor. I l. l. Error. Messages I l ! l I. Non-privileged Remote Server. l. user. l. driver not present processor is busy console. I l. 2-31.

(37) Turbo-Plus 1.3 User's guide STATUS. Command. syntax. COMKANDS. (Continued) The. command STATUS enables you to continuously monitor the system status. It a on your screen of who is will maintain list what each currently logged onto the system, of the users is currently doing, and obtain status reports on the system buffers and printers. l l. l l. STATUS. I. Explanation. l. gives. STATUS. activity.. a. report. showing. all system the. updates It then continually specifieá time interval.. report at. a. The. line shows the current the last time the system. header and. time,. date and reset.. was. other line in the report describes one user on the system. It shows what station that user is working on, the userid of that user, the time and date when he logged on, the .COM file which he is currently and the user area from which he executina, A ran that program. star appears to the left of the line displaying the user who typed the command. the server is logged on, shows ofIfthe same information, as well as all the station to which is currently attached. Each. it. it. Below. the the. this. number system.. table, a line appears displaying of I/O buffers currently active in. there is a of each printer running the program, for the station list and from what queue, both local and remote, any, that printer is despooling. if. Finally, defined. Since Turbo-Plus uses the upper eight and printers for its own queues I-P) (i.e. routing purposes, the STATUS report only reports on the lower eight (A-H).. ÉQÉéÁ. 2-32.

(38) Turbo-Plus 1.3 User's Guide. coKlqANDs. (Continued). five seconds, the screen appear.be After cleared, and an updated report will will The program will continue running until aborted with. a. <ctrl-x>. character.. Example I. I. |30F}sTRTITq. I [. I. 13: 21. |Turbo+ l I. Vl.30 - 31-Aug-83 Userid Station. l. A. I. !3. LV BB-0623. C. JG. *. I. F. ml. I. I. RJ. I. Number l l I l l. System. Loc.. Time. 02-J 08-K 30-F 12-D 05-L. 10: 12: 08:. l0:23:42. On. On. Date. SRV. I l. Last. Reset:. of Buffers:. Printers: printer Printer Printer. A: B: C:. 30:13 47:21 52:16. 31-Aug-83 31-Aug-83 31-Aug-83 31-Aug-83 31-Aug-83. ll:ll:ó2 05:15. 15:. 24-Áug-83i I. Process. I. --idle---idle--. I I. SORT. STATUS. l. MBAS. l. COPY. i. 14 l. Queue Queue. A. !. B. I I. Offline. I. Ida}. !. l. l. Parameters. I. l l. TDELAY. =. 5. i l. I i l. [. I I. refreshes.. l l. l. The number of seconds to wait between screen. CLSCR. =. l,lA. I. string of This uptolObytes for the terminal clear-screen may be. sequence.. a. The. specifies the the string.. firstbyte length of. I l I l l l. 2-33.

(39) Turbo-Plus 1.3 User's Guide TWX. Command. COMMNDS. (Continued) The. TWX. command. enables. you. with other users instantly system. onto the. to communicate are logged. who. Syntax i. l. I. twx. I. TWX. l. Explanation. destid destid. i j. message. l. message parameter is optional. If itwithis absent, the program will prompt you a asterisks for each line of multi-line message to send to the specified user. Pressing the return key at the prompt (i.e. a giving null line) will terminate the The. program.. The who. it. destid. parameter. inust. specify. the user. This may be is to receive the message. a station userid, either in the form of preceded by an exclamation mark (e.q. letter, who IA for station A), or ALL, for everybody logged the onto system. is a. and message are both present, If userid send single line message to the will specified userid and automatically terminate. TWX. a. a. will immediately console(s) of the intended a the receiver(s). userid is specified, message will beIf sent to all stations which The the specified userid is logged on to. be message the sent to user never sending will whether or not he is the TWX ALL. specified userid or is a If the user attempts to send a message to a station which he will is not logged onto the system, receive an error inessage. Once a message appear on the. it,. is sent,. it. it. a user receives a message, will be preceded by a header line of the itform "*** FROM srcid: " where srcid is the userid of the does user user sending the message. If isthatrunning TWX he not have a userid, SERVER (i.e. which has an AUTUSR from a station or. When. 2-34.

(40) COMANDS. Turbo-Plus 1.3 User's Guide. (Continued) specified). FROM. or. STAT.. ~**. FROM. the header x: " where x SERVER:. ". line will read "*** is the correct letter, case.. in that. wishes to disable his station from messages while he working, Antybody he may issue the 'TWX .OFF" command. who receive to send hiin a message X has disabled a message To resume messages, receiving messages'. issue the 'TWX .ON' command. a user If receiving. tries. is will. TWX. that 'Station. Examples l. [. l. I. l I I. RI l3F}= *BQNL MfFTTNg. AT *CAN XQSI FLUE AI? RJ 13F}***From. m. I :. YES,. SEE. YOU. THEN. I l. I I l. Error. OMTWX ALL. CQMING. RQWN. IN. 5. 9LLNS. l l. Messages t. I I I I i ) l. l. Station has disabled messages No userid present in command line Userid too long Station unable to receive message logged User is not currently on system. l l l I l. 2-35.

(41) Turbo-Plus 1.3 User's Guide. WHO. Command. COMMANDS. (Continued) The. WHO command enables you to find out who is currently logged onto the system, what each of the users is currently doing, and obtain status reports on the system buffers and printers.. Syntax l I. WHO. I. Explanation. I. gives. WHO. activity. date and was. reset.. a. The. time,. showing report header line shows and. the last. all the. time. the. system current system. Each other line in the report describes one what user on the system. station It shows that user is working on, the userid of that user, the time and date when he logged on, the .COM file which he is currently executina, and the user area front which he A ran that program. star appears to the left of the line displaying the user who typed the command. If the Server is logged on, shows of the saíne information, as well as all the station to which is currently attached.. it. it. Below this the number the cystenn.. table, a line appears displaying of I/O buffers currently active in. of each printer Finally, there is a defined for the station list running the program, both and from what queue, local and remote, if any, that printer is despooling. NQké.t. Since. (i.e. I-P). Turbo-Plus. queues purposes,. and. uses. the. upper. eight. printers for its. own. routing the report only reports on the lower eight (A-H).. 2-36. WHO.

(42) .. ... Turbo-plus 1.3 User's"Guide. CO)Q1ANDS. (Continued). Example l. i. lí2M}WELQ. I. l. I. lTurbo+vl.30-. 31-Aug-83. 16: 37. Last. System. Userid. Loc.. Time. A. ML. I. B. BB-IDLE. I. C. JG. l. f. rj. 12-M 01-H 05-F 08-J. 09: 14: 08: 09:. l. Number. l. Station. l i. l ! I I. On. Reset: Date. l0:23:4224-jan-83! On. SRV. *. of Buffers:. Printers: Printer Printer Printer. A: B: C:. 31-Aug-83 31-Aug-83 31-Aug-83 31-Aug-83. l. TIP. l. WHO. l. -batch-. l. GEN. l. --idle--. I. 14. Offline. Queue Queue. 10:46 23:42 30:13 22:15. Process. I l B. [. A. l I. 2-37.

(43)