MSQMAP

GDDM V3R2 Base Application Programming Reference

MSQMAP

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To query map characteristics.


   MSQMAP      (group-name, map-name, element-no, count, array)

   APL code               1104
   GDDM RCP code          X'0C280301' (203948801)

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 can be read from auxiliary storage.

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

element-no (specified by user) (fullword integer)
The number of the first element in the returned array. It must have a value in the range 1 through 6.

count (specified by user) (fullword integer)
The number of fullwords in the returned array.

array (returned by GDDM) (an array of fullword integers)
A list of fullword values returned by this call.

1, 2

The origin of the map with respect to the page. These have values of -1 for the SAME floating option and 0 for the NEXT floating option. (SAME and NEXT are the line, or column, or both of these options specified when the map was defined under the Interactive Map Definition).

3, 4

The depth and width of the map.

5

The length of the ADS as defined in the map.

6

The length of the ADS descriptor as returned by the MSQADS call.

Description

Returns information about a map within a mapgroup. Neither the map nor the mapgroup need be in use by a page.

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'

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