Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

@Properties

Program

KeyDescription
TypeThe kind of object this file compiles to (Program).
NameProgram name.
DescriptionProgram description. Maximum 50 characters: it ends up in the TEXT parameter of the compile-time CL commands (CRTBNDRPG/CRTDSPF/CHGPFM), which has that real limit on IBM i (see E00281).
Print ModePrint mode, for a report-style program.
CommitmentWhether this object (Program or Screen) runs its modified tables under commitment control. Overrides the project’s Commitment (@GeneratorConfig) only for this object. Values: True/False. Required by the Commit/Rollback statements.
Commit on ExitWhether this object (Program or Screen) issues a final commit before finishing; in a Screen, when the screen is closed (F3). Overrides the project’s value only for this program; only effective if Commitment is enabled. Values: True/False. The Commit/Rollback statements require Commitment enabled.
DDSName of the DDS this program is attached to.
PathOutput folder for this program, relative to the project.
@Properties {
    Type            : Program
    Name            : PTEST01
    Description     : "Test program"
    Commitment      : True
    Commit on Exit  : True
    Path            : "./programs/"
}

Screen

Same keys as Program (Type with value Screen), plus 7 of its own:

KeyDescription
PopupGenerates this Screen’s DSPF with the DDS WINDOW keyword (a pop-up window) instead of a full screen. Requires the 4 keys below. Values: True/False.
Window RowRow (1-based) of the window’s top-left corner. Required if Popup: True.
Window ColumnColumn (1-based) of the window’s top-left corner. Required if Popup: True.
Window RowsWindow height, in rows. Required if Popup: True.
Window ColumnsWindow width, in columns. Required if Popup: True.
Function Keys RowRow where this Screen’s function-key line is drawn (also FunctionKeysRow). Takes precedence over Function Keys Row in @GeneratorConfig/@Screen; with neither, Rows - 1 is used. Valid range: 1 to Rows - 1; out of range gives E00346. That row must be left free in @Layout: there is no overlap warning.
Function Keys ColorColor of this Screen’s whole key line (also FunctionKeysColor): Green, White, Red, Blue, Yellow, Pink or Turquoise. Takes precedence over the project’s; an invalid name gives E00347.
@Properties {
    Type    : Screen
    Name    : SCONFIRM
    Popup   : True
    Window Row     : 5
    Window Column  : 10
    Window Rows    : 10
    Window Columns : 40
}

Example with the key line moved and colored:

@Properties {
    Type               : Screen
    Name               : SCUSTOMERS
    Function Keys Row  : 22
    Function Keys Color: Blue
}

A Screen with Popup: True is generated, compiled and deployed exactly like any other Screen — only the DSPF changes (WINDOW instead of a full screen). To show it from another Screen, reference it in @References/Screens and call it with Call(Name, ...) — see @Source: control statements.

Table

Only Type:

@Properties {
    Type : "Table"
}

The rest of a table’s description goes in @Structure — see @Structure, @Fields, @Indexes.