GIITM

GDDM-GKS V1R1 Programming Guide and Reference

GIITM

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

Purpose


GIITM	(type, idrl, ldr, datrec)

APL code	1412
GKS RCP code	X'38006800' (939550720)

Function: To interpret item.

Metafile function. Interprets the contents of a metafile item.

Parameters

type (specified by user) (fullword integer)
The item type. The item type is a number generated internally by GDDM-GKS when a call to a GKS function causes metafile items to be stored on a metafile.

idrl (specified by user) (fullword integer)
The length of the item data record (the number of significant characters in the data record array).

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

datrec (specified by user) (array of 80-byte character tokens)
An array containing the item data record.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Write item to GKSM (GWITM), Get item type from GKSM (GGTITM), Read item from GKSM (GRDITM)

Description

This function interprets the contents of the metafile item provided by your application, causing changes to the state lists and generating graphical output. When reading a metafile you can get the type and the data record length of the current metafile item by using the function Get item type from GKSM (GGTITM). The function Read item from GKSM (GRDITM) returns the data record of the current metafile item. The item type, the data record length, and the data record can then be passed to this function (GIITM).

Note that user items, written to output metafiles by the function Write item to GKSM (GWITM), cannot be interpreted. Appendix C, "Metafile structure" in topic C.0 lists all metafile items that can be generated by GDDM-GKS.

When an item is interpreted, the effects on the state lists are the same as if the function corresponding to the item were called directly.

To display a picture stored as a metafile:

Open and activate the workstation on which the picture is to be displayed, by using the Open workstation (GOPWK) and Activate workstation (GACWK) functions.
Open the metafile containing the picture to be displayed as a metafile input (MI) workstation.
Then for each item in the metafile (until the function Get item type from GKSM (GGTITM) returns the End item, type 0):
Use the Get item type from GKSM (GGTITM) function to return the item type and the length of the data record to your program.
Use the Read item from GKSM (GRDITM) function to return the item data record to your program and to make the next item in the metafile the current item.
Call this function using the returned item type, data record length, and data record.

Items corresponding to GKS functions that normally apply only to a single workstation are interpreted at all active workstations.

If datrec is too small to contain the length specified by idrl, error 2003 is reported.

In addition to the errors given below, other errors can be reported, depending on the type of the item being interpreted.

Principal errors

7: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
161: Item length is invalid
163: Metafile item is invalid
164: Item type is not a valid GKS item
165: Content of item data record is invalid for the specified item type
167: User item cannot be interpreted
168: Specified function is not supported in this level of GKS
2003: Invalid data record

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