INed Editor User's Guide

Chapter 10. Running AIX and Filter Commands

You can run AIX commands either by putting the file you are editing on hold while the command runs or by running the command in a box. Filters are programs that take standard input, transform it in some way, and write to standard output. For example, you can use filter commands to replace specified text in a paragraph or file or to sort text into alphabetic or arithmetic order.

How to Run AIX Commands and Filter Commands from the INed Editor

You can use the following procedures with INed editor subcommands:

To Run AIX Commands

Press the F2 key (the Menu function).
The editor displays the New Task menu. The New Task menu lets you run operating system commands without leaving the editor.
Move the cursor to one of the following options, and press the Ctrl-A, Enter key sequence (the Execute function):
- Execute AIX shell commands.
- Run an AIX Shell Command within a Box.
  Note: Always select the Execute AIX shell commands option if:
  - The command requires a response.
  - You want to use the operating system command to make changes in the file you are editing.
  - You want to save the file you are editing before running the operating system command.

If you select the Execute AIX shellcommands option, the editor displays the message Saving file (the wording of this message may vary) and displays a shell prompt. Enter an operating system command or commands at the shell prompt. Press the Ctrl-D key sequence (the shell command to exit) to resume editing.

To Run AIX Commands in a Box

If you select Run an AIX Shell Command within a Box option, the editor displays the Shell command box. Type an operating system command in the box and press the Ctrl-A, Enter key sequence (the Execute function). The editor displays the message Executing and, when the command completes, displays the results of the operating system command in a box. If the command has no output, the editor displays the message No output.

Note: You can also run an operating system command in a box by pressing the Ctrl-A, Enter key sequence (the Enter function), typing the command in the ENTER box, and pressing the F2 key (the Menu function). The editor displays the message Executing (the wording of this message may vary) and displays the results in a box.

To Run Filter Commands

Press the Ctrl-A, Enter key sequence (the Enter function), and type the filter command in the ENTER box.
Filters are commands that change files. For example, the rpl command is the INed editor filter command to replace text in a file. Some other useful operating system filter commands are the nl, sort, and tr commands. You can also use many other operating system commands as filters. For more information on commands, see Editor Commands.
Press the Ctrl-A, X key sequence (the Do function).
The editor uses the following conventions when it runs a filter command:
- Only the text from the cursor line to the end of the paragraph is affected, unless you specify otherwise. The end of a paragraph is a blank line or a line beginning with a . (period).
- Text beyond the current paragraph must be specified as follows:
  - Enter the number of paragraphs to change, a space, and then the filter command.
  - Enter the number of lines to change followed by an l (lowercase letter L), a space, and then the filter command.
- When you enter a filter command, it remains effective until you enter a new filter command or exit the editor. To rerun the most recently entered filter command, press the Ctrl-A, X key sequence (the Do function). To display (but not run) the most recently entered filter command, press the Ctrl-A, Enter key sequence (the Enter function) and then the Ctrl-A, X key sequence (the Do function).
- Filter commands can contain several parameters. Separate parameters with a space. If a parameter contains a space or a special character, use ' (single quotation marks) or " (double quotation marks) to enclose the parameter.
- If you press the Ctrl-A, X key sequence (the Do function) and run an operating system command that is not a filter command, the output of the command replaces the text from the cursor to the end of the current paragraph. For example, you can use the operating system cat command to replace text with text from another file. (If you want to add the text, but not replace the current paragraph, you can run the cat command at a blank line.)
- If the filter command produces no output, the paragraph is removed.
To stop a filter command before it completes processing, press the Ctrl-C key sequence (the Break function). The editor displays a message like Filter stopped. If the command completes before you press the Ctrl-C key sequence (the Break function), the operation is not canceled or undone.
Note: Some keyboards have Break engraved on the top of a key. This key does not necessarily issue the Break function.

To Perform a Simple Sort or Sort Numerically

Put the cursor on the first line you want to sort, and press the Ctrl-A, Enter key sequence (the Enter function).
To perform a simple sort, type sort in the ENTER box.
To sort numerically, type the following in the ENTER box:
```
sort -n 
```
The sort command has other flags that you can use to sort lines.
Press the Ctrl-A, X key sequence (the Do function).

The editor displays the sorted lines in ascending or arithmetic order.

To Replace Text from the Current Line to the End of the Paragraph, by Paragraphs, or by Lines

Press the Ctrl-A, Enter key sequence (the Enter function).
To replace text from the current line to the end of the paragraph, type the following in the ENTER box, and press the Ctrl-A, X key sequence (the Do function):
```
rpl OldText NewText 
```
where OldText is the text you want to replace and NewText is the new text.
To replace text by paragraphs or by lines, type the following in the ENTER box:
```
Number rpl OldText NewText 
```
where Number is either the number of paragraphs or the number of lines you want to search, OldText is the text you want to replace, and NewText is the new text.
Text can consist of either one word or a phrase. For example, you can replace the word priority with the phrase order of importance. Use the following guidelines when you type text for the rpl command:
- Capitalization is important. For example, typing cheryl does not change the words Cheryl or CHERYL. The rpl command contains information on how to search for uppercase or lowercase letters and other pattern-matching symbols.
- Blanks are important. For example, if you replace the with a (with no blanks before and after the), words such as them and other become am and oar.
- Separate single words with a blank. For example, to change ski to sky, type the following:
```
rpl ski sky
```
- Enclose phrases with " (double quotation marks). To change sky to blue sky, type the following:
```
rpl sky "blue sky" 
```
- Delete text by entering two " " (double quotation marks) following the text to be deleted, also enclosed in double quotation marks. To delete blue sky, type the following:
```
rpl "blue sky" ""
```
- Replace text throughout a file by going to the top of the file and using at least the number of lines in the file to search and replace. If the file contains 550 lines, replace blue sky with gray sky by typing the following:
```
551 rpl "blue sky" "gray sky"
```
- Only phrases that are on the same line are changed. If blue is the last word on one line and sky is the first word on the next line, the phrase blue sky is not changed.

Related Information

The cat command, nl command, rpl command, sort command, tr command in AIX Version 4.3 Commands Reference.

INed Overview introduces general concepts about the INed editor, lists the INed editing functions and describes the system guidelines for using the INed editor.

INed Editor Functions for the Standard Keyboard is a table that shows the INed editor command keys on a standard keyboard.

INed Editor Files in AIX Version 4.3 Files Reference contains reference information about the files used by the INed editor.

Editor Commands contains a list, with brief descriptions, of the editor commands.