GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


PTSQPP

GDDM V3R2 Base Application Programming Reference
SC33-0868-02



Function


To query partition viewing priorities.


   PTSQPP      (order, partition-id, no-of-elements, array)

APL code 1007 GDDM RCP code X'0C200301' (203424513)


Parameters


order (specified by user) (fullword integer)
The order of viewing priority. Possible values are:

-1
Descending order of viewing priority.
1
Ascending order of viewing priority.

partition-id (specified by user) (fullword integer)
The identifier of the partition relative to which the query is to take place.


A value of -1 can be used to return, within array, the identifiers of all partitions in descending (or ascending) order of priority.

no-of-elements (specified by user) (fullword integer)
The number of partition identifiers to be returned in the array parameter. It is the number of elements in array.

array (returned by GDDM) (an array of fullword integers)
The identifiers of the partitions.


The array is arranged as follows:

  • The identifier of the partition that appears behind partition-id (if descending order), or in front of partition-id (if ascending order) is placed in the first element of the array. If partition-id=-1, this element contains the identifier of the partition with the highest viewing priority (if descending order), or the lowest viewing priority (if ascending order).
    
    
  • The identifier of the partition that appears behind (or in front of) the partition identified in the first element is placed in the second element of the array.
    
    
  • This is repeated until the identities of all the remaining partitions have been entered in the array.
    
    
  • If there are more elements than partition identifiers to return, the remaining elements are set to a value of -1.
    
    

Description


Returns the identifiers of partitions in order of descending or ascending viewing priority, starting from a specified partition.

If descending order of viewing priority is specified, the identifiers of the lower-priority partitions that appear behind the specified partition are returned; if ascending order of viewing priority is specified, the identifiers of the higher priority partitions that appear in front of the specified partition are returned.

Principal errors


ADM3118 E
NUMBER OF ELEMENTS (n) IS INVALID
ADM3121 E
PARTITION n DOES NOT EXIST
ADM3122 E
PARTITION ID (n) IS INVALID
ADM3193 E
ORDER n IS INVALID

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012