FSGETS

GDDM V3R2 Base Application Programming Reference

FSGETS

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To start Family-4 datastream retrieval.

FSGETS

APL Code 620 GDDM RCP code X'0C100009' (202375177)

Parameters

None.

Description

Causes the current page to be made available for family-4 datastream retrieval via the FSGET call. The call is only valid when the currently open primary device is Family-4. It is designed to be used with the specification of a dummy device on the DSOPEN call. That is by specifying blanks in the name parameter. Without a dummy device the call will also create an output dataset as if an FSFRCE call had been issued.

This function is not supported for PostScript output.

FSGETS causes the creation of an internal chain of buffers containing the datastream records in storage, ready for retrieval by the FSGET call. This may cause problems where there are storage limitations. To reduce the size of the datastream it is recommended that the procopt OFFORMAT specifies the GRIMAGE or GRCIMAGE option. This may be implied by the choice of device token.

If the OFDSTYPE(CDPFTYPE) procopt specifies DOC(PRIM) output then a call to FSGETS must be made after each page has been constructed by the application program. The records for each page must be retrieved using FSGET calls following every call to FSGETS. When formatted output has been requested with the OFFORMAT(HRIFORMT) procopt then GDDM inserts a BEGIN DOCUMENT (BDT) record in front of the first page. As it is not known at the time FSGETS is issued, which page is the last, an END DOCUMENT (EDT) record is never made available for FSGET.

This function is not intended for use with color separation masters.

Principal errors

ADM0287 E: DATASTREAM RETRIEVAL ALREADY INITIALIZED

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