Overlapping partitions

GDDM V3R2 Base Application Programming Guide

Overlapping partitions

GDDM V3R2 Base Application Programming Guide
SC33-0867-01

You can overlap partitions. Partitions are opaque, so the part of a partition that is overlapped by another partition is completely obscured by the top partition.

The next example contains the skeleton code to produce a partition that overlaps another partition:


     ________________________________________________________________________
     PARTLAP: PROC OPTIONS(MAIN);

     DCL (TYPE,MOD,COUNT) FIXED BIN(31);

     /*  Partition set parameters -     rows columns control overlap  */
     DCL SET_ARRAY(4) FIXED BIN(31) INIT(10,    16,     1,     1);

     /*  Partition parameters - row column depth width dev visibility */
     DCL P1(6) FIXED BIN(31) INIT(1,   1,    10,   16,  -1,    1);

     DCL P2(6) FIXED BIN(31) INIT(5,   3,     6,   11,  -1,    1);

     CALL FSINIT;

     CALL PTSCRT(1,4,SET_ARRAY);                                        A

     CALL PTNCRT(1,6,P1);                                               B
             .
             .
             .

     CALL PTNCRT(2,6,P2);                                               C
             .
             .
             .

     CALL ASREAD(TYPE,MOD,COUNT);

     %INCLUDE ADMUPINA;
     %INCLUDE ADMUPINF;
     %INCLUDE ADMUPING;
     %INCLUDE ADMUPINP;
     CALL FSTERM;
     END PARTLAP;

________________________________________________________________________

A program based on the above skeleton program produced the screen output shown in Figure 125. All that is added to the program is the alphanumeric code for the panel in partition 1, the graphics calls to produce the chart in partition 2, and the code to draw a line around the border of each partition.

The PTSCRT call at A defines the partition-set grid, using the parameters in SET_ARRAY.

The PTNCRT call at B creates partition 1, using the parameters in P1_ARRAY. This partition fills the screen.

The PTNCRT call at C creates partition 2, using the parameters in P1_ARRAY. These parameters place the top-left-hand corner of partition 2 in row 5 and column 3.

The advantages of overlapping partitions are:

You can show a number of partitions on the screen, at the same time, but highlight one or more partitions by placing them on top of the others.
You can show more of the underlying partitions than is possible with nonoverlapping partitions.

An example of the use of overlapping partitions is to associate each partition with each logical function of your program. The program would change the viewing order to let the terminal user access the partition associated with the function that is wanted. The next section tells you how your program can alter the viewing order.

If you specify on the PTSCRT call that partitions can overlap, you always get emulated partitions (even when the partitions do not actually overlap) on all devices including those that support real partitions.

Partitions are also always emulated when user control or operator windows are available.

A display showing a partition containing a business graphics chart in one partition overlapping on another partition that contains the data from which the chart is composed.

Figure 125. Output of program with overlapping partitions

Notices | Terms of use | Support | Contact z/OS