Using the Code Frame Editor

A code frame is the basic building block of a model. It provides a rudimentary outline of the code generated by the model. Code frames may contain condition codes to generate blocks of code conditionally. They may also contain subprograms used to generate more complex blocks of code.

This section describes how to access and use the Code Frame editor. The following topics are covered:

• Access the Code Frame Editor

• Features of the Code Frame Editor

Access the Code Frame Editor

There are three methods you can use to access the Code Frame editor. These methods are:

• From the Administration Main Menu

• From the Command Line

• From the Maintain Models Panel

From the Administration Main Menu

To access the Code Frame editor from the Administration main menu

1. Type "F" in Function.

2. Press Enter.

   The Code Frame menu is displayed. For example:

   CSMMAIN N a t u r a l C o n s t r u c t CSMMNM0 Jul 05 Code Frame Menu 1 of 1 Functions ----------------------------------------------- E Edit Code Frame S Save Code Frame L List Code Frames P Purge Code Frame C Clear Edit Buffer H Print Saved Code Frame ? Help . Return ----------------------------------------------- Function ........... _ Code Frame ......... ________ Description ........ _____________________________________________ Command ............ __________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- help retrn quit main

   For information about the functions available through this menu, see Code Frame Menu Function.

3. Type "E" in Function.

   Tip:
   To edit an existing code frame, type the name of the code frame in Code Frame before accessing the Code Frame editor.

4. Press Enter.

   The Code Frame editor is displayed. For example:

   Code Frame ......... SIZE Description ........ FREE 61361 > > + ABS X X-Y _ S L ....+....1....+....2....+....3....+....4....+....5....+....6....+....7.. T C ....+....1....+....2....+....3....+....4....+....5....+....6....+....7.. T

   For information about modifying the supplied code frames, see Edit Code Frame.

From the Command Line

You can also access the Code Frame editor from the Natural Next prompt (Direct command box for Unix).

To access the Code Frame editor from the command line

1. Logon to the SYSCST library.

2. Enter the following command:

   MENU F E/framename/framedescription

From the Maintain Models Panel

You can also access the Code Frame editor from the Maintain Models panel.

To access the Code Frame editor from the Maintain Models panel

1. Access the Administration main menu.

   For information, see Access the Administration Main Menu.

2. Enter "M" in Function.

   The Maintain Models panel is displayed.

   Note:
   For a description of this panel, see Maintain Models Function.

3. Move the cursor over the code frame you want to edit.

4. Press PF4 (frame).

   The specified code frame is displayed in the Code Frame editor.

   Note:
   For information about editing code frames, see Edit Code Frame.

Features of the Code Frame Editor

The following example shows the CSLC9 code frame in the Code Frame editor:

  Code Frame ......... CSLC9                                          SIZE 29281
  Description ........ Browse-Select* model subroutines               FREE 29520
  >                                              > + ABS X X-Y _ S 408  L 1     
  Top...+....1....+....2....+....3....+....4....+....5....+....6....+....7.. T C
    *                                                                           
    * Subroutines (in alphabetical order).                                      
    *                                                                           
    CHECK-WILD-CHARACTER                                                       1
    ***********************************************************************    "
    DEFINE SUBROUTINE CHECK-WILD-CHARACTER                                     "
    ***********************************************************************    "
    *                                                                          "
    * Check for wild characters in the input key and                           "
    * reset minimum and maximum values for the key accordingly                 "
    RESET #WILD-CHAR #LAST-POS                                                 "
    FOR #WINDX = 1 TO 3                                                        "
      EXAMINE #INPUT.#CHAR-ARRAY(*) FOR                                        "
             CDWILDA.#WILD-CARD-CHARS(#WINDX) GIVING INDEX #FIRS-POS(#WINDX)   "
    END-FOR                                                                    "
    /* Find the first wild character                                           "
    FOR #WINDX = 1 TO 2                                                        "
       IF #FIRS-POS(#WINDX) = 1 THRU #FIRS-POS(#WINDX + 1) OR                  "
    ....+....1....+....2....+....3....+....4....+....5....+....6....+....7.. T

The Code Frame editor supports all generic Natural edit commands except the RUN, CHECK, TEST, STOW, and SAVE commands. This editor has no line numbers, but it does have two extra fields to the right of the edit area: T (Type) and C (Condition). Natural Construct uses these fields to control the generation process for each code frame.

The fields in the Code Frame editor are

This section covers the following topics:

• Use Commands in the Code Frame Editor

• Change the PF-Key Profile for the Current Session

• Save the Contents of the Edit Buffer

• Create GUI Sample Subprograms

Use Commands in the Code Frame Editor

This section describes how to use commands in the Code Frame editor. The following topics are covered:

• Order of Command Execution
• Line Commands
• Edit Commands
• Positional Edit Commands

Order of Command Execution

The Code Frame editor executes commands in the following order:

1. Processes text modifications.

2. Executes line commands.

   These commands are specified in the text area of the editor and are preceded with a period (.E, for example).

3. Executes edit commands.

   These commands are specified at the > prompt (ADD, for example).

Line Commands

Within the Code Frame editor, you can issue line commands to copy, move, and delete lines of code. Line commands must be entered in the first column position of a line in the edit area (not at the > prompt) and must begin with a period (.).

If the direction indicator is + (indicating from top to bottom), the copied, moved, or inserted lines are placed below the line on which the command is entered. If the direction indicator is - (indicating from bottom to top), the lines are placed above the line on which the command is entered.

The line commands applicable in the Code Frame editor are:

Edit Commands

Edit commands are specified at the command prompt (>). These commands are:

CHANGE 'scanvalue'replacevalue'

SCAN 'scanvalue

SCAN scan value

Positional Edit Commands

If the code frame in the edit buffer is too large to be displayed in its entirety on the panel, you can issue edit commands at the command prompt (>) to scroll through the code:

Change the PF-Key Profile for the Current Session

You can change the PF- and PA-key settings, the number of updates before an automatic save, and the name of the recovery member. Any changes to the current profile take effect immediately and remain in effect for the duration of the current edit session. These changes do not affect the Natural edit profile.

To change the PF-key profile for the current session

1. Enter "PROFILE" at the > prompt in the Code Frame editor.

   The Maintain Current PF-Key Profile window is displayed. For example:

   CS-PROF Natural Construct CS-PRFM0 Jun 20 Maintain Current PF-Key Profile 1 of 1 PF1 = -______________ PF2 = T______________ PF3 = B______________ PF4 = -H_____________ PF5 = +H_____________ PF6 = +P_____________ PF7 = N______________ PF8 = _______________ PF9 = Q______________ PF10= _______________ PF11= _______________ PF12= _______________ PF13= _______________ PF14= _______________ PF15= _______________ PF16= _______________ PF17= _______________ PF18= _______________ PF19= _______________ PF20= _______________ PF21= _______________ PF22= _______________ PF23= _______________ PF24= _______________ PA1 = _______________ PA2 = SCAN___________ PA3 = _______________ Auto save numbers ............ In member .......... EDITWORK Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11- help retrn Changes DO NOT affect your edit profile outside Construct

   This window displays the various settings in effect for the current edit session. The PF-key settings for the Natural Construct editors are determined in the same manner as those for the Natural editor. If you have a profile that corresponds to your user ID, Natural Construct will use those defaults.

2. Change the settings as desired.

   The fields in this window are:

   Field	Description
   PF-nn or PA-n	Functions assigned to the PF- and PA- keys. You can add new functions by typing a command next to the desired key, or modify existing functions by typing a new command over the one displayed.
   Auto save numbers	Number of updates allowed before the source is automatically saved. If this field is blank or 0 (zero), Natural Construct does not automatically save work.
   In member	Name of the program that is overwritten each time the specified number of updates is exceeded (by default, EDITWORK). To change the name of the program, type a new name over the one displayed. If this field is blank, Natural Construct does not automatically save work.

Save the Contents of the Edit Buffer

The Natural Construct editors can automatically save work in the edit buffer after a certain number of updates. The number specified in Auto save numbers in the Maintain Current PF-Key Profile window determines how often the work is saved. If this field is blank, Natural Construct does not automatically save work. You can also use In member in the Maintain Current PF-Key Profile window to specify the name of the recovery member where you want your work saved.

To recover edits, the value in Auto save numbers must not be blank or 0 (zero) and the value in In member must be specified. For information, see Change the PF-Key Profile for the Current Session.

To retrieve lost code

1. Access the Code Frame editor.

   For information, see Access the Code Frame Editor.

2. Read EDITWORK into the edit buffer (or whatever name you specified as your recovery member name in the Maintain Current PF-Key Profile window).

3. Re-specify the description, as it is not saved in the recovery member.

Create GUI Sample Subprograms

Sample subprograms are invoked from a user exit. These subprograms help the developer create user exit code by providing a starting sample. The GUI sample subprogram is a client version of the mainframe sample subprogram — minus the input statements. When Natural Construct generates a model on the client, it bypasses the mainframe sample subprogram and reads the GUI sample subprogram instead.