GSVIS

GDDM-GKS V1R1 Programming Guide and Reference

GSVIS

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

Purpose


GSVIS	(sgna, vis)

APL code	1366
GKS RCP code	X'38004100' (939540736)

Function: To set visibility.

Segment function. Makes a segment visible or invisible on the display surface.

Parameters

sgna (specified by user) (fullword integer)
The segment name.

vis (specified by user) (fullword integer)
The visibility flag. The possible values are:

0 (GINVIS)

Invisible

1 (GVISI)

Visible

Operating states

WSOP, WSAC, SGOP

Related functions

Redraw all segments on workstation (GRSGWK), Update workstation (GUWK), Create segment (GCRSG), Inquire segment attributes (GQSGA), Inquire dynamic modification of segment attributes (GQDSGA)

Description

This function sets the visibility attribute for segment sgna. The value given by vis is set in the segment state list for the segment.

When segment visibility is set using this function, an implicit regeneration may be required at the workstation where the segment is displayed. To ensure an accurate representation, call Redraw all segments on workstation (GRSGWK) or Update workstation (GUWK).

The visibility of a segment is valid for all workstations associated with the segment, even if they are not active. The default visibility of a segment is visible when you create the segment. This function can also be applied to an open segment.

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
2000: Enumeration type out of range

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