Querying the priority of overlapping partitions

GDDM V3R2 Base Application Programming Guide

Querying the priority of overlapping partitions

GDDM V3R2 Base Application Programming Guide
SC33-0867-01

There are two calls that you can use to query the priority of partitions in the current partition set.

In the last section, the PTSSPP call was used to change the viewing priority of a specified array of partition identifiers relative to a specified reference partition identifier. The corresponding query call PTSQPP returns an array of partition identifiers relative to a specified reference partition identifier. For example, here is a typical call, that returns the identifiers of the three partitions that are above partition 5 in the viewing order:


     DCL PRI_ARRAY (3) FIXED BIN(31);

     CALL PTSQPP(1,5,3,PRI_ARRAY); /* Query partition viewing order  */

The parameters are as follows:

The first parameter specifies whether the array in the final parameter is to return the identifiers of partitions in descending or ascending order from the reference partition. The possible values are:
-1
Descending order
1
Ascending order.
The second parameter specifies the identifier of the reference partition that the query relates to. It can have a value of -1, the effect of which depends on whether you set the first parameter to ascending or descending order:
Descending
The first partition in the array is the top partition in the viewing order, and the rest of the partitions in the array are those that are behind it.
Ascending
The first partition in the array is the bottom partition in the viewing order, and the rest of the partitions in the array are those that are in front of it.
The third parameter contains the number of elements to be returned in the array in the final parameter.
The final parameter is an array that holds the returned identifiers of partitions that descend or ascend from the reference partition.

There is another query call, PTSQPI, that returns the identifiers of either all partitions in the current partition set, or just the invisible ones. Here is a typical call:


     DCL PRI_ARRAY (7) FIXED BIN(31);

     CALL PTSQPI(1,7,PRI_ARRAY);  /* Query all partition identifiers */

The parameters are as follows:

The first parameter specifies the type of partition that you want information returned about:
1
All partitions
2
All invisible partitions.
The second parameter specifies the number of elements in the array in the final parameter.
The third parameter is the name of an array in which GDDM returns the requested information.

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