GQSGA

GDDM-GKS V1R1 Programming Guide and Reference

GQSGA

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

Purpose


GQSGA	(sgna, errind, segtm, vis, high, sgpr, det)

APL code	1432
GKS RCP code	X'3800DF00' (939581184)

Function: To inquire segment attributes.

Inquiry function. Returns the segment attributes for a segment, from the segment state list.

Parameters

sgna (specified by user) (fullword integer)
The segment name, selected when the segment was created.

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

segtm (returned by GDDM) (array of short floating-point numbers)
The segment transformation matrix. This is a 2 * 3 array, with the elements arranged like this:


         M(1)     M(3)     M(5)
         M(2)     M(4)     M(6)

vis (returned by GDDM) (fullword integer)
The visibility attribute. The possible values are:

0 (GINVIS): Invisible.
1 (GVISI): Visible.

high (returned by GDDM) (fullword integer)
The highlighting attribute. The possible values are:

0 (GNORML): Normal
1 (GHILIT): Highlighted

sgpr (returned by GDDM) (short floating point)
The segment priority.

det (returned by GDDM) (fullword integer)
The detectability attribute. The possible values are:

0 (GUNDET)

Undetectable

1 (GDETEC)

Detectable

Operating states

WSOP, WSAC, SGOP

Related functions

Set detectability (GSDTEC), Set segment priority (GSSGP), Set segment transformation (GSSGT), Set visibility (GSVIS), Set highlighting (GSHLIT)

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
120: Specified segment name is invalid
122: Specified segment does not exist

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