User Tools

Site Tools


tutorials:exec

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
tutorials:exec [2022/03/14 03:05]
papa [Using EXEC]
tutorials:exec [2022/03/15 09:41] (current)
papa [Automatic commands]
Line 3: Line 3:
 ====== Using EXEC ====== ====== Using EXEC ======
  
-Similarly to a Unix shell, EXEC presents the user with a simple text-based command line interface. EXEC prints a prompt string (the default prompt is ''@''), after which the user types a command indicating the operation he wishes the system to perform. The command text includes a command name and optionally arguments or switches. Command input is completed by pressing the **Enter** key. EXEC then processes the command, possibly displaying output on the user's terminal. When command processing has been completed, EXEC displays a new prompt to indicate that it is ready for another command. +Similarly to a Unix shell, EXEC presents the user with a simple text-based command line interface. EXEC prints a prompt string (the default prompt is ''@''), after which the user types a command indicating the operation he wishes the system to perform.  
 + 
 +Commands are entered in the form: 
 + 
 +  * command name 
 +  * one or more optional arguments or switches (separated from the command name and each other by one or more spaces) 
 +  * **Enter** key to indicated command input has been completed
 + 
 +(Some commands also allow the input of [[#subcommands|subcommands]].) 
 + 
 +Long commands can be continued to a second line by typing a hyphen (''-'') at the end of the first line, pressing **Enter**, and continuing with command input on the new line. 
 +  
 +EXEC then processes the command, possibly displaying output on the user's terminal. When command processing has been completed, EXEC displays a new prompt to indicate that it is ready for another command. 
  
 EXEC has several features that assist the user in entering commands. EXEC has several features that assist the user in entering commands.
  
-[Put general information on using EXEC here(Completion, guide words, command line editing, help ...)]+===== Command and argument list ===== 
 + 
 +Pressing ''?'' while entering a command will display a list of possible commands, arguments, or description of what argument is expected. 
 + 
 +  * At the EXEC prompt, pressing ''?'' lists all TOPS-20 commands. 
 +  * In the middle of command name input, pressing ''?'' lists TOPS-20 commands beginning with the characters entered so far. 
 +  * Elsewhere, pressing ''?'' lists or describes possible arguments at the current position. 
 + 
 +===== Completion and guidewords ===== 
 + 
 +During command entrypressing **Esc** will complete partial commands and arguments and display //guidewords//
 + 
 +//Guidewords// (also called "noise words") are parenthesized words or phrases that EXEC inserts into the command text to describe the command or the arguments expected. Guidewords are only for documentation and are ignored during command processing. For exampleentering "di**Esc**" at the EXEC prompt will cause EXEC to insert the following characters into the command text: 
 + 
 +  @diRECTORY (OF FILES)  
 +  
 +... and wait for the user to specify what files he wants listed, or press **Enter** to list all files in the current directory. 
 + 
 +===== Abbreviations ===== 
 + 
 +Commands, arguments, and switches can be entered in abbreviated form --- only typing enough characters to be distinguishable from alternatives. For some commands, etc., only one or two characters is sufficient.  
 + 
 +Acceptable non-unique abbreviations have been defined for some commands: 
 + 
 +^ Command ^ Accepted  \\ abbreviation ^ 
 +| CONTINUE | CON | 
 +| CONNECT | CONN | 
 +| EXECUTE | EX | 
 +| EXPUNGE | EXP | 
 +| LOGIN | LOG | 
 +| LOGOUT | LOGO | 
 + 
 +===== Command line editing ===== 
 + 
 +Use the following control keys to edit command text before pressing **Enter** (except for **Ctrl-H**). 
 + 
 +| **Backspace** | Delete last-typed character to the left. | 
 +| **Ctrl-R** | Retype current command line. | 
 +| **Ctrl-U** | Erase current command line. | 
 +| **Ctrl-W** | Erase previous word. | 
 +| **Ctrl-H** | Reprint erroneous command up to error.<sup>*</sup>
 + 
 +<sup>*</sup> When EXEC detects an error in an entered commandit will display a "?" and possibly an error message Pressing **Ctrl-H** will retype at the EXEC prompt the command text up to the location where EXEC detected the error, allowing the user to correct just the erroneous portion and reenter. 
 + 
 +===== Subcommands ===== 
 + 
 +To enter subcommands, type a comma ('','') at the end of the command line before pressing **Enter**EXEC will respond with the subcommand prompt (default ''@@''). Enter a subcommand and press **Enter**, repeating for as many subcommands as you wish to specify. Press **Enter** on a blank line to end subcommand input and EXEC will process the command with the specified subcommands. 
  
 ====== Command Files ====== ====== Command Files ======
Line 33: Line 92:
 | SUBMIT | 1. SYSTEM:BATCH.CMD \\ 2. BATCH.CMD \\ 3. SYSTEM:COMAND.CMD \\ 4. COMAND.CMD | | SUBMIT | 1. SYSTEM:BATCH.CMD \\ 2. BATCH.CMD \\ 3. SYSTEM:COMAND.CMD \\ 4. COMAND.CMD |
 | PUSH | 1. SYSTEM:COMAND.CMD \\ 2. COMAND.CMD | | PUSH | 1. SYSTEM:COMAND.CMD \\ 2. COMAND.CMD |
 +| ATTACH | 1. ATTACH.CMD |
 | LOGOUT | 1. LOGOUT.CMD \\ 2. SYSTEM:LOGOUT.CMD | | LOGOUT | 1. LOGOUT.CMD \\ 2. SYSTEM:LOGOUT.CMD |
  
 When EXEC executes multiple command files, commands in earlier command files may be overridden by commands in later files. For example, during log-in a ''SET PROMPTS'' command in a user's LOGIN.CMD may be overridden in SYSTEM:COMAND.CMD since it is executed later in the sequence. This may be the case if EXEC seems to be ignoring commands in your LOGIN.CMD. Try moving such commands to your COMAND.CMD file, which is executed last in the log-in sequence and will override any conflicting commands in SYSTEM:COMAND.CMD. When EXEC executes multiple command files, commands in earlier command files may be overridden by commands in later files. For example, during log-in a ''SET PROMPTS'' command in a user's LOGIN.CMD may be overridden in SYSTEM:COMAND.CMD since it is executed later in the sequence. This may be the case if EXEC seems to be ignoring commands in your LOGIN.CMD. Try moving such commands to your COMAND.CMD file, which is executed last in the log-in sequence and will override any conflicting commands in SYSTEM:COMAND.CMD.
 +
 +In principle, your LOGIN.CMD file should contain programs you want to run automatically when you log-in and job-wide customizations (DEFINE, SET LOCATION), while your COMAND.CMD should contain local EXEC customizations that you want applied every time EXEC starts for both LOGIN and PUSH (SET DEFAULT, SET PROGRAM, SET PROMPT
 +or PCL declarations).
  
  
  
  
tutorials/exec.1647227100.txt.gz · Last modified: 2022/03/14 03:05 by papa