DFHPDI

Partition definition.

Read syntax diagramSkip visual syntax diagram
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.