GQPAR

GDDM-GKS V1R1 Programming Guide and Reference

GQPAR

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

Purpose


GQPAR	(wkid, pai, type, dimx, dimy, errind, dx, dy, colia)

APL code	1480
GKS RCP code	X'3800B600' (939570688)

Function: To inquire pattern representation.

Inquiry function. Returns the representation associated with a given pattern index at a workstation, from the workstation state list.

Parameters

wkid (specified by user) (fullword integer)
The workstation identifier.

pai (specified by user) (fullword integer)
The pattern index.

type (specified by user) (fullword integer)
The type of returned values. The possible values are:

0 (GSET)

Set

1 (GREALI)

Realized

If type equals set, the returned values are the same as those originally passed by the Set pattern representation (GSPAR) function call. If type equals realized, the returned values are the closest available actual values at the device.

dimx (specified by user) (fullword integer)

dimy (specified by user) (fullword integer)
The maximum dimensions of the pattern array colia.

errind (returned by GDDM) (fullword integer)
The error indicator.

dx (returned by GDDM) (fullword integer)

dy (returned by GDDM) (fullword integer)
The dimensions of the pattern array colia.

colia (returned by GDDM) (an array of fullword integers)
The pattern array (dimx groups of dimy elements).

Operating states

WSOP, WSAC, SGOP

Related functions

Set pattern representation (GSPAR)

Description

If the inquired information is available, it is returned as output, and errind is returned as 0 (zero). If the inquired information is not available, all output is invalid, and errind returns an error indicator.

Principal errors

7: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
20: Specified workstation identifier is invalid
25: Specified workstation is not open
33: Specified workstation is of category MI
35: Specified workstation is of category INPUT
36: Specified workstation is Workstation Independent Segment Storage
85: Specified pattern index is invalid
88: A representation for the specified pattern index has not been defined on this workstation
90: Interior style PATTERN is not supported on this workstation

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