GSGETS

GDDM V3R2 Base Application Programming Reference

GSGETS

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To start retrieval of graphics data.


   GSGETS      (count, array)

   APL code               554
   GDDM RCP code          X'0C0C0B00' (202115840)

Parameters

count (specified by user) (fullword integer)
The number of elements in the following array.

array (specified by user) (an array of fullword integers)
The data required. The array can have these elements:

1

The identifier of the segment required. If the identifier is zero or if the array has no elements, all segments are retrieved.

2

The format of the GDF information to be returned. Possible values are:

0 or 2

2-byte integer GDF. This is the default.

For restrictions on various devices, see "Device-specific saved pictures" in topic 4.2.

All coordinates within GDF orders are defined by a device-dependent coordinate system (defined by the initial Comment order within the GDF).

4

4-byte short floating-point GDF. All coordinates within GDF orders are defined by the current window coordinate system (extended as necessary to cover the graphics field).

3

The type of GDF information to be returned. Possible values are:

0 or 1

For segments: Initial Comment order and segment GDF. This is the default.

2

For pictures: Initial Comment order, symbol set names, picture prolog, and segment GDF. For information on the format of GDF orders that are returned, see "GDF order descriptions" in topic 10.0.

Description

Starts the retrieval of graphics data format (GDF), symbol set, window, and coordinate type information from the current page. The GDF information can be returned in either fixed-point or floating-point format, depending on the value of the second element of the array parameter.

Retrieval of graphics data cannot be started when there is an open segment.

The graphics data for an individual named segment, or the data for all segments being kept for the page, may be retrieved,

GSGETS specifies the data required and begins the retrieval. Data is obtained by GSGET and the retrieval is ended by GSGETE.

The following calls cannot be issued after GSGETS until a GSGETE call has been issued:

FSCOPY GSCALL GSDEFE GSDEFS GSGETS GSLOAD GSSAGA GSSATS GSSAVE GSSCPY GSSDEL GSSEG GSSINC GSSORG GSSPOS GSSPRI GSSTFM

and (if the primary device is a queued printer)

ASREAD FSCHEK FSFRCE.

For full information on GDF and its orders, see the "GDF order descriptions" in topic 10.0.

Principal errors

ADM0145 E: SEGMENT n IS UNKNOWN
ADM0146 E: ARRAY COUNT n IS INVALID
ADM0150 E: GRAPHICS SEGMENT n IS CURRENT
ADM0161 E: GRAPHICS FIELD NOT DEFINED
ADM0179 E: INVALID FUNCTION DURING GRAPHICS RETRIEVAL
ADM0180 E: GRAPHICS RETRIEVAL NOT SUPPORTED BY DEVICE

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