This section describes how to define the settings (profile) for a new map or help map.
When you select the function Define Map Settings screen shown in the example below:
or , the first screen to be invoked is the10:41:16 Define Map Settings for MAP 2007-08-13 Delimiters Format Context ----------------- --------------------------- -------------------------- Cls Att CD Del Page Size ...... 23 Device Check .... ________ T D BLANK Line Size ...... 79 WRITE Statement _ T I ? Column Shift ... 0 (0/1) INPUT Statement X A D _ Layout ......... ________ Help ____________________ A I ) dynamic ....... N (Y/N) as field default N (Y/N) A N ¬ Zero Print ..... N (Y/N) M D & Case Default ... UC (UC/LC) M I : Manual Skip .... N (Y/N) Automatic Rule Rank 1 O D + Decimal Char ... . Profile Name .... SYSPROF O I ( Standard Keys .. N (Y/N) D D $ Justification .. L (L/R) Filler Characters D I / Print Mode ..... __ ------------------------ Optional, Partial .... Control Var .... ________ Required, Partial .... Optional, Complete ... Required, Complete ... Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Let |
Delimiter class D
(see
Delimiters)
only appears if Natural for MBCS is installed.
The sections contained in the Define Map Settings screen are described in the following section.
The Delimiters section of the Define Map Settings screen displays the default delimiters that apply to the current map.
A delimiter is used to assign characteristics to a field. Field characteristics are the class (for example, input/output field), attribute (for example, typeface) and color settings of a field.
Note:
Attributes, colors and print modes require corresponding hardware
features, and will be ignored at runtime if these features are not available.
See also the session parameters AD
,
CD
and
PM
described in the Parameter Reference documentation.
Each class, attribute and color setting is denoted by a one- or
two-letter code. For example, the letter code A
identifies an
input field, the letter I
identifies intensified. Class, attribute
and color can be combined in a delimiter character. A delimiter character, for
example, specifies a field as an input field (letter code A
)
and intensified (letter code I
). In the example screen
above, the delimiter character for this combination (letter codes
A
and I
) is the right parenthesis ( ) ).
A delimiter character is a non-alphabetical character that is prefixed to the field in the map editing area. (See also Defining Map Fields for examples of delimiter usage.) To display or modify the class, attribute and color settings assigned to a field by a delimiter character, use the extended field editing function described in the relevant section. Any non-alphabetical character can be defined as a delimiter character - except the control character for terminal commands, the control character for map commands and the decimal notation character.
Letter codes and delimiter characters can be entered in the columns Cls (Class), Att (Attribute), CD (Color Definition) and Del (Delimiter) or in the editing section provided by the extended field editing function.
To change the default delimiter settings for the current map
In the Delimiters section, in the columns Cls, Att, CD and/or Del, overwrite a value with the value required, or, in a blank column, enter a value.
To change the default delimiter settings for the current session
Before you initialize a map, on the Edit Map
screen, in the Profiles field, replace the default map
profile SYSPROF
by the name of the profile you created earlier
with the function
(see Functions in
the Edit Map Menu).
The profile SYSPROF
can only be modified by the Natural
system administrator.
The table below lists and explains all valid letter codes for class, attribute and color that can be entered in the columns Cls (Class), Att (Attribute) and CD (Color Definition) or in the extended field editing section.
Valid letter codes for classes, attributes and colors are:
Class (Cls) | Attribute (Att) | Color (CD) | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
Delimiter class D
must be defined in the map settings to
create boxes for map fields by using the outline editor and the map editor.
Delimiter class D
allows the definition of boxes for text fields
and blank areas (characters) contained in a map.
For maps created with KAPRI (a product by Beacon IT), delimiter class
D
is automatically added to the map setting when initially reading
in the map definitions into the source area of the map editor. Delimiter class
D
is then entered with the attributes D
(Default) and
I
(Intensified), and two of the following delimiter characters,
which depends on the delimiter characters already used:
$&/()=?@*+'#><|!"^;,:._-§
. Delimiter class
D
is also added automatically when you create a map definition
with the or the
function by using the
default SYSPROF
map profile supplied with the current Natural
version.
A text field for which you want to create a box must start with the
delimiter character you assigned to delimiter class D
. A field
prefixed with this delimiter character is then considered an extended text
field, which can be edited with the extended field editing function of the
map editor as described in the relevant section.
An extended text field that has been defined as a native DBCS (Double Byte Character Set) field is represented by a series of Ks in the map editing area. See also the PM field described in Fields in the Extended Text Field Editing Area.
Blank characters for which you define a box are considered a blank text
field. When using the features of the outline editor, a blank text field is
automatically added to the map with the delimiter character that represents
class D
. In the map editing area, depending on the field length,
the delimiter character is followed by one or more periods (.), where each
period represents a blank character. A blank field with a length greater than
zero (0) is considered an extended text field, which can be edited (or created)
with the extended field
editing function of the map editor as described in the relevant
section.
The following map format settings can be used:
Field | Explanation | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Page Size | The number of map lines to be edited (1 - 250); if
Standard
Keys (see below) is set to Y , the number of
lines is restricted to 3 - 250.
For a map which is output with a
|
||||||||||||||||||||||
Line Size | The number of map columns to be edited (5 - 249). | ||||||||||||||||||||||
Column Shift | Column shift (0 or 1) to be applied to the map. This feature can be used to address all 80 columns on an 80-column screen (Column Shift = 1, Line Size = 80). Positional commands (PF10, PF11) must be used to edit all map positions. | ||||||||||||||||||||||
Layout | The name of a map source definition which contains a predefined layout. | ||||||||||||||||||||||
dynamic |
|
||||||||||||||||||||||
Zero Print |
|
||||||||||||||||||||||
Case Default |
|
||||||||||||||||||||||
Manual Skip |
|
||||||||||||||||||||||
Decimal Char | The character to be used as the decimal notation character. This
character can only be changed with the GLOBALS
command.
|
||||||||||||||||||||||
Standard Keys |
|
||||||||||||||||||||||
Justification |
|
||||||||||||||||||||||
Print Mode |
|
||||||||||||||||||||||
Control Var | The name of an attribute control variable, the content of which
determines the attribute characteristics of fields and texts that have the
attribute definition AD=Y or Y . The
attribute control variable referenced in the map must be defined in the program
using that map.
Removing an attribute control variable from the format map settings implies that the attribute control variable is removed from the map, too, unless it is associated with any other map field. |
The following map context settings can be used:
Field | Explanation | ||||||||
---|---|---|---|---|---|---|---|---|---|
Device Check | If a device name is entered in this field, the map settings are checked for compatibility with the device profile of the specified device. If a setting is not compatible, a warning message is issued (see also Maintenance of Profiles & Devices in the section Functions in the Edit Map Menu). | ||||||||
WRITE Statement | Marking this field with a non-blank value produces a
WRITE statement at the end of the map definition process. The
resulting map can then be invoked from a Natural program using a WRITE
USING MAP statement. Blank lines at the end of the map are automatically
deleted so that the map can be output several times on one page.
|
||||||||
INPUT Statement | Marking this field with a non-blank value causes the result of
the map definition process to be an INPUT statement. The resulting
map can then be invoked from a Natural program using an INPUT USING
MAP statement.
|
||||||||
Help | The name of a helproutine or help map which is invoked at
execution time when the help function is invoked for this map (global help for
map). The syntax that applies to entering values in the
Help field corresponds to the syntax of the
HE session parameter described in
HE Parameter
Syntax (Parameter Reference
documentation).
|
||||||||
as field default |
|
||||||||
Position Line Col | The position where the help map is to appear on the screen at
execution time.
This field only appears if you define the map settings for a help map created with the Initialize a new Help Map function. This field replaces the Help and as field default fields on the Define Map Settings for HELPMAP screen. |
||||||||
Automatic Rule Rank | The rank (priority) assigned to Predict automatic rules when
they are linked to the map during field definition. Default is
1 .
|
||||||||
Profile Name | The name of the profile which was active at map initialization
time.
If
The name of the profile active at the time the map is created is stored within the map. When the map is edited later and another profile is active, a warning is produced but editing is allowed. |
Filler characters can be assigned to indicate whether information for a field is mandatory and whether the field must be completely filled:
Field Type | Explanation |
---|---|
Optional, Partial | Input not mandatory, field need not be completely filled. |
Required, Partial | Input mandatory, field need not be completely filled
(AD=E ).
|
Optional, Complete | Input not mandatory; if filled, field must be completely filled
(AD=G ).
|
Required, Complete | Input mandatory, field must be completely filled
(AD=EG ).
|
Filler characters can also be defined for individual fields using the
extended field editing
function (see the relevant section). For definition of field types, see also
the session parameter AD
described in the
Parameter Reference documentation.