PTSSPP

GDDM V3R2 Base Application Programming Reference

PTSSPP

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To set or reset partition viewing priorities.


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

   APL code               1006
   GDDM RCP code          X'0C200300' (203424512)

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 reordering is to take place.

A value of -1 can be used to set the first partition in array as either the highest in viewing priority (if descending order), or lowest in viewing priority (if ascending order).

no-of-elements (specified by user) (fullword integer)
The number of partitions to be reordered in viewing priority. It is the number of elements in array.

array (specified by user) (an array of fullword integers)
The identifiers of the partitions to be reordered in viewing priority. A value of -1 in any element terminates the reordering process.

Description

Sets the relative viewing priorities of the specified partitions.

The partitions whose identifiers are specified in array are reordered in viewing priority relative to the specified partition, partition-id.

The reordering process is as follows:

The elements of the array parameter are processed one at a time.
The partition identified by the first element is placed behind (if descending order) or in front of (if ascending order) the specified partition, partition-id.
The partition identified by the second element is placed behind (or in front of) the partition identified in the first element.
This process is repeated until all the elements of the array parameter are processed, or until a -1 element is found.
The priorities of partitions that are not specified in array remain unchanged with respect to partition-id and each other. Unspecified partitions with a higher priority than partition-id retain viewing priorities higher than both partition-id and all reordered partitions. Unspecified partitions with a lower priority than partition-id retain viewing priorities lower than both partition-id and all reordered partitions.

Example: Eight partitions are arranged in descending order of priority:

1 2 3 4 5 6 7 8


   A call to PTSSPP is made with order=-1, partition-id=4, no-of-elements=4,
   and array containing {2 7 5 -1}.

The priorities are reordered thus:


      1     3     4     2      7      5     6     8
      "     "     "     "      "      "     "     "
      |__ __|     |     |______|______|     |__ __|
         |        |            |               |
    Unspecified   |    Specified in array      |
                  |                            |
             Partition-id                 Unspecified

Principal errors

ADM3116 E: PARTITION n ALREADY PROCESSED
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

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