CICS Cours

CICS – CICS RETURN

Commande CICS RETURN :

La commande RETURN passe le contrôle au niveau supérieur suivant. Lorsque le programme est au niveau logique le plus élevé sous CICS (niveau 1), la commande RETURN redonne le contrôle à CICS.

Syntaxe:

EXEC CICS
           RETURN
           [TRANSID(next-id)]
           [COMMAREA(comm-area)]
           [LENGTH(longueur)]
END-EXEC.
  • TRANSID
    Spécifie le prochain identifiant de transaction à exécuter à partir du terminal associé à la transaction en cours. Il s’agit de la transaction qui est exécutée la prochaine fois que le terminal envoie une entrée. Cela ne peut être émis que par des transactions au niveau logique 1.
  • COMMAREA
    Un paramètre facultatif. C’est le nom de la zone contenant les données à transmettre à la prochaine transaction qui sera exécutée sur ce terminal. LENGTH spécifie la longueur de la COMMAREA.

Lorsque le contrôle est rendu à CICS, deux options supplémentaires de la commande RETURN peuvent être spécifiées :

  • La prochaine transaction peut être spécifiée pour être exécutée lorsque la prochaine entrée provient du même terminal. Cette option permet de développer des applications en mode pseudo conversationnel dont il sera question plus loin.
  • Les données à transmettre à la transaction suivante peuvent être spécifiées.

Exemple:

Retour simplifié :

Le sous-programme vient d’émettre un RETURN sans aucune option comme ci-dessous.

EXEC CICS
    RETURN
END-EXEC.

Par exemple, si certaines données doivent être renvoyées au programme appelant, elles peuvent être renvoyées via commarea. Pour cela, les données requises doivent être remplies dans DFHCOMMAREA avant d’émettre la déclaration.

MOVE WW-CUST-DATA TO DFHCOMMAREA.
EXEC CICS
    RETURN
END-EXEC.

Option de retour avec ID de transaction :

EXEC CICS RETURN
     TRANSID(WS-TRAN-ID)
     COMMAREA(WS-COMM-AREA)
     LENGTH(WS-COMM-LGTH)
END-EXEC.

Cette option est généralement utilisée dans les programmes impliquant des écrans. Une fois que l’écran initial renvoie le contrôle à l’écran et lorsque l’utilisateur saisit des clés d’identification d’attention, l’identifiant de transaction spécifié devient actif et la commarea envoyée sera utilisée dans ce processus.