Club Amiga de Montreal

home *** CD-ROM | disk | FTP | other *** search

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 053.lha / manual < prev next >

Wrap

Text File | 1986-11-20 | 42.3 KB | 1,051 lines

* Copyright 1987 by 4th Works, Inc. * * written by Steve Ahlstrom and Dan Moore * * Support for this program to be found on CompuServe's AmigaForum * ----------------------------------------------------------------------------- This program is not public domain. It is a freely distributable copyrighted program with the following conditions: 1) The program and data files must be distributed in the exact form and content as they were found on the original source of distribution (AmigaForum on CompuServe). 2) A seperate file, meant to be incorporated into the manual file, may be included in the distribution ARC file. 3) Any form of commercial sales of this program is specifically denied with the exception of those user groups or entities selling "Public Domain Program Disks". If this program is included in such a collection, the disk containing this program may not sell for more than $8.00 (US currency). ------------------------------------------------------------------------------ #arc Arc ---- Archive utility, Version 0.23 Syntax: ARC {amufdxerplvtc}[bswn][g<password>] <archive> [<filename> . . .] Switches: a = add files to archive m = move files to archive u = update files in archive f = freshen files in archive d = delete files from archive x,e = extract files from archive p = copy files from archive to standard output l = list files in archive v = verbose listing of files in archive t = test archive integrity c = convert entry to new packing method b = retain backup copy of archive s = suppress compression (store only) w = suppress warning messages n = suppress notes and comments g = Encrypt/decrypt archive entry #Help Help -- An online help facility Syntax: Help command_name Inputs: command_name Name of the command or function for which you are seeking help. Example: HELP ARC. Since AmigaDOS is case insensitive, Help is also case insensitive. Copyright 1987 by 4th Works, Inc. This program is not public domain. It is a freely distributable program with the following conditions: 1) The program and data files must be distributed in the exact form and content as they were found on the original source of distribution (AmigaForum on CompuServe). 2) A seperate file, meant to be incorporated into the manual file, may be included in the distribution ARC file. Support for this program to be found exclusively on AmigaForum on CompuServe #Assign Assign - assign a logical device name to a filing system directory. Syntax: ASSIGN [[<name>]<dir>] [LIST] Specification: ASSIGN with no parameter s or with the LIST switch ("ASSIGN LIST") displays all current assignments. To remove the assignment, just give <name> by itself. Example: ASSIGN sources: ram:work/game -- a "CD sources:" will put you in the ram:work/game directory. ASSIGN sources: -- this will remove the assignment of "sources:" to "ram:work/game" #Break Break - set the break flag Syntax: BREAK <task> [ALL] [C] [D] [E] [F] Specification: BREAK sets the specified attention flags in the process. C sets the CTRL-C flag, D sets the CTRL-D flag, etc. AmigaDOS only sets the CRTL-C flag. If the program is not written to look for these attention flags, the process will continue to run until normal termination. Example: BREAK 7 sets the CTRL-C attention flag of process 7. BREAK 5 D sets the CTRL-D attention flag of process 5. BREAK 3 D E sets both CTRL-D and CTRL-E in process 3. BREAK 4 ALL sets all frags in process 4. #CD CD - changes the current default directory or drive. Syntax: CD [<dir>] Specification: CD with no parameters displays the name of the current directory. "CD TEST" will change the current directory to TEST if test exists as a subdirectory in the current directory. If you are in a subdirectory, "CD /" will move you up one level, "CD //" will move you up 2 levels, etc. "CD :" will move you to the root directory of the logged drive. "CD dfn:" sets the current drive to dfn: and the current directory to the root directory of dfn: Example: "CD df1:work" sets the current directory to 'work' on disk 'df1:' and sets current drive to df1:. #Copy Copy - copy a file or directory from one place to another Syntax: COPY [[FROM] <name>] [TO] <name>] [ALL] [QUIET] Specification: Copy places a copy of the file or directory specified as TO. If you specify a directory name as FROM, COPY copies all the files in the FROM directory to the TO directory. The TO directory must exist. If you specify ALL, COPY also copies the files in any subdirectories. It automatically creates subdirectories in the TO directory as needed. Example: COPY FROM file1 TO :work/file2 COPY file1 TO :work/file2 COPY file1 :work/file2 COPY :wrk :work ALL #Addbuffers ADDBUFFERS - adds cache buffers to disk to reduce access time Syntax: ADDBUFFERS <drive> <##> Specification: DOS 1.2 uses disk sector caching in memory to speed up disk accesses. This command allows the user to significantly increase the access times. The amount of available RAM will be decreased by approximately 500 bytes for each buffer added. NOTE: Adding more than 25-30 buffers will not enhance speed greatly. Example: ADDBUFFERS DF0: 12 -- This will add 12 disk cache buffers drive DF0: #Date DATE -- display or set the system date. Syntax: DATE [<date>] [<time>] [TO|VER <name>] Specification: DATE with no parameters displays the currently set system date and time. Time is displayed using a 24-hour clock. The earliest date which can be set is 01-JAN-78. <date> is of the form DD-MMM-YY, with MMM being the first three letters of the month. <time> is of the form HH:MM (i.e. HOURS:MINUTES). Use leading zeros. Example: DATE -- displays the current date and time. DATE 16:30 14-Feb-87 -- set date to Wednesday, Feb. 14, 1987 at 4:30 PM. DATE 16:30 -- set time only to 4:30 PM. DATE 14-Feb-87 -- set date only to Feb. 14, 1987 #Delete DELETE - deletes specified files or directories. Syntax: DELETE <name> [<name> ...] [ALL] [QUIET] Specification: <name> Any file or directory name. Patterns may also be used to specify the filename or directory levels, and/or files. ALL If ALL is specified with a directory name, DELETE will delete all files in that directory and it's subdirectories. Otherwise, a directory must be empty to be deleted. QUIET Do not display names of files being deleted. Example: DELETE work/file1 work/file2 work -- deletes "file1" and "file2" from the directory "work" and then deletes the directory "work". DELETE DF1:#?.txt ALL -- deletes all files on DF1: ending in ".txt". #Dir DIR - display a sorted directory listing. Syntax: DIR [<name>] [OPT A | I | A I | D | K] Specification: Provides a list of the files in a directory in sorted order. <name> Must be a directory name. If omitted, the files in the current directory will be displayed. OPT is a keyword that passes options to DIR. A - option is used to include any subdirectories below the specified one in the list. Each sublist of files is indented. D - when this option is used, only directory names will be listed. Example: DIR -- lists the files in the default directory. DIR DF1: OPT A -- lists all directories, subdirectories, and files on "DF1:" DIR RAM: OPT D -- lists all directory names on "RAM:". #Echo ECHO - displays the text string given. Syntax: ECHO <string> Specification: Echo writes the single string argument to the current output stream, which can be a file or a device. Normally this is only useful within a command sequence or as part of a RUN command. If the string is given incorrectly, an error is displayed. The string must be enclosed in quotes (""). Example: ECHO "" -- this will display a blank line to the screen. ECHO "Please insert the test disk in the internal drive..." -- is a typical prompt for user action from within a command sequence. #BindDrivers BINDDRIVERS - allows user to bind device drivers for new hardware to DOS Syntax: BINDDRIVERS Specification: (usually used as a batch command in the "s/startup-sequence" boot file) This command is used to connect new hardware to AmigaDOS. The way this is done is to bind the device driver software provided with the hardware into Workbench. Then when the user selects the device's icon, DOS will use the driver to access the device. BINDDRIVERS will cause DOS to bind in ANY new drivers that it finds in the directory "SYS:Expansion". Example: Copy the device driver to the "SYS:Expansion" directory. Add the BINDDRIVERS command to the file "s/startup-sequence", which will be automatically executed whenever you boot DOS. #Diskcopy DISKCOPY - copies the contents of one 3.5" diskette to another. Syntax: DISKCOPY [FROM] <disk> TO <disk> [NAME <disk>] Specification: DISKCOPY copies the entire contents of the disk you specified as FROM, overwriting the previous contents of the entire disk specified as TO. If you specify NAME, the new disk is renamed. If needed, the TO disk will be formatted as it is copied. If the TO disk contains data before the DISKCOPY, it will be lost. Once the command is entered, you are prompted to insert the source and destination disks. If you do not specify a <NAME> for the destination disk, the new disk will have the same name. Example: DISKCOPY DF0: TO DF0: NAME "Data" -- copies the disk in drive DF0: using only one drive with new name "Data". #DiskChange DISKCHANGE - indicates that the disk in a 5-1/4" drive has been changed Syntax: DISKCHANGE <drive> Specification: Unlike the Amiga's 3-1/2" drives, which keep checking to see if a disk has been changed in the drive, the Amiga 5-1/4" drive just sits there. It doesn' t let DOS know whether you've swapped disks or not. This command should be used whenever you change the disk in the drive. Example: DISKCHANGE DF3: -- tells DOS that you just swapped the disk in drive DF3: for another one. #Ed ED - a full-screen ASCII text editor (mouse not supported). Syntax: ED [FROM] <name> [SIZE <n>] Specification: A very simple full-screen editor used to create/modify ASCII text files. <name> Specifies the file you wish to edit. If the FROM filename does not exist, AmigaDOS creates a new file. The keyword FROM is optional. SIZE The complete file you are editing is held in memory. The default workspace size i s 40,000 bytes. To alter the workspace, a suitable value (in bytes) is specified after the SIZE keyword. Examples: ED df1:practice/test -- edits the file "DF1:practice/test". ED "My File" SIZE 60000 -- edits a large file named "My File" in the current directory, using a memory workspace of 60,000 bytes (or characters). #Edit EDIT - a line-oriented ASCII text editor. Syntax: EDIT [FROM] <name> [TO <name>] [WITH <name>] [VER <name>] [OPT <option>] Specification: A line-at-a-time editor used to modify ASCII text files. FROM Specifies an existing file you wish to edit. TO TO is the output filename, if different from the input FROM filename. If a TO filename is given, the FROM file is not changed. WITH specifies a file containing EDIT commands to be used in this EDIT session. If WITH is omitted, EDIT will read commands from the the terminal. VER editor messages are output to the file specified. If the VER name is omitted, the output is sent to the terminal. OPT specifies editor options. P# sets the max # of previous lines (default=40). W# sets the max line width (default=120). Example: EDIT Practice/Test TO Practice/Newtest -- edits the file "Practice/Test" the edited result being saved to "Practice/Newtest". "Practice/Test" remains unchanged. #ChangeTaskPri ChangeTaskPri - changes the time-slice priority of the current CLI Syntax: ChangeTaskPri <##> Specification: This command changes the CPU time allocation priority with which DOS treats the current CLI window task. Normal task priority is 0. Priority should be changed to a positive number to increase it and to a negative number to decrease it. The maximum priority values are +127 to -127, but you should keep user tasks between +5 and -5 to avoid interfering with DOS tasks; e.g. Intuition runs at priority 10. Tasks which are run from the changed CLI will also operate at the higher, or lower, priority. Example: ChangeTaskPri 2 -- this will give the CLI task where the command is given, as well as all successive programs running under it, a slightly higher priority than regular tasks. This means that DOS will allocate more CPU time to tasks running under this CLI than others. #DiskDoctor DISKDOCTOR - fixes corrupted disks with soft errors (not defects!) Syntax: DISKDOCTOR <drive> Specification: Whenever a diskette is inserted in a 3-1/2" drive, DOS attempts to verify whether the disk is valid. If DOS fails to validate the disk, it will let you know. So that you don't lose all your information on the disk, you should try to restore the disk using this command. If DISKDOCTOR fails, the error is likely a physical defect! Example: DISKDOCTOR DF1: -- This will temporarily restore MOST of the file structure on DF1:. Your next step will be to format a blank disk and copy all the files from the old disk to the new one using the COPY command. You should reformat the old, restored disk after COPYing off your files. #EndCLI ENDCLI - ends an interactive CLI process. Syntax: ENDCLI Specification: ENDCLI can only be used within a n active CLI window. It closes the CLI window and deletes the process from the list of currently executing tasks. If the CLI was started from Workbench (using the CLI icon), you will be returned to the Workbench. If you used NEWCLI to open the current CLI from a previous one, then you will be returned to that previous CLI. Note that if you do not have Workbench loaded, then ending the startup CLI with no other CLI open gives you no way doing anything else other than rebooting using CTRL-AMIGA-AMIGA. #Run RUN - executes a command as a background process. Syntax: RUN <command> Specification: RUN creates a non-interactive Command Line Interface (CLI) process. The background CLI executes the commands then deletes itself. The new CLI has the same command stack size as the CLI from which you executed RUN. The background CLI commands will be executed simultaneously with commands given in the foreground CLI window. A plus sign <+>, followed by a <RETURN>, i s used to separate multiple commands. However, a better method would be to create a command sequence file (see the EXECUTE command), then RUN EXECUTE the sequence. Examples: RUN "Sample" -- will execute the user application program "Sample" as a background task. #SetMap SETMAP - changes the keyboard definition map being used Syntax: SETMAP <file> Specification: This command let's the user choose a different keyboard setup. Example: SETMAP :devs/keymaps/gb -- sets the keyboard to the keymap for Great Britain. SETMAP usa -- resets to the default USA keymap (resident in DOS, not on disk). #Relabel RELABEL - changes the volume name of a diskette. Syntax: RELABEL [DRIVE] <drive> [NAME] <name> Specification: RELABEL changes the volume name of a disk to the name you specify. Volume names are set when you initialize a disk using Workbench or FORMAT, and may also be changed with Rename [Workbench menu]. The max length is 30. Example: RELABEL df1: "Data Disk Backup" -- gives the name "Data Disk Backup" to the disk currently in drive "DF1:" #Version VERSION - shows the current version numbers for KickStart and for WorkBench Syntax: VERSION Specification: VERSION will display the current version numbers for the KickStart and WorkBench code loaded. For example, KickStart 1.0 has a version number of 29, while the version number for KickStart 1.1 is 31 and if you are using DOS 1.2, the version number for KickStart 1.2 is 33. #Why WHY - explains why the previous command failed (if it did). Syntax: WHY Specification: When a command fails, a brief message that something went wrong is usually displayed on the screen, or else the screen is flashed by AmigaDOS. If you enter WHY immediately after the failure, a message describing in somewhat more detail what sent wrong will be displayed. Example: you've entered: TYPE DF1: Amiga responds: cannot open DF1: you enter: WHY Amiga responds: Last command failed because object not of required type. #Join JOIN - concatenates up to 15 files to form a new file. Syntax: JOIN <name> <name> [<name>...] AS <name> Specification: Each of the specified files is appended to the last in the order listed on the command line and output into the AS file. Example: JOIN part1 part2 part3 part4 AS book -- joins the four files together in the order listed, with the combined file being placed in "book". The four original files remain unchanged. #Fault FAULT - display a message about the fault codes supplied. Syntax: FAULT [<n>...] Specification: AmigaDOS looks up the fault codes and displays the corresponding messages. Up to ten messages may be displayed. Codes must be separated by spaces. Example: FAULT 103 221 218 -- displays the messages for fault conditions 103, 221, and 218. #Format FORMAT - formats and initializes a new 3.5 inch disk. Syntax: FORMAT DRIVE <drivename> NAME <diskname> [NOICONS] Specification: FORMAT prepares a disk for use by AmigaDOS. DOS 1.2 Addition: NOICONS will prevent a Trashcan icon from being added. DRIVE Under DOS 1.2, any existing drive or partition is valid. NAME can be any string; if it includes spaces, the whole string must be enclosed in quotes <"">. Example: FORMAT DRIVE df1: NAME "1986 Taxes" -- formats and initializes the disk in drive DF0: with the name "1986 Taxes". FORMAT DRIVE df2: NAME Data001 NOICONS -- formats the 5-1/4" floppy disk drive DF2: with name "Data001" with no Trashcan icon. #Alink ALINK - Links together sections of code into an executable file. Syntax: ALINK [FROM|ROOT] <filename> [{, <filename> ...} | {+ <filename> ...}] [TO <name>] [WITH <name>] [LIBRARY|LIB <name>] [MAP <map>] [XREF <name>] [WIDTH <n>] Specification: Links sections of compiled or assembled AmigaDOS object code together into executable program files. Handles automatic library references and builds overlay files. The output from ALINK is a file in the proper form to be loaded by the loader and, if necessary, run under the overlay supervisor. Example: ALINK FROM libs/Lstartup.o+myobj TO myprog LIB libs/mylib -- links the files "libs/Lstartup" and "myobj", and produces the output file "myprog". External references will be searched for in "libs/mylib". ALINK myprog.o TO myprog WITH link-parms -- creates the executable program "myprog" from the object file "myprog.o", using additional parameters supplied by the file "link-parms". #Assem ASSEM - Assemble a program written in MC68000 assembly language. Syntax: ASSEM [PROG|FROM] <source filename> [-O|TO <object filename>] [-V <message file>] [-L <list file>] [-H <header file>] [-I <include list>] [-C|OPT <option>] [-E] Specification: To use this command, you first must purchase the MC68000 assembler. The MC68000 assembler is not provided with the Workbench disk. This command produces a linkable object file from a text source code file written in MC68000 assembly language. For information on parameters and flags, see ASSEM_FLAGS. Example: ASSEM myprog TO myobj -L mylist -V mybugs -H myhdr -I includes/myincl1.i+ includes/myincl2.i+intuition/myincl3.i+dos/myincl4.i OPT -S -D -X -- will assemble "myprog", including header code in "myhdr", into object file "myobj", with listing in "mylist" including a cross-referenced global symbol table, and with error messages in "mybugs". #ASSEM_FLAGS ASSEM_FLAGS - description of flags and parameters used by ASSEM. Parameters which may be set are: -O or TO <object file> the assembler will not produce any binary object code unless this parameter is provided. -L <list file> produces a list file containing both source and the corresponding object code. -V <message file> save warnings and error messages to a file -H <header file> use to include a source code header file -I <include list> a list of paths to files listed as INCLUDE files within the source file. -E <equates file> generates a header file containing the EQU directive assignments in the source file -C <options> one or more option "switches" may be specified or OPT <options> to the assembler, as follows: -S produce a complete list of symbols during assembly. -D restrict the -S switch output to Global symbols only. -C ignores the case of labels -W <width> sets the size of the assembler workspace. -X produces a cross-referenced symbol table listing. #Execute EXECUTE - executes a file of commands (similar to batch files). Syntax: EXECUTE <sequence> [<argument>...] Specification: EXECUTE allows you to perform a complex , pre-programmed sequence of AmigaDOS commands. (For those already familiar with MS-DOS or PC-DOS, it is the same as a .BAT batch file.) A command sequence is a list of DOS commands which will be executed sequentially. There are several AmigaDOS commands which are intended specifically for use in such sequences. Many commands will require parameters (arguments, switches, etc.) that are unknown ahead of time. EXECUTE allows you to include variable parameters which are filled in when the sequence is executed. Many AmigaDOS commands are specific to EXECUTE command files, they include: IF ELSE ENDIF FAILAT QUIT SKIP LAB WAIT ECHO Example: EXECUTE install -- executes a script program named "install". #Syntax: FAILAT <n> Specification: When a command fails, a non-zero return code is set. A return code greater than or equal to the fail limit terminates a sequence of non- interactive commands. The return code indicates how serious the error was and is usually: 5 (warning), 10 (error), or 20 (fatal). The FAILAT command is used to alter the default value fail level of 10. The argument should be a positive integer. Upon exit from the command sequence, the fail level is reset to the default value of 10. If the return code value is increased, it indicates that certain classes of error should not be regarded as fatal and that execution of subsequent commands may proceed after an error. The FAILAT command should be used BEFORE the commands that will be tested for failure. If you use FAILAT without an argument, the current value of the current fail limit will be displayed. #FileNote FILENOTE - attaches a comment or a note to a file. Syntax: FILENOTE [FILE] <file> [COMMENT] <string> Specification: COMMENT adds an optional comment of up to 80 characters. If the comment contains embedded spaces, it must be enclosed in quotes <"">. When a new file is created, it does not have a comment. If you overwrite an existing file that has a comment, the comment is retained, If a file with a comment is copied with the command COPY, the new file will not have the comment from the original. Example: FILENOTE program1 "Version 2.1 July 4, 1987" -- attaches the comment "Version 2.1 July 4, 1987" to the file "program1". If the LIST command "LIST program1" is used, the result will be a two-line listing of the file as follows: program1 1341 rwed Today 12:36:51 :Version 2.1 July 4, 1987 #If IF - allows conditionals within a command sequence. Syntax: IF [NOT] [WARN | ERROR | FAIL | {<string> EQ <string>} | {EXISTS <name>}] Specification: NOT processing should occur only if the test following fails. The command MUST be followed by one of the following tests: WARN TRUE if the immediately prior command returned a code >= 5. ERROR TRUE if the immediately prior command returned a code >= 10. FAIL TRUE if the immediately prior command returned a code >= 20. <string> EQ <string> ... tests the exact equality of two strings. <string> EXISTS <name> .......... TRUE if the file <name> exists in the specified directory (may be part of <name>). ERROR is meaningful only if you set FAILAT to greater than the default 10. FAIL is only meaningful if FAILAT is set to greater than 20. Nested IF's are terminated by the nearest enclosing ENDIF in the sequence. The optional ELSE may provide an alternative if the specified conditions are not met. The conditions and commands in IF and ELSE statements can span several command lines before their corresponding ENDIFs. Indentation is permitted. #Info INFO - displays a report on mounted disk devices. Syntax: INFO Specification: Information about each mounted disk device is given as follows: Unit.... the disk device name Size.... total space on the disk (in Kbytes, typically 880K) USED.... disk space allocated to files & subdir's (in 512-byte Blocks) Free.... available free space on the disk (in Blocks) Full.... the % space now used (i.e. USED/Size) Errs.... number of soft disk errors detected Status.. Read/Write or Read Only Name.... the disk volume name #Install INSTALL - makes a formatted disk bootable. Syntax: INSTALL [DRIVE] <drive> Specification: <drive> the drive containing the formatted diskette to be installed. An INSTALLed disk can be inserted at the Workbench prompt (after KICKSTARTing the Amiga) to "boot" the system. The only possible drive names are DF0:, DF1:, DF2:, and DF3:. No files are copied to the disk during installation. If you want to be able to execute AmigaDOS commands after booting, you must copy the "c" subdirectory from your Workbench disk onto the disk you have INSTALLED. You will probably also need the other workbench directories as well. Example: INSTALL DF1: -- makes the disk in drive "df1:" a bootable disk. To add all the Workbench files to the disk, you would use the COPY command. #List LIST - list specified information about a directory or file. Syntax: LIST [DIR] <dir> [P|PAT=<pattern>] [KEYS] [DATES] [NODATES] [TO <name>] [S <string>] [SINCE <date>] [UPTO <date>] [QUICK] Specification: LIST with no options will display: filename size protection date time :comment There are three options for the <dir> argument to the DIR keyword: (1) if a filename is specified, information for that file will be displayed; (2) if a directory name is given, the file information for all files and subdirectories within that directory will be displayed; (3) if the <dir> argument is omitted, information about files and subdirectories within the current directory will displayed. Other LIST options available: P <pattern> searches for files whose name matches the specified pattern. KEYS displays the block number of each file header or directory. SINCE <date> displays only the files last update ON OR AFTER <date>. UPTO <date> displays only files last updated ON OR BEFORE <date>. #MakeDir MAKEDIR - creates a new subdirectory. Syntax: MAKEDIR <dir> Specification: MAKEDIR creates a directory with the name you specify. Only one directory can be created at a time, so if you wish to create a subdirectory within a directory, that parent directory must exist or be created first. The directory will not be created if a directory or file with the same name already exists in the directory above it in the heirarchy. You can, however, have two with the same name within two different directories. Example: MAKEDIR :map -- creates a directory named "map" in the default root directory. MAKEDIR DF1:sheets -- creates a directory "sheets" in on drive DF1:. MAKEDIR "DF1:budget/work sheets" -- creates a subdirectory "work sheets" the parent directory "budget" on drive DF1:. The directory "budget" must already exist. #Mount MOUNT - install a new hardware device name into DOS (not WorkBench) Syntax: MOUNT <devicename> Specification: This command installs a new hardware device into DOS's device tables. In most cases, the hardware will be supplied with a mounting disk containing a "mountlist" file which must be added to the file "SYS:devs/Mountlist". The default Mountlist file on your DOS disk contains an example device specification for a 5.25" disk drive and for a serial device (the handler is NOT supplied for the example). You will probably include MOUNT commands in your "s/startup-sequence" boot file. This will install the devices at power-up. Example: (1) Copy the device handler to the "l:" directory. (2) Add the device's mountlist to the "SYS:devs/Mountlist" file. (3) Add the command "MOUNT <device-name>" to the file "s/startup-sequence". #Prompt PROMPT - changes the prompt in the current CLI. Syntax: PROMPT [<prompt>] Specification: The prompt is set to the string you supply. The special character combination <%N> in the prompt string is displayed as the CLI's process number. If a parameter is not given, the prompt is reset to the standard string "%N> ". Note the space included after the > symbol! Example: PROMPT -- resets the current prompt to "%N> ". PROMPT "Current Process is #%N. Command? " -- resets the CLI prompt to "Current Process is #n. Command? " where n is the current process number. If the CLI's process were #4, the resulting prompt would appear as: Current Process is #4. Command? _ The underscore character above is positioned where the cursor would be. #Read READ - download development files over serial or parallel port. Syntax: READ [TO] <name> [SERIAL] Specification: This command allows the user to download specially formatted files over the serial or parallel port. If SERIAL is specified, then data is read at the current Preferences data speed. Otherwise data is read from the parallel port. The file to be downloaded must be converted into the format of a two-digit hex code for each byte in the file BEFORE it is read. Use the CONVERT command supplied with your cross-development system. Example: On the IBM-PC: CONVERT <PROGRAM >PROGRAM.OUT then transfer it to the Amiga at 9600 bps. On the Amiga, you enter: READ DF1:PROGRAM SERIAL, then start output from the IBM-PC. #Rename RENAME - changes the name of a file or directory. Syntax: RENAME [FROM] <name> [TO|AS] <name> Specification: RENAME changes the name of the FROM file or directory to the specified TO name. If you already have a file with exactly the same name as the TO file, RENAME won't work. RENAME can also be used to MOVE a file into another directory. RENAME cannot be used to change the case of the letters in a file name; (i.e. "RENAME jones TO Jones" will not work). Example: RENAME Demo1 Demonstration -- changes the name of the file "Demo1" to "Demonstration". The contents of the file remain the same. #Quit QUIT - exit from a command sequence with a given error code. Syntax: QUIT [<returncode>] Specification: QUIT exits the current command sequence with a error return code. The default return code is zero. Example: IF WARN QUIT 20 ENDIF If the last command was in error (code >=5), this terminates the command sequence with return code 20. #Protect PROTECT - sets a file's protection status. Syntax: PROTECT [FILE] <filename> [[FLAGS] <status>] Specification: The keyword FLAGS has four options: <rwed>, where... r = read e = execute w = write d = delete If a flag is set, that option is NOT protected. If it is omitted, then protection is set. The keyword FLAGS itself is optional; omitting it does not change the effect of the command. To check the current protection status of a file, use the LIST command. Example: PROTECT report1 r sets the protection status of "report1" as read only. PROTECT report2 resets all the protection flags of the file "report2" to unprotected. #Skip SKIP - perform a jump in a command sequence. Syntax: SKIP <label> Specification: SKIP is used in conjunction with LAB. SKIP will read through the command file looking for a label you defined with LAB, without executing any commands. SKIP will only jump forward in the command sequence. SKIP can be used with or without a label. Without one, it finds the next unnamed LAB command. With one, it will look for a LAB defining the specified label. LAB must be the first item on a line of the file. If SKIP does not find the label you specified, the sequence terminates and the following message is displayed: "label "<label>" not found by Skip." Example: SKIP used alone jumps to the next LAB command that does not have a name following it. #NewCLI NEWCLI - opens a new interactive CLI process and creates a console window for input and output. Syntax: NEWCLI [<window>] [FROM <startup-file>] Specification: A new CLI window is created, which becomes the currently selected process. Each CLI window is independent, allowing separate & nearly simultaneous input, output, and program execution. Example: NEWCLI -- creates a new CLI process in a window of default size & location. NEWCLI "CON:20/30/300/100/Tom's Custom CLI" -- The quotes <""> around the window argument allows the title to contain spaces. NEWCLI FROM ExecFile [ DOS 1.2 ONLY! ] -- this will open a default CLI window, and will begin EXECUTEing "ExecFile". #SetDate SETDATE - updates the date and time assigned to a file or directory Syntax: SETDATE <file> <date> [<time>] Specification: This command let's the user set the date and time of a file. <file> the filename to receive a date change. <date> a date specified in the standard Amiga format: ##-LLL-##, where: the first two digits are the month; (1-9) must be 01-09; the second three letters are the month code; the last two digits are the year; <time> this is the time in 24-hour format: ##:##, representing hours and minutes. Example: SETDATE TempFile 01-Jan-88 13:07 -- this sets the date and time on file "TempFile" in the current directory. #Path PATH - specifies which directories to search in for CLI commands Syntax: PATH [SHOW] | [ADD <dir>,<dir>,...] | [RESET <dir>,...] Specification: When a DOS command is given in the CLI, the current directory is searched for the command. If the command isn't found, the next directory in the path will be searched. Ultimately, the "c:" directory is searched. <dir> this is a directory name, including drive or disk name if needed. SHOW this option will display the current path. ADD this mutually exclusive option lets you add the specified directory or directories to the current path. RESET this option, also mutually exclusive, lets you remove the specified directories from the current path. If no directory is supplied, the path is reset to the default DOS path: Current Directory, C: Example: PATH ADD DataFiles,Utilities -- adds the directories "DataFiles" and "Utilities" to the current command search path. #Search SEARCH - looks for a text string in all the files in a directory. Syntax: SEARCH [FROM] <name>|<pattern> [SEARCH] <string> [ALL] Specification: <name> a filename, including directories; <pattern> a generalized form of filename specification SEARCH looks through the FROM file (or, if only a directory is specified, all files in that directory) for occurences of the SEARCH string. If ALL is added, then all the subdirectories contained in the specified directory are searched. When the SEARCH string is found, the line where it occurred is displayed. As each file is being searched, its name is displayed to the screen. The search is non-case sensitive. Example: SEARCH SEARCH "Test #86" -- searches the default directory for file containing the string "Test #86". #Sort SORT - alphabetically sorts a specified file. Syntax: SORT [FROM] <name> [TO] <name> [COLSTART <n>] Specification: WARNING: If the file is longer than about 150 records (lines) , you should increase Stack size. Estimate an additional 1000 bytes of Stack for each additional 50 records (lines) in the file. Does a simple, ascending-order, alphabetic sort of the FROM file into the TO file, without distinguishing between upper and lower cases. Each record in the file to be sorted must end with a carriage return. COLSTART this keyword can be used to specify the first column where the comparison will take place. Example: SORT Pre-Registered TO "Class Roster" COLSTART 16 -- "Pre-Registered" is a list of students with first names in columns 1-15 and last names beginning in column 16. In this example, the names would be sorted in order of last names, with each group of identical last names being subsorted by the first name. #Stack STACK - sets the stack size for commands. Syntax: STACK [<size>] Specification: When a program is run, it uses a certain amount of stack space. The normal stack size is 4000 bytes, which is sufficient in most cases. When using some programs, you may need to increase the stack size to prevent a crash. To do this, type STACK followed by the new stack size in bytes. A value from 8000 to 10000 is usually adequate. STACK alone displays the currently set stack size. WARNING: The only indication that you have run out of stack is that the Amiga crashes. It is better to overestimate if you are not sure. Example: STACK -- displays the current stack size. STACK 16000 -- sets the stack size to 16000 bytes. #Status STATUS - displays information about existing CLI processes. Syntax: STATUS [<process>] [FULL] [TCB] [SEGS] [CLI|ALL] Specification: STATUS without any parameters lists the numbers of the CLI processes and the program tasks running in each. <process> specifies a process number and only gives information about that process. Otherwise, information is displayed about all processes. FULL = SEGS + TCB + CLI flags SEGS displays the names of the sections on the segment list of each process. TCB displays information about the priority, stacksize, and global vector size of each process. CLI or ALL identifies Command Line Interface processes and displays the section name(s) of the currently loaded command. Example: STATUS 4 FULL -- displays full information about task #4 in the current CLI window. #Type TYPE - type a text file, or type a file out as hexadecimal numbers. Syntax: TYPE [FROM] <name> [[TO] <name>] [OPT N|H] Specification: TO <name> with this optional keyword, you can send the output of the TYPE command to a specified file. If an output file is not specified the output is usually sent to current window. OPT this keyword lets you specify one of two available options: N ... line numbers will be included in the output. H ... each byte will be output as a hex number, as well as ASCII. If Example: TYPE sales/report1 -- displays the text file "report1" in the subdirectory "sales" TYPE program1 program1hex OPT H -- writes out the code stored in "program1" in hexadecimal and ASCII and stores it in the file "program1hex". #Wait WAIT - wait for a specified amount of time. Syntax: WAIT <n> [SEC|SECS] [<m> MIN|MINS] [UNTIL <time>] Specification: WAIT can be used in command sequences or after RUN to wait for a certain period, or to wait until a certain time of day. The waiting time is one second unless you specify otherwise. The keywords SECS and MINS may follow or precede the amounts. Use the keyword UNTIL to wait until a specific time of day, given in the format HH:MM. Example: WAIT -- waits one second. WAIT 15 -- waits for 15 seconds. WAIT 30 MINS -- waits for 30 minutes. WAIT UNTIL 14:30 -- waits until 2:30 p.m. #