GRDITM

GDDM-GKS V1R1 Programming Guide and Reference

GRDITM

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

Purpose


GRDITM	(wkid, midrl, mldr, datrec)

APL code	1411
GKS RCP code	X'38006700' (939550464)

Function: To read item from GKSM.

Metafile function. Reads the current item from an input metafile.

Parameters

wkid (specified by user) (fullword integer)
The identifier of the metafile input workstation.

midrl (specified by user) (fullword integer)
The maximum item data record length in bytes. If the length of the item data record is greater than this value, the excess parts of the item are lost. You can specify 0 to skip the metafile item.

mldr (specified by user) (fullword integer)
The dimension of the item data record array datrec.

datrec (returned by GDDM) (array of 80-byte character tokens)
The data record array. The contents of metafile item data records are described in Appendix C, "Metafile structure" in topic C.0.

Operating states

WSOP, WSAC, SGOP

Related functions

Get item type from GKSM (GGTITM).

Description

A GKS metafile (GKSM) is a sequential file that behaves like a workstation. This function reads the current item from an input metafile and returns the data to your application program in the data record array. After the item is read, the next item in the metafile becomes the current item.

Note: The content of each GKSM item is not defined as part of the GKS standard, but is specific to GDDM-GKS.

If datrec is not large enough to contain the item data record requested, error 2001 is reported.

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
34: Specified workstation is not of category MI
162: No item is left in GKS Metafile input
163: Metafile item is invalid
165: Content of item data record is invalid for the specified item type
166: Maximum item data record length is invalid
2001: Output parameter size insufficient

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