Record properties

The Record properties notebook describes information about the record. This notebook contains the following tabbed pages (depending on the record type):

Basics page

The Basics page contains the general properties of the record.

Record
Displays the name of the record.

Type
Displays the type of record.

Modified
Displays the last time that the record changed.

Number of fields
Shows the number of fields in this record.

In a window
Creates the WINDOW keyword for the record. If this checkbox is disabled, the WINDOW keyword for the record will be removed.
Note:
To restore the WINDOW keyword you just deleted, enable this checkbox. The properties notebook restores the keyword that was last changed.

Description
Briefly describes the contents of the record and stores this description in the TEXT keyword.

For subfile records:

Subfile Basics page

The Basics page contains the following additional field for subfile records:

Subfile next changed (SFLNXTCHG)
Returns the subfile record to the program on a get-next-changed operation. Typically, you use this keyword to force workstation users to correct program-detected keying errors that are read by the program. This field only appears on subfile records.
Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.
Note:
This page always displays the record properties of the subfile record, even if you are selecting a subfile control record.

Basics page

The Basics page contains the general properties of the record.

Record
Displays the name of the record.

Type
Displays the type of record. A record is relative if it has one or more of the following keywords: SKIPA, SKIPB, SPACEA, SPACEB. This field is read only.
Relative
If you want to specify the location of fields in the record relative to other fields, select relative. You cannot specify line numbers for fields. Line numbers will be determined using the SKIP and SPACE keywords.

For example, if FIELDA is to be located three lines above FIELDB in the record, you would specify the SPACEA(3) keyword for FIELDA. The CODE Designer will automatically create and maintain these keywords for you in the Design window, although you can change them directly.

This type of record is useful for detail lines in a report, where a single record appears multiple times on the same page.

Absolute
Identifies that the line number of fields on the report page are explicitly specified.

Modified
Displays the last time that the record changed.

Number of fields
Shows the number of fields in this record.

Description
Briefly describes the contents of the record and stores this description in the TEXT keyword.

Basics page

The Basics page contains the general properties of the record.

Record
Displays the name of the record.

Inherit all fields (FORMAT)
Generates the FORMAT keyword.
Note:
If the FORMAT keyword is specified, all predefined fields in this record will be deleted. When the FORMAT keyword is delected, the fields will be restored.
This record will share all the field specifications with the record format of the same name in the database file that you specify in the following entry fields:

Library
Specifies the location of the library that contains the file.

File
Specifies the database file name.

Browse
If an AS/400 connection is established, then click on Browse to bring up the Select Database Record dialog. This dialog allows you to search for the AS/400 file, library, and record lists.

Description
Briefly describes the contents of the record and stores this description in the TEXT keyword.

Window page

The Window page specifies the type of windowed record for this object. You can either specify the window definition record or window reference for this record.

Window definition
Specifies that this is a window definition record whose location and size is specified on the WINDOW keyword.

Position window relative to cursor
Positions the window relative to the cursor by the system.

Start row/field
Specifies the top row of the window.

Start col/field
Specifies the left column of the window in the same manner as the start row.

Number of rows
Specifies the number of rows within the window. This number includes the message line.

Number of cols
Specifies the number of columns within the window. This number does not include the attribute byte characters on the inside of the left and right borders nor the borders themselves.

Window reference
Specifies the name of a record that contains a window definition from which this window will inherit its location and size.

*NOMSGLIN
Specifies that a window can be created with the message line appearing at the bottom of the display instead of on the last line of the window.

*NORSTCSR
Does not restrict the cursor to this window. If this checkbox is empty, the function keys are disabled when the cursor is outside of the window.

Same position in both display sizes
Specifies that only one WINDOW keyword exists for both the 24x80 and 27x132 display sizes. If this checkbox is empty, independent WINDOW keywords for each display size exists. These keywords appear in the list box below where you can select which keyword to change.

Title page

The Title page allows you to specify the text, color, and display attributes for a title that is imbedded within the border of a window.

Defined as text
Uses the title that is provided by the typed in string.

Referenced field
Specifies the name of a program-to-system field to be used as the title when the record is written to the screen. If the field does not exist, the program will create it.
Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

Alignment
Specifies the relative position of the title on the window border. You can align the title with one of the following positions:

Left

Center

Right

Position
Specifies the location of the title on the top or bottom border of the window.

Top

Bottom

Attributes
Specifies the display attributes of the title text. The following attributes are available:
Causes the text to blink.
Displays column separators between each character.
Displays fields at high intensity.
Hides the field.
Reverses the foreground and background colors for the selected fields.
Underlines the field.

Color
You can specify the color of the title text on a color display by selecting the desired color button.

You can specify more that one WDWTITLE keyword for a record. The program combines the parameters for the keywords. If the same parameter contains different values, the program uses the first keyword that specifies that parameter.

Add
Add a WDWTITLE keyword with the current settings after the selected keyword in the list box. If you do not select a keyword, the program appends the new keyword at the end.

Change
Changes the selected WDWTITLE keyword to reflect the current settings.

Delete
Removes the selected WDWTITLE keyword.
Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

Border page

The Border page allows you to specify the color, display attributes, and characters that are used to form the border of a window record.

Border characters
Specifies the characters that will make up the window border.

Attributes
Specifies the display attributes of the record. You can specify the following attributes:
Causes the text to blink.
Displays column separators between each character.
Displays fields at high intensity.
Hides the field.
Reverses the foreground and background colors for the selected fields.
Underlines the field.

Color
You can specify the color of the border text on a color display by selecting the desired color button.
Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

Add
Add a WDWBORDER keyword with the current settings after the selected keyword in the list box. If you do not select a keyword, the program appends the new keyword at the end.

Change
Changes the selected WDWBORDER keyword to reflect the current settings.

Delete
Removes the selected WDWBORDER keyword.

SFL Control page

The Subfile control page displays information for the subfile control record (regardless of whether you are pointing to the subfile or subfile control record). In addition, this page lets you change the mandatory keywords for defining a subfile.

Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

Name
Displays the name of the subfile control record.

Description
Briefly describes the contents of the subfile control record. The TEXT keyword stores this information.

Number of entries (SFLSIZ)
Specifies either the maximum number of entries or the program-to-system field you want the subfile record to contain.

Entries per displayed page (SFLPAG)
Specifies the number of entries that the screen displays at the same time.

You can specify the number of entries for the secondary display size by enabling the secondary display size checkbox. Select either *DS3 or *DS4 and then select the appropriate number.

Subfile display (SFLDSP)
Displays the subfile when the condition is on for this keyword.

Display subfile control (SFLDSPCTL)
Displays the fields in the subfile control record.
Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

Spaces between records (SFLLIN)
Displays the subfile horizontally (more than one column of records) with the specified number of spaces separating the record columns.

You can specify the number of entries for the secondary display size by enabling the secondary display size checkbox. Select either *DS3 or *DS4 and then select the appropriate number.

Ctrl Keywords page

The Control keywords page displays information for the subfile control keyword (regardless of whether you are pointing to the subfile or subfile control object).

Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

SFLDROP
Folds or truncates subfile records that require more than one display line. Initially this keyword will put the subfile in truncate mode.

SFLFOLD
Folds or truncates subfile records that require more than one display line. Initially this keyword will put the subfile in fold mode.

SFLCLR
Clears the subfile of all the records.

SFLDLT
Deletes the subfile.

SFLINZ
Initializes all the records in the subfile.

SFLEND
Displays an indicator or a scroll bar to indicate when you reach the bottom of the subfile list.

SFLENTER
Enables the Enter key as Page Up in a subfile.

SFLRNA
Allows your program to initialize a subfile with no active records.

SFLCSRRRN
Returns the relative record number of the record on which the cursor is located with a subfile.

SFLMODE
Returns an indication of whether the subfile was in folded or truncated mode on input.

SFLROLVAL
Allows the use to type in the number of records to page up or page down.

SFLRCDNBR
Specifies that the displayed page of the subfile is the page which contains the record whose relative record number is in this field.

Message page

The Message page specifies how to build the subfile from messages from a program message queue.

Display messages starting from row (SFLMSGRCD)
Specifies the first line on the display on which messages are displayed. The value specified must not be greater than the maximum line number for the current display size.

Message key field (SFLMSGKEY)
Specifies the name of the field in which the program places a message reference key to select messages to display. The field must be a four-position, character data type, hidden field which is the first field in the subfile record.
Note:
If the field does not exist, the program creates it. If you enter a new name, the field will contain this new name.

Program queue name field (SFLPGMQ)
Specifies the name of the field in the subfile record which the program passes the name of the program message queue that contains the messages. The optional parameters which determine the field length are:

Nothing
Defaults to OPM

OPM
10 bytes

ILE
276 bytes
Note:
If the field does not exist, the program will create. If you enter a new name, the field will contain this new name.

Display all messages using:
Displays all messages in the program queue below. You can either choose to fill the message subfile one message at a time by writing the individual subfile records or you can fill it in one operation by writing the subfile control with keywords to specify the program queue to fill the subfile from. By checking the checkbox you are choosing the latter method.

Program queue name field (SFLPGMQ)
Specifies the name of the field in the subfile control record in which the program passes the name of the program message queue that contains the messages. The optional parameters which determine the field length are:

Nothing
Defaults to OPM

OPM
10 bytes

ILE
276 bytes
Note:
If the field does not exist, the program will create. If you enter a new name, the field will contain this new name.

Position page

The Postion page allows you to skip after all the lines associated with the record are printed. For each record the processing order is:

  1. File-level SKIPB
  2. Record-level SKIPB
  3. Record-level SPACEB
  4. Field-level SKIP and SPACE
  5. Record-level SPACEA
  6. Record-level SKIPA
  7. File-level SKIPA
SKIPB
Skips to a specific line number before the first field is printed.
SPACEB
Spaces a number of lines before the first field is printed.
SPACEA
Spaces a number of lines after the last field is printed.
SKIPA
Skips to a specific line number after the last field is printed.
Conditioning:
You can specify the condition under which the current keyword is in effect by selecting the push button.

Styles page

The Styles page contains all existing named settings for this object's style. CODE Designer provides two types of styles: Installation defaults, which are the initial settings that are shipped with the product; and Creation defaults, which the program uses to create a new object. Initially the creation defaults are the same style settings as the installation defaults, but you can change them. You can also create, delete and rename user-defined styles for this object type. You can use styles to remember a certain set of properties and apply it to other objects of the same type. Use Create or Redefine to remember the current state of the object's properties, and use Reset To to restore that state to any object of this type.

Name
Specifies a title for the style you want to create.

Create
Creates a new style by using the current object's properties.

Reset to
Changes the object's properties to the selected style.

Redefine
Changes the selected style to be the object's properties.

Rename
Changes the name of the selected style to the name that is typed in the entry field.

Delete
Removes this style.

Default name prefix
Specifies a prefix of up to 7 characters when creating new objects. When creating a new object of this type, the default name will consist of this prefix plus a trailing number to make it unique.

Styles page

The Styles page allows you to change the default prefix for new record names.

Default name prefix
Specifies a prefix of up to 7 characters when creating new objects. When creating a new object of this type, the default name will consist of this prefix plus a trailing number to make it unique.