The Record properties notebook describes information about the
record. This notebook contains the following tabbed pages (depending on
the record type):
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:
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.
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.
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.
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.
- If the window always begins on the same row, specify the number of the row
in the numeric spin button.
- If you want to set the starting row at run time, then provide the field
name which the application will set before writing this record. The
field must be a signed numeric (data type S) and program-to-system (usage P)
field with a length no greater than 3 in the same record.
- Note:
- If this field does not exist with the specified name, the program will create
it.
- 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.
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.
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.
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.
- If you specify the maximum number, you can enable the checkbox for the
secondary display size and select a maximum number in the associated entry
field.
- If you specify a program-to-system field, it needs to have a length of 5
and datatype of S. If the field does not exist, it will be created for
you.
- 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.
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.
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.
The Postion page allows you to skip after all the lines associated with the
record are printed. For each record the processing order is:
- File-level SKIPB
- Record-level SKIPB
- Record-level SPACEB
- Field-level SKIP and SPACE
- Record-level SPACEA
- Record-level SKIPA
- 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.
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.
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.
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.