Partition definition.

DFHPDI
>>-+-------+--DFHPDI--VIEWPOS--=--(--lines--,--columns--)------->
'-partn-'
>--,--VIEWSZE--=--(--lines--,--columns--)----------------------->
.-,--------------------------------------.
V |
>----+------------------------------------+-+------------------><
+-BUFSZE--=--(--lines--,--columns--)-+
+-CHARSZE--=--(--vpels--,--hpels--)--+
+-MAPSFX--=--mapset-suffix-----------+
'-ATTRB--=--ERROR--------------------'
A partition set contains one or more partitions. Each
partition is defined by coding a partition definition macro.
“partn” is a partition name (1–2 characters). It allows you
to refer to the partition in your application programs.
Every partition in a partition set must have a different name. Only the
error partition can be unnamed (see ATTRB=ERROR operand).
Partitions are defined by coding the macros DFHPSD (partition set definition)
and DFHPDI (partition definition). Each partition definition must be part
of a partition set definition.
Operands
- ATTRB
- specifies that error messages are to be directed to this partition whenever
possible. The partition is cleared before an error message is displayed. The
RDO TYPETERM option ERRHILIGHT is honored, but
the LASTLINE option is ignored.
- BUFSZE(lines,columns)
- specifies the size of the presentation space for the partition. Device
limitations mean that the “columns” value must be equal to the “columns”
value specified by the VIEWSZE operand. The “lines” value can be greater
than or, by default, equal to the value specified by the VIEWSZE operand.
A greater lines value implies that the target terminal supports vertical scrolling.
- CHARSZE(vpels,hpels)
- specifies the size of the character cell to be reserved for each character
displayed in a partition. You specify the size as numbers of vertical picture
elements (vpels) and numbers of horizontal picture elements (hpels). You can
specify this operand on either the DFHPSD macro only, or on both the DFHPSD
and DFHPDI macros. The values specified in the DFHPSD become the defaults
for all partitions in the partition set. You can override these defaults for
individual partitions by coding CHARSZE in the DFHPDI macro.
- MAPSFX(mapset-suffix)
- specifies the partition's 1-character mapset suffix. BMS uses the
suffix to select mapset versions in the same way as for the RDO option ALTSUFFIX.
If this operand is omitted, a suffix L is assumed if the “columns”
value of the BUFSZE operand is less than or equal to 40; otherwise M is assumed.
- VIEWPOS(lines,columns)
- specifies the position of the top left-hand corner of this partition's
viewport. You specify the position in numbers of lines and numbers of columns.
The DFHPDI macro checks that viewports do not overlap. If you have coded the
RDO TYPETERM ALTSCREEN option, or the ALTSCRN operand of the DFHPSD macro,
DFHPDI also checks that all viewports fit within the usable area of the terminal
screen.
Note: The information given here on positioning
viewports is necessarily brief. For more information you should consult the
component description for the device you are using.
- VIEWSZE(lines,columns)
- specifies the size, in lines and columns, of the partition's viewport.
The DFHPDI macro checks that viewports do not overlap. If you code the RDO
TYPETERM ALTSCREEN option, or the ALTSCRN operand of the DFHPSD macro partition
set definition macro, DFHPDI checks that the partitions all fit within the
usable area of the display screen.