DOCUMENTATION CHANGES FOR: RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER PART NUMBER 069-400015-01 THIS FILE (FILENAME 069400015.01) CONTAINS INFORMATION THAT AFFECTS THE FOLLOWING PAGES OF YOUR MANUAL: 2-8 2-9 10-48 THIS SECOND REVISION OF 069400015.01 WAS UPDATED ON JANUARY 12, 1989. TO KEEP YOUR MANUAL CURRENT, YOU SHOULD DO EITHER OF THE FOLLOWING: O MARK THE AFFECTED PAGES OF YOUR MANUAL SO THAT YOU WILL KNOW TO REFER TO THIS FILE FOR ADDITIONAL INFORMATION. O PRINT THIS FILE, PUNCH HOLES TO FIT YOUR BINDER, AND INSERT THE PAGES INTO YOUR MANUAL. COPYRIGHT (C) DATA GENERAL CORPORATION, 1983-1989 ALL RIGHTS RESERVED LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER, 069-400015-01 12/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 2-8 REPLACE THE DESCRIPTION OF RDOS CONTROL CHARACTERS IN TABLE 2-1 WITH THE FOLLOWING MATERIAL: CTRL-C FIRST CHARACTER OF A TWO-CHARACTER INTERRUPT SEQUENCE. INTERRUPT SEQUENCES ARE ECHOED BUT NOT PASSED INWARD AND RESULT IN THE SPECIAL ACTIONS DESCRIBED BELOW. (1) CTRL-C CTRL-A TERMINATE CLI EXECUTION FROM A FOREGROUND OR BACKGROUND TERMINAL AND RETURN TO THE NEXT HIGHER-LEVEL PROGRAM (USUALLY THE CLI). (2) CTRL-C CTRL-B SAME AS ABOVE, BUT FIRST WAIT FOR TASK I/O TO COMPLETE, AND CREATE A BREAKFILE OF THE CURRENT MEMORY IMAGE CALLED BREAK.SV (BACKGROUND) OR FBREAK.SV (FOREGROUND). CTRL-C CTRL-C ECHOED, BUT NO ACTION TAKEN. CTRL-C CTRL-D SPECIAL INTERRUPT USED BY INTERACTIVE COBOL. CTRL-C CTRL-F TERMINATE A FOREGROUND PROGRAM FROM THE BACK- GROUND CONSOLE, RELEASING FOREGROUND DEVICES AND DIRECTORIES. CTRL-C CTRL-X RESERVED. CTRL-I OR TAB PASSED INWARD; ECHOED LITERALLY IF ECHOING ALLOWED. CTRL-J OR NL (3) PASSED INWARD; ECHOED LITERALLY IF ECHOING ALLOWED. CTRL-L OR FF CLEAR A CRT SCREEN; TERMINATE A COMMAND LINE. PASSED INWARD; ECHOED LITERALLY IF ECHOING ALLOWED. CTRL-M OR CR (3) PASSED INWARD; ECHOED LITERALLY, FOLLOWED BY A NEW LINE, IF ECHOING ALLOWED. CTRL-Q RESUME TERMINAL OUTPUT SUSPENDED WITH CTRL-S. NOT PASSED INWARD; NOT ECHOED. RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER, 069-400015-01 12/JAN/89 DOCUMENTATION CHANGES, REVISION 02 CTRL-S SUSPEND TERMINAL OUTPUT. (RESUME WITH CTRL-Q.) NOT PASSED INWARD; NOT ECHOED. CTRL-Z CLOSE A FILE BEING CREATED FROM THE TERMINAL WITH THE XFER/A COMMAND. END-OF-FILE CHARACTER. PASSED INWARD; ECHOED. ESC PASSED INWARD; NOT ECHOED. <36> NOT ECHOED. THE DRIVER IS PLACED INTO A SPECIAL MODE AND CHECKS SUBSEQUENT CHARACTERS TO DETER- MINE WHETHER THIS IS A FUNCTION KEY OR A SPECIAL SEQUENCE GENERATED BY THE TERMINAL (SUCH AS THE RESPONSE TO A MODEL ID REQUEST). <37> THE FIRST BYTE OF THE THREE-BYTE RESPONSE TO A READ CURSOR ADDRESS. ECHOING IS DISABLED DURING THE SEQUENCE; THE SEQUENCE IS THEN PASSED INWARD. (1) CONTROL CHARACTERS ARE PASSED INWARD BY THE CONSOLE DRIVER TO ANY PROGRAM THAT IS PERFORMING A READ FROM THE CONSOLE. IF ECHOING IS TO BE PERFORMED, THE DRIVER ECHOES THE CONTROL CHARACTER AS A CARET FOLLOWED BY A PRINTABLE CHARACTER. FOR EXAMPLE, A CTRL-A IS ECHOED AS ^A. (2) TWO-BYTE CTRL-C SEQUENCES ARE TYPICALLY USED TO INTERRUPT PROGRAMS. WHEN THE DRIVER SEES AN INTERRUPT SEQUENCE, IT TAKES ONE OF THE FOLLOWING ACTIONS, WHETHER OR NOT THE PROGRAM HAS A READ FROM THE CONSOLE OUTSTANDING. A) IF THE SECOND CHARACTER OF A CTRL-C SEQUENCE IS A CTRL-A, -B, -C, -D, -F, OR -X, THE ACTIONS DESCRIBED IN THE TABLE ARE TAKEN. B) IF THE SECOND CHARACTER OF A CTRL-C SEQUENCE IS A CTRL-I, -J, -L, -M, -Q, OR -S, OR IF THE SECOND CHARAC- TER IS NOT A CTRL CHARACTER, THE DRIVER HANDLES THE SECOND CHARACTER AS IF THE CTRL-C WERE NEVER ENTERED (THE CTRL-C ITSELF IS NOT PASSED INWARD). C) IF THE SECOND CHARACTER IS A CTRL CHARACTER THAT IS NOT COVERED BY RULE A OR B ABOVE, IT IS ECHOED BUT NOT PASSED INWARD. (3) THE DRIVER WILL SWAP THE CODES FOR CARRIAGE RETURN AND NEW LINE, UNLESS THE CONSOLE IS OPENED IN BINARY MODE. RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER, 069-400015-01 12/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 2-9 THE FOLLOWING MATERIAL RELATES TO THE DEL (RUBOUT) KEY DISCUSSED IN TABLE 2-2. THE DEL KEY IS ECHOED ON A CRT AS BACKSPACE-SPACE-BACKSPACE (OCTAL VALUES 31-40-31). RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER, 069-400015-01 12/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 10-48 REPLACE PAGES 10-48 AND 10-49 WITH THE FOLLOWING MATERIAL: DO UTILITY EXECUTE COMMAND FILES, REPLACING DUMMY ARGUMENTS WITH SPECIFIED ARGUMENTS SYNTAX DO {FILENAME [ARGUMENT...]} {/H } DESCRIPTION THE DO UTILITY EXECUTES COMMAND FILES--GROUPS OF CLI COMMANDS AND THEIR ACTUAL OR DUMMY ARGUMENTS--REPLACING DUMMY ARGUMENTS WITHIN THE FILES WITH THE ARGUMENTS YOU SPECIFY ON THE COMMAND LINE. PLACING A GLOBAL /H SWITCH ON THE COMMAND LINE CAUSES DO TO DISPLAY A HELP MESSAGE. THE UTILITY REQUIRES THAT ALL LINES IN THE COMMAND FILE AND ALL LINES OUTPUT TO (F)CLI.CM CONFORM TO STANDARD .RDL/.WRL FORMATS; LINES CANNOT EXCEED 132 CHARACTERS AND MUST CONTAIN A TERMINATOR. DUMMY ARGUMENTS A DUMMY ARGUMENT IS A USER VARIABLE HAVING THE FORM %N%, WHERE N IS A NUMBER (N CANNOT BE A 0). THE DO UTILITY CAN HANDLE UP TO 512 DUMMY ARGUMENTS IN A SINGLE COMMAND FILE. YOU MIGHT USE A DUMMY ARGUMENT IN A COMMAND LINE IN THIS WAY: PRINT %1% IF YOU SUPPLIED A FILENAME ARGUMENT SUCH AS THISFILE, THE COMMAND LINE WOULD EXPAND TO READ: PRINT THISFILE RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER, 069-400015-01 12/JAN/89 DOCUMENTATION CHANGES, REVISION 02 SUPPLYING THE ARGUMENTS ON THE DO COMMAND LINE DO USES THE FIRST ARGUMENT YOU SPECIFY ON THE COMMAND LINE TO EXPAND DUMMY ARGUMENT %1%; THE SECOND ARGUMENT ON THE COMMAND LINE CORRESPONDS TO DUMMY ARGUMENT %2%, AND SO ON. IF A PARTICULAR DUMMY ARGUMENT APPEARS MORE THAN ONCE IN THE COMMAND FILE, DO REPLACES THE DUMMY ARGUMENT WITH ITS CORRESPONDING ACTUAL ARGUMENT EACH TIME IT APPEARS THROUGHOUT THE COMMAND FILE. IF YOU SPECIFY FEWER ARGUMENTS ON THE COMMAND LINE THAN EXIST IN THE COMMAND FILE, DO REPLACES THE LEFTOVER DUMMY ARGUMENTS IN THE COMMAND FILE WITH NULLS. YOU CAN SPECIFY A NULL ON THE COMMAND LINE BY USING THE NUMBER SIGN, #, AS AN ARGUMENT. FOR EXAMPLE, THE FOLLOWING LINE EXISTS IN THE COMMAND FILE PRINTIT.DO: PRINT %1% %2% %3% THE DO COMMAND LINE DO PRINTIT.DO FILE1 FILE2 FILE3 CAUSES THE LINE TO EXPAND TO: PRINT FILE1 FILE2 FILE3 THE DO COMMAND LINE DO PRINTIT.DO # FILE2 CAUSES THE LINE TO EXPAND TO: PRINT FILE2 EXAMPLE 1. THE FOLLOWING EXAMPLE DISPLAYS THE CONTENTS OF THE COMMAND FILE CLOSEDIR.DO, WHICH CONTAINS A DUMMY ARGUMENT, %1%, THAT ALLOWS CLOSEDIR.DO TO WORK FOR ANY DIRECTORY YOU SPECIFY. R TYPE CLOSEDIR.DO MESSAGE CLOSING DIRECTORY %1% DIR %1% DELETE/V -.BU MESSAGE PRINTING DIRECTORY %1% LISTING ON THE PRINTER LIST/S/A/E/L RELEASE %1% R RDOS, DOS, AND DG/RDOS COMMAND LINE INTERPRETER, 069-400015-01 12/JAN/89 DOCUMENTATION CHANGES, REVISION 02 EXAMPLE 2. THE FOLLOWING COMMAND LINE CAUSES THE CLI TO EXECUTE THE COMMAND FILE CLOSEDIR.DO AND SUPPLIES AN ARGUMENT FOR DUMMY ARGUMENT %1%. R DO CLOSEDIR.DO PROGS CLOSING DIRECTORY PROGS DELETED TEST1.BU DELETED FOO.BU PRINTING DIRECTORY PROGS LISTING ON THE PRINTER R --END OF UPDATE FILE--