Ú--ÄÄÄÄÄÄ--ù-ù--ùú ú ú úù--ù-Ä-Ä-Ä-ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ--ÄÄÄÄÄÄÄÄÄ¿ ³ oSúSiMuLaToR PPE - coded by FiRST MuTaNT ù ù version 1.0 - for PCBoaRD 15.1+ ù released june-20-1994 ú ú[MTNT] [MTNT]ù À-ù---ÄÄÄÄÄÄÄÄÄÄÄ-Ä-Ä-ù-ù-Ä-Ä-ùúù---ùù-ú ú úÄ--Ä-Äùúú ú ú--Ä-Ä--ÄùÄ--ù-Ä--ÄÙ Ú--=iNTRoDuCTioN=---ù-Äú-ÄÄÄÄÄÄÄ--ÄÄ---ù-¿ À--ùú úù---ÄÄ-Äùúúù-úú--Ä-Ä--ÄùÄ--ùú úù-ÄÙ Simulates: - DOS - UNIX - Every possible text-based self-made OS...!! Supports: - INTERNAL COMMANDS - DIRECTORIES - ALSO WORKS LOCAL Ú--=DiSCLaiMeR=ÄÄ-ÄÄ-Ä-Äú-ÄúùÄÄÄ--ÄÄ---ù-¿ À--ùú--ÄÄ---ÄÄ-Äùù-ù-úú--Ä-Ä--ÄùÄ--ùúÄù-ÄÙ If this ppe messes up your system, we are NOT responsible for any damage to you or your system! We DISCLAIM all responsibility for this ppe! ÚÄ-=FReeWaRe=ÄÄÄÄÄÄ----ù-ù-ÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÀÄ-ÄÄÄ-ùÄùú ú úù-úù úù-úú--Ä-ÄÄÄÄÄÄÙ This product is FREEWARE. Use it and distribute it, wherever you want. You can get source-codes at your request, by calling our dist-site... (see .NFO file) If you use sources of mine, please mention me in your program. [FiRST MuTaNT] Ú--=WHaT Do Ya NeeD?=--ù-Äú-ÄÄÄÄ--ÄÄ---ù-¿ À--ùú úù---ÄÄ-Äùúúù-úú--Ä-Ä--ÄùÄ--ùú úù-ÄÙ If everything went wel you have recieved the zipfile 'MTNT_DS1.ZIP', this zipfile contains the following files: ¯ DOSSIM.PPE - The program ofcoz! ¯ DOSSIM.DOC - What do ya think?! ¯ EXAMPLE.ZIP - An archive with an example ready to use! ¯ MUTANT.NFO - Information file about THe MuTaNT ¯ FILE_ID.DIZ - File description ¯ MUTANT.ANS - Little ansi add ÚÄ-=iNSTaLaTioN=úù-ù-ÄÄÄÄÄÄÄÄùÄú-ù-ÄÄÄÄÄÄ¿ ÀÄ-ÄÄÄÄÄÄÄÄÄÄ-Äùú--Ä--úù-úú--ÄùÄ--ù--úù-ÄÙ To start this ppe, you create a directory "C:\PCB\PPES\DOSSIM" and you put all the files in there. Next you change line 259 of your pcbtext.dat into "!C:\PCB\PPES\DOSSIM\DOSSIM.PPE" (without the quotes off course). Also change line number 148 into "!C:\PCB\PPES\DOSSIM\WAIT.PPE" If you try getting into pcboard as a user, you will see: "Shelling to DOS...", and you will get a prompt. How to change all of this I'll explain later. Now you're in the dos-simulator. You can perform these commands: dir, cls, ver, cd. All of these commands can be changed off course... I have provided the skeletton for a dos-simulator.... It's up to you to fill it in !! But: don't be afraid... To get you started I've made a (rather basic) dos-simulation, which you find in the example.zip file!! Study it, and have fun !! Most of the example ppe's are also more or less configurable... As you will see, there are a lot of files in the examples. This was necessary to make it as flexible as it is. May I be excused for that. I do not take responsibility for damage, loss of data or whatever caused by this ppe. If you use it, you use it at your own risk. If you cannot agree with this, don't use it. I got the idea by seeing the "PRODOS", coded by Baphomet. Nice proggie, but not configurable! Greetinx to ALL. :) Ú-ù=CoNFiGuRaTioN=ÄÄ-Ä-Äú-ÄúÄÄÄÄ--ÄÄÄÄÄÄÄ¿ À-ÄÄÄÄ-ÄÄ-Ä-ÄÄ-Äù--ù-ú-Ä-Ä--ÄùÄ--ù-ÄÄÄÄÄÄÙ BEWARE: CONFIG-FILES MUST BE TYPED IN CAPITALS!!! 1. Layout of the several configuration files. For not too experienced users of pcboard, I'd recommend to make a backup before you start. You can influence the working of the program by changing the config (.CNF) files. 1.1. DOSSIM.CNF I'll give a short description of each line... Line 1: File containing "Shelling to Dos"-message Line 2: File containing "Bad command or filename"-message Line 3: File containing current-directory (internal use) Line 4: File containing root-directory Line 5: File containing startup-dirctory Line 6: File containing internal commands Line 7: File containing directory setup (default: dir.cnf) By changing the file found in line 4, you can specify a new root directory. This is the directory in which a "cd .." command will not be possible. By changing the file found in line 5, you can specify in what directory you would like to begin. Imagine you have made a root directory "C:\" and a subdirectory "C:\DOS", and you would like to start in "C:\DOS", you would have to change the contents of the default-directory-file into "C:\DOS". (No quotes, no backslash) 1.2. Directory setup: DIR.CNF Line 1: Integer indicating number of directories in the file Line 2: String indicating name of directory 1. (e.g. C:) Line 3: cnf-file for the dir (e.g.C:\PCB\PPES\DOSSIM\ROOT.CNF) Line 4: String indicating name of directory 2.(e.g. C:\DOS) Line 5: String indicating config-file for the directory Line 6: ... 1.3 Directory cnf: e.g. ROOT.CNF Line 1: File: where dossim finds the prompt for that dir Line 2: Integer: number of dir-display-files. (Needed when redefining the dir command...) Line 3: File: display-file 1 Line 4: File: display-file 2 Line 5: ... Line a: Number of commands available in this dir only. Line b: name of command (CAPITALS!) Line c: name of ppe to execute (CAPITALS!) Line d: see line b Line e: see line c ... 1.4. Internal commands: e.g. internal.cmd Line 1: Integer indicating number of commands in file Line 2: String: command 1 (CAPITALS!!) Line 3: String: ppe to execute (CAPITALS!) Line 4: see 2 Line 5: see 3 ... 2.0. Redefining commands. It is possible to add/redefine ALL of the existing commands by writing your own ppe-files, and adding them to the right .cnf files. Off course this implies having the pplc-compiler, and some programming experience. PPL is a lot like basic, so not difficult at all. :-) Your first experiment could be making the dir-command work with options like /w or /p or whatever... 2.1. SPECIAL CASE: the login command. Login command is a special case, because the dossim.ppe has to stop there, and go on with pcboard. I didn't want to make it a hard-coded command, to let you change it. But you'll have to follow these simple rules to make it work. 1) Make sure the file 'AFTER', located in the same directory as dossim and login contains the word 'GO' followed by a CR (chr(13)) after your login program ends. 2) Stuff the name of the user, then a CR, and his password, followed by a CR into the keyboard buffer, and then END the login ppe. 3) Make sure all the controlling (name exists? password correct?) is done inside your ppe, to avoid errors from pcboard. 2.2. Special case: the apply command. You will have to follow the same rules as with the login command... Before you END the apply ppe, put everything you are going to stuff in the keyboard in a file, and stuff it with "kbdfile", else you'll have problems!! BEWARE: My example apply-command assumes that "alias is not allowed" (you can put an alias in the real name area) and that "one name users are allowed". This has to be set in pcbsm!! 3. Defining commands that require arguments. E.g. "cd dos" or "dir /w" Dossim scans your input and does this: - it strips all spaces before the first other character - it strips all spaces after the last non-space-character - it splits the result after the first space, "\", ".", "/" or "-", uses the first part of the split-operation as command, and saves the second part of the split-operation as argument in the (internal used) file "ARGUMENT". If the first character was a space, it is stripped, the "\", ".", "/" and "-" characters remain... To make it very clear: e.g. " CD DOS\NEWUSER " would result in: -command: "CD" -argument: "DOS\NEWUSER" " CD\DOS\NEWUSER " would result in: -command: "CD" -argument: "\DOS\NEWUSER" "CD.." would result in: -command: "CD" -argument: ".." BEWARE: The cd command I've supplied is especially designed to be used with MS-DOS simulations. (It assumes "\" to be the separation character) 4. Examples. 4.1. I want to add a new directory to the system. How and where do I change the config-files? Suppose you have this system: C:\ ÃÄÄÄDOS ÀÄÄÄNEWUSER and you want to make a directory in the DOS-directory called HELP. Then you proceed as follows. 1) You edit the directory-config-file (to be found in dossim.cnf, line 7) as follows: - add 1 to the number of directories (=line 1) - go to the rule just behind the last rule in the file (=a new line) - add the name of your directory. Because the cd-command assumes an MS-DOS simulation, you are bound by DOSïs rules. NO BACKSLASH AFTER THE NAME !! (If you've made your own CD-command by writing a new ppe, you can choose your own rules off course.) This name has nothing really to do with the prompt that is displayed by the program. It's for internal use only. (e.g. C:\DOS\HELP) - go to the next line and add the path+name of the config- file for your new directory. (e.g. C:\PCB\PPES\DOSSIM\HELP.CNF) 2) Make your own dir-config-file, in this case: help.cnf as follows: - The first line contains the prompt-file for the directory. (e.g. C:\PCB\PPES\DOSSIM\HELPPRMT.DAT) This file contains the prompt that will be displayed by dossim while in the directory. (e.g. C:\DOS\HELP>^Z) - The next line contains an integer indicating the number of display-files being used. This number will normally = 1 unless you make your own dir-command which could need more than one display-file. (e.g. difference dir/w and dir/p) - The next lines contain (off course) the names of these display-files. If you make your own dir-command you can also create a config-file for that dir-command in which you can place everything you need. In that case you won't have to change any of this in help.cnf. (pffew, quite complicated, not?) - The next line contains the number of commands which can only be accessed from this directory. (e.g. 1) - Then you always have two lines in which you specify: - name of command (e.g. README) - ppe to be executed (e.g. C:\PCB\PPES\DOSSIM\README.PPE) 3) So, if we summarize you become: directory-config-file (normally dir.cnf): 4 C: C:\PCB\PPES\DOSSIM\ROOT.CNF C:\DOS C:\PCB\PPES\DOSSIM\DOS.CNF C:\NEWUSER C:\PCB\PPES\DOSSIM\NEWUSER.CNF C:\DOS\HELP C:\PCB\PPES\DOSSIM\HELP.CNF help.cnf: e.g. C:\PCB\PPES\DOSSIM\HELPPRMT.DAT 1 C:\PCB\PPES\DOSSIM\HELP.DIR 1 README C:\PCB\PPES\DOSSIM\README.PPE in HELPPRMT.DAT you could set: C:\DOS\HELP>^Z [control-z is the end-of-file character=chr(26)] result: if you are in the help subdir. you will get help by typing the command "README". (Off course you will have to write README.PPE first...) BEWARE: You will probably have to adjust the DOS.DIR-display- file so it indicates that there is a subdir. named HELP. If you don't, HELP will be a "Hidden"-directory, off course. 4.2. I want to start up in C:\DOS instead of in my C:\. Just change the contents of your default-dir-file (normally default.dat). ÚÄ-=ouTRoDuCTioN=--ÄÄÄ-ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÀÄ-ÄÄÄÄ-ù-úù-ùú-----úù-ÄÄ--ÄùÄ---ù-ÄÄÄÄÙ If you still can't figure out how this (quite simple I thought) system works, ask someone who is smarter than you!! I recommend to use it a while as is, until you become a bit familiar with the way it works... After that it shouldn't be too difficult to adjust it to all your needs... If you have Comments/Questions or you see Bugs/Improvements, please report them, so I can work on it. THX. -=FiRST MuTANT / [MTNT] JuNe'94=- ÚÄ-=SuPPoRT=--úù-ù-ÄÄÄÄÄÄÄÄùÄú-ù-ÄÄÄÄÄÄ¿ ÀÄ-ÄÄÄÄ-ù-úù-ùú--Ä--úù-úú--ÄùÄ-----ÄÄÄÄÙ If you have questions, problems, during installing or configuring this PPE you can always contact me on the WHQ or write me a message on one of the following boards: - THe MuTaNT BBS, WHQ (if ya have the numba!!) - Depths of hell - HAWKMOON - Fun-derbird/Neo Tokyo - Carrier of Belief Read the MUTANT.NFO for more information about this group. -=MuTaNT LeaDeR / [MTNT] Mai'94=-