Editor Execution

Sunbelt's text file editor is executed with the following command:

SUNEDIT is the name of the particular edit command executed (refer to operating system specifics appendices for exact name). {filename1} is required and is the name of the file to be edited. {filename2} is optional and is the name of the edit definitions file (:0 through :9 commands). {filename3} is optional and is the name of an alternate screen definition file. {opts} is optional and designates whether to append to the delete file. Each is explained below:

Parameters:

filename1

Input file name to the edit procedure. If a drive is not entered, the first occurrence (searching logged on drives) is used. If the file does not exist, the editor asks the operator if the file is to be created. The file is created on the current user drive. 'PLS' is used as the assumed extension if a file extension is not given. The default extension may be overridden by specifying the PLBCMP_EXT keyword in the environment table or program information file (INI). The input file is not modified until the 'end' command is given.

filename2

Edit definitions file. It is often desirable to have a sequence of commands defined for all edit procedures. This may be accomplished with the definitions file. Any macro commands that are entered into this text file are loaded at execution time and immediately available for usage during that edit. If {filename2} is not given, EDIT.DEF is assumed.

filename3

The editor interfaces with the various CRTs and their operating systems through the screen definition file. If operating in a multi-user environment, each user may have a terminal type that would require a different set of screen control definitions. By using the third file name, a separate screen definition file may be loaded. It is still necessary for the file SUNSCRN.DEF to be present on the logged drive when loading the editor. The new screen file is loaded upon execution of the edit program.

opts

The following are the only valid parameters:

E

Edited files are normally written in space compression mode (using the standard operating system tab character). The 'E' option causes the file to be written in non-compressed mode.

P

Enter page edit mode and clear all tab stops upon initialization of the edit.

X

Enter shift inversion upon loading the editor.

Two modes of operation are supported, PAGE edit mode or LINE edit mode. In both cases, the entire screen displays the data and any data displayed on the screen may be modified. The primary difference is that during PAGE edit, modifications and commands are initiated with the function keys and are made in place. During LINE edit mode, a command is entered to tell the editor what sequence you wish to execute. In PAGE edit mode, the line upon which the command is executed is indicated by the current cursor position. In LINE edit mode, the current line is indicated by the '>' character in the first position of that line.

See Also: SUNEDIT, Utilities