Editor Profile

#### Search Results

Search

# Editor Profile

Each user has an editor profile with parameters which can be set according to individual needs. The first time you invoke the editor, it uses the default settings determined by your administrator.

The options provided to display and modify your default editor profile settings are described in the following section.

- Displaying and Hiding Profile Settings

- Modifying Profile Settings for Temporary Use

- Modifying Profile Settings for Permanent Use

## Displaying and Hiding Profile Settings

To display or hide the current editor profile settings

1. In the command line of the editor, enter the following:

       PROF

   (See also the `PROF` editor command.)

   The following lines appear at the top of the editing area:

        >> -----------Columns 001 072 <<  Program SAGDEMO  Lines  19     User SAG
       Command ===>                                       Mode   Struct Lib  SAGTEST
       ****** ****************************** top of data *****************************
       =prof> date: 30/01/08 16:07:57 user: MMO      init size: 14 size: 14
       =prof> var   - 250,..recovery off (100 0)...autosave off... empty line off
       =prof> mask off.caps on .hex off  nulls on  std.autoren on  std auto order off
       =prof> log off .mso on .fix off .escape on  + .  tabs off
       =prof> advance on .protect off.limit off

2. You can hide the display of the profile settings by entering the following in the command line of the editor:

       RESET

   The profile settings disappear. The current profile settings are retained.

The individual items of the current editor profile and the editor commands that can be used to temporarily change an item (if modifiable) are described in the following section.

## Modifying Profile Settings for Temporary Use

You can modify your default editor profile settings for the duration of the current editor session or until you change the settings again.

To change your editor profile settings for the current session

- For the profile item you want to change, use the appropriate editor command listed in the following table. For example, enter `CAPS OFF` if you want the text to be translated into upper case.

  The vertical bar used in the syntax of the editor commands separates alternatives. For details on the editor commands listed, refer to Editor Commands.

  Profile Item | Description | Editor Command
  --- | --- | ---
  `date` | Current date and time. Non-modifiable item. | None
  `user` | Current logon user. Non-modifiable item. | None
  `init size` | Number of lines in the source code when the editor was invoked. Non-modifiable item. | None
  `size` | Current number of lines in the source code, excluding information lines (for example profile lines and message lines). Non-modifiable item. | None
  `var` | Current line length. Non-modifiable item. | None
  `autosave` | Activates or deactivates automatic save when the `EXIT` editor command is issued. | `AUTOSAVE`
  `empty line` | Specifies whether lines containing only blank characters are to be deleted automatically. | `EMPTY ON|OFF`
  `mask` | Activates or deactivates the mask line function. | `MASK ON|OFF`
  `caps` | Specifies whether text is to be translated into upper case. | `CAPS ON|OFF|PGM`
  `hex` | Specifies whether characters are to be displayed in hexadecimal format. | `HEX ON|OFF`
  `autoren` | Specifies that automatic renumbering of source lines is activated. Non-modifiable item. | None
  `auto order` | Automatically justifies text within defined boundaries. | `AORDER ON|OFF`
  `log` | Enables or disables the log file. When enabled, the `UNDO` editor command can be used to backout last changes. | `LOG ON|OFF`
  `mso` | Indicates that multiple-session operations are allowed. A multiple-session operation is an operation in which data is exchanged between two editing sessions, for example, when copying text from one object to another in split-screen mode. Non-modifiable item. | None
  `fix` | Specifies whether a fixed number of columns is displayed and how many columns are to be fixed. | `FIX ON|OFF n`
  `tabs` | Activates or deactivates tabulation. | `TABS ON|OFF`
  `advance` | Specifies whether the cursor moves to the next line automatically after a line update. | `ADVANCE ON|OFF|PAGE`
  `protect` | Specifies protection of line numbers. | `PROTECT ON|OFF|INS`
  `limit` | Specifies the maximum number of lines to be searched by a `FIND` or `RFIND` editor command. | `LIMIT n`

## Modifying Profile Settings for Permanent Use

You can use the profile facility of the program editor to change your profile settings not only for the current session as described earlier, but also for future editor sessions. Settings modified with the editor profile facility are valid for each new Natural session or until you change them again. These settings can be overridden for the duration of the current session by using the editor commands described in Modifying Profile Settings for Temporary Use.

To modify your editor profile settings for permanent use

- In the command line of the program editor, enter the following:

      PROFILE

  The Main Menu of the program editor profile facility appears with the following options:

  Option | Function
  --- | ---
  Save | Saves the current profile.
  Modify | Invokes input screens for modifying the default settings for PA/PF keys and editor commands: see Modifying Editor Default Settings.
  Read | Reads the editor profile of another user which you specify in the Profile Name field. The settings from the external profile can then be saved under your profile name.
  Technical Info | Displays information on the object currently being edited and the system environment: see Displaying Technical Information.

This section covers the following topics:

- Editor Profile Commands

- Modifying Editor Default Settings

### Editor Profile Commands

The direct commands and alternative PF keys available in the editor profile facility are described in the following section. You enter a direct command in the command line (Command ===>) at the bottom of the editor profile screen.

Command | PF Key | Function
--- | --- | ---
`CANCEL` | PF12 | Cancels the current modification and displays the previous screens. Any modifications made to the profile have no effect for the current session.
`EXIT` | PF3 | Leaves the current screen and either returns to the previous screen or invokes the EXIT Function prompt window (see also Exit Function).
`FLIP` | None | Toggles between PF1 - PF12 and PF13 - PF24.
`READ` | PF6 | Reads the profile parameters for the user ID currently contained in the Profile Name field. Any modifications made so far, but not yet saved, are overwritten (valid only for the Main Menu).
`SAVE` | PF5 | Saves all currently valid profile parameters both for the current session and on the database. However, it does not leave the current function (valid only for the Main Menu).

### Modifying Editor Default Settings

If you select Modify from the Main Menu or press PF4, the Modify Defaults screen is displayed with the following options:

Option | Function
--- | ---
PA/PF-Keys | Modifies the PA/PF-key assignments: see Displaying and Modifying PA/PF-Key Assignments.
Commands | Modifies the command defaults: see Modifying Command Defaults.
Find | Modifies the parameter settings of the `FIND` command: see Modifying FIND Command Defaults.
General | Enables or disables the EXIT Function prompt window and modifies the number of lines displayed before error line: see Modifying General Defaults.

#### Displaying and Modifying PA/PF-Key Assignments

If you select PA/PF-Keys from the Main Menu or press PF2, the Modify PF/PA-Keys screen is displayed with the current PA/PF-key assignments. To modify a PF-key assignment, replace the name of an existing command (editor command, system command or program name) by another command (maximum five characters).

To modify a PA-key or PF-key assignment

- In the input field next to the required PA or PF key, enter the name of a valid editor or system command, or an existing program. You can enter a maximum of five characters.

The default PA/PF-key assignments for the editor are:

PF Key | Command | Function
--- | --- | ---
PF1 | `HELP` | Invokes the Natural online help facility.
PF2 | `SAVE` | Executes the system command `SAVE` which saves the source code currently in the source work area as a source object in the current library in the current system file. See also Saving and Cataloging Sources.
PF3 | `EXIT` | Exits the editor. See also Exit Function.
PF4 | `RUN` | Checks and runs the program in the editing area.
PF5 | `RFIND` | Repeats the last `FIND` command.
PF6 | `STOW` | Executes the system command `STOW` which saves and catalogs the source code currently in the source work area. See also Saving and Cataloging Sources.
PF7 | `UP` or `-` | Scrolls upwards.
PF8 | `DOWN` or `+` | Scrolls downwards.
PF9 | `CHECK` | Checks whether the source code currently in the source work area contains any syntax errors.
PF10 | `HOME` | Places the cursor in the command line.
PF11 | `UNDO` | Backs out the last change made to the source.
PF12 | `CANCEL` | Exits the editor. See also Exit Function.
PF13 | `PROFILE` | Invokes the editor profile facility.
PF14 | `RESET` | Resets all pending editor and line commands and deletes all line labels.
PF15 | `SWAP` | Toggles the cursor between the upper and lower half of a split screen if split-screen mode is set.
PF16 | `LAST` | Executes the system command `LAST` (see the System Commands documentation) which recalls the last command issued and places it in the command line.
PF17 | `RCHANGE` | Repeats the last `CHANGE` editor command.
PF18 | `FLIP` | Toggles the PF-key display between PF1 - PF12 and PF13 - PF24.
PF19 | `TOP` or `--` | Scrolls to the beginning of the source.
PF20 | `BOTTOM` or `++` | Scrolls to the end of the source.

To modify a PF-key assignment, replace the name of an existing command (editor command, system command or program name) by another command (maximum five characters).

#### Modifying Command Defaults

If you select Commands from the Main Menu or press PF5, you can enable or disable selected editor commands and specify default characters for editor commands. The input fields contained on the screen are explained in the table below. For more information on a specific field, enter a question mark (?) in the field and press ENTER.

Field | Description
--- | ---
aorder | Enables or disables the autoorder function.
autosave | Enables or disables the autosave function.
caps | Specifies whether text is to be translated into upper case.
cols | Specifies whether a line is to be displayed that shows the current column positions.
decimal character | Specifies the character used to mark decimal positions in numbers used in tabs. See also Example 3 - TABS DECIMAL of the `TABS` editor command.
empty | Specifies whether lines containing only blank characters are to be deleted automatically.
fix | Specifies whether the number of columns entered in fixlen (see below) remain in display when scrolling to the right.
fixlen | Only applies if fix (see above) is set to `ON`. Specifies the number of columns starting with column 1 to remain in display when scrolling to the right.
hex | Specifies whether characters are to be displayed in hexadecimal format.
justify | Enables or disables justification or specifies the justification type.
limit | Specifies the maximum number of lines to be searched by `FIND` or `RFIND` editor command.
log | Enables or disables the log file. When enabled, the `UNDO` editor command can be used to back out the last change.
mask line | Enables or disables the mask line function.
message line | Enables or disables message output.
mso | Indicates that multiple-session operations are allowed such as copying between split-screen sessions. Non-modifiable item.
scroll mode | Specifies how scrolling is to be performed (whole page, half page, to cursor).
tabs | Enables or disables tabulation.
tabulator character | Specifies the logical tabulation character used to automatically move input to a specific tab position.

#### Modifying FIND Command Defaults

If you select Find from the Main Menu or press PF8, a screen is displayed with the current parameter settings. These settings are used whenever you issue the `FIND` editor command without parameters from the command line of the program editor. You can modify these values in a window before the search is performed.

The following parameters can be modified:

Parameter | Function
--- | ---
FIND string | Specifies the string to be searched for.
search from/to col | Specifies the start and end numbers of the range of columns to be searched.
search from/to label | Specifies the start and end labels of the marked block of lines to be searched.

#### Modifying General Defaults

If you select General from the Main Menu, a screen is displayed with the current defaults. You can modify these settings as required. A short description of each setting follows:

Option | Function
--- | ---
Prompt Window for Exit Function | Specifies whether a prompt window is to appear when leaving the program editor with the exit function (see the relevant section).
Prompt Window for Cancel Function | Specifies whether a prompt window is to appear when leaving the program editor with the cancel function. See also Exit Function.
Lines displayed before error line | Specifies the number of lines to be displayed at the top of the page preceding the line containing a syntax error. If you specify `0` (zero), the line containing the syntax error is placed in the first line of the editing area.

#### Displaying Technical Information

If you select Technical Info from the Main Menu or press PF7, a screen is displayed with information about the object currently being edited and the computing environment. The following items are provided:

Item | Description
--- | ---
User ID | ID of the current user.
Current library | Name of the library to which you are currently logged on.
Current program | Name of the object currently in the editing area.
Current type | Type of object (for example, program) currently in the editing area.
Object type | Internal type code of the current object.
Mode | Programming mode (see also Mode).
Operating system | Name of the operating system installed.
Steplib | Name of the library concatenated with the current library.

### On this page

- Displaying and Hiding Profile Settings
- Modifying Profile Settings for Temporary Use
- Modifying Profile Settings for Permanent Use