GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


MSGET

GDDM V3R2 Base Application Programming Reference
SC33-0868-02



Function


To retrieve data from a mapped field.


   MSGET       (id, option, length, ads)

APL code 1110 GDDM RCP code X'0C280502' (203949314)


Parameters


id (specified by user) (fullword integer)
The identifier of the mapped field.

option (specified by user) (fullword integer)
The type of data to be returned. Possible values are:

0
The data record is returned.
1
Reserved.
2
Reserved.
3
The ADS for highlighting is returned.
4
The ADS for color is returned.
5
The ADS for programmed symbols is returned.

length (specified by user) (fullword integer)
The length of the ads parameter.

ads (returned by GDDM) (character)
The current value of the contents of the mapped field. The length of the structure must be as least as great as the length defined in the map for the field. The data beyond the end of the map-defined length is unchanged by this operation.


Description


Returns the current value of the contents of a mapped field.

Principal errors


ADM0950 W
INPUT FIELD TRUNCATED
ADM0966 E
PAGE n IS NOT MAPPED
ADM0976 E
MAPPED FIELD a DOES NOT EXIST
ADM0978 E
MAPPED FIELD ID n IS NOT GREATER THAN ZERO
ADM0980 E
DATA LENGTH (n) IS SMALLER THAN LENGTH OF ADS (a) OF MAP

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012