La commande RECEIVE MAP est utilisée pour extraire des données d’entrée d’un terminal dans une zone de données dans un programme d’application pour traitement.
Syntaxe:
Vous trouverez ci-dessous la syntaxe de la commande CICS RECEIVE MAP.
EXEC CICS RECEIVE
MAP('nom-map')
MAPSET('nom-mapset')
[INTO(zone-donnee)]
[FROM(zone-donnee
)]
[LENGTH(valeur-donnee)]
END-EXEC.
Voyons les paramètres utilisés dans la commande RECEIVE MAP.
- MAP(‘nom-map’)
Spécifie le nom de la map à utiliser. - MAPSET(‘nom-mapset’)
Spécifie le nom du mapset à utiliser. Il est nécessaire sauf si le nom de l’ensemble de maps est le même que le nom de la map. - INTO(zone-donnee)
Spécifie la zone de données dans laquelle les données mappées doivent être écrites. Si ce champ n’est pas spécifié, le nom par défaut est le nom de la map suffixé par un I. - FROM(zone-donnee)
Spécifie la zone de données contenant les données à mapper par une commande RECEIVE MAP. - LENGTH(valeur-donnee)
Spécifie la longueur des données à formater en tant que valeur binaire de demi-mot. Elle ne doit pas dépasser la longueur de la zone de données FROM.
Exemple:
L’exemple suivant vous montre comment recevoir les données d’entrée dans le champ ‘MAPNOMI’.
EXEC CICS RECEIVE
MAP('nom-map')
MAPSET('nom-mapset')
INTO(MAPNOMI)
END-EXEC.