MSREAD

GDDM V3R2 Base Application Programming Reference

MSREAD

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To present mapped data.


   MSREAD      (group-name, map-name, length, ads, attype, attval)

   APL code               1101
   GDDM RCP code          X'0C280000' (203948032)

Parameters

group-name (specified by user) (8-byte character string)
The name of a mapgroup. It is in the same format as for the MSPCRT call. The corresponding generated mapgroup may be read from auxiliary storage.

map-name (specified by user) (8-byte character string)
The name of a map within the mapgroup.

length (specified by user) (fullword integer)
The length of the application data structure for the map.

ads (specified by user and returned by GDDM) (character)
The application data structure for the map. Values to be displayed with the map are taken from it and, after the terminal interrupt, values from the map are returned into it.

attype (returned by GDDM) (fullword integer)
The type of attention interrupt received. See ASREAD for a description of this parameter.

attval (returned by GDDM) (fullword integer)
The value, if any, associated with the attype parameter. See ASREAD for a description of this parameter.

Note: If MSREAD is issued for a partitioned device, and the input is not in the same partition as that in which the map was output, no data is returned to the application program in the ads parameter.

Description

Displays a map, waits for an interrupt from the terminal, and returns data from the map. MSREAD provides a convenient combination of operations to perform simple mapping input and output. It operates within the current partition, but creates its own temporary page, leaving the current page status unchanged. MSREAD is essentially equivalent to the sequence: MSPCRT, MSDFLD, MSPUT, ASREAD, MSGET, and FSPDEL.

Principal errors

ADM0962 E: MAPGROUP 'a' NOT FOUND
ADM0963 E: OBJECT 'a' IS NOT A MAPGROUP
ADM0964 S: MAPGROUP 'a' IS CORRUPTED
ADM0970 E: MAP 'a1' IS NOT IN MAPGROUP 'a2'
ADM0973 E: INSUFFICIENT SPACE LEFT IN FLOATING AREA FOR MAPPED FIELD a
ADM0980 E: DATA LENGTH (n) IS SMALLER THAN LENGTH OF ADS (a) OF MAP
ADM0981 E: type ATTRIBUTE SELECTOR FOR '{FIELD n|xxxxxx|xxxxxx(m)}' IS NOT BLANK, 1, 2, OR 3
ADM0982 E: CURSOR SELECTOR FOR '{FIELD n|xxxxxx|xxxxxx(m)}' IS NOT BLANK OR 1
ADM0983 E: type ATTRIBUTE FOR '{FIELD n|xxxxxx|xxxxxx(m)}' IS INVALID
ADM0990 W: MAP-DEFINED GRAPHIC FIELD IS OUTSIDE PAGE
ADM0991 W: MAPPED FIELD a IS POSITIONED OUTSIDE THE PAGE
ADM0992 I: MAPPED FIELD a IS PARTIALLY OUTSIDE THE PAGE

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