GO

La commande GO (Aller à un menu) permet d'afficher un menu. Vous pouvez indiquer un nom de menu particulier ou générique. Vous pouvez également vous réserver la possibilité de revenir, une fois le menu affiché, au menu à partir duquel la commande a été lancée.

Utilisation des touches Précédent et Exit

Avant l'exécution d'un menu, celui-ci est placé dans une pile de menu interne. Si le menu ne dispose pas de pile, celle-ci est créée. Lorsque vous appuyez sur la touche Annulation dans un menu, le menu précédent de la pile s'affiche. Chaque pile de menu comporte dix éléments (menus). Lorsque le onzième menu est placé dans la pile de menu, le premier (ou l'ancien) menu est supprimé de la pile. La touche Annulation ne permet pas de revenir à ce menu.

Appuyez sur la touche Exit pour revenir au dernier écran ou menu à partir duquel vous avez indiqué RTNPNT(*YES) dans une commande GO. Pour rechercher l'écran auquel l'utilisateur revient, ce dernier doit supprimer des menus de la pile de menu jusqu'à ce qu'un point de retour soit trouvé. Il se peut que ce processus renvoie un programme de la pile d'appel à son programme appelant sauf si le programme est un point de retour.

L'utilisateur revient au menu lorsqu'il appuie sur la touche Exit ou Annulation lors de la visualisation de l'aide relative à un menu.

Restrictions :

• Vous devez disposer des droits *USE sur le menu, l'écran associé et, selon le cas, les fichiers de messages et de programme.
• Vous devez également disposer du droit *USE sur la bibliothèque contenant le menu.

Paramètres

Menu (MENU)

Indique le menu à afficher.

Ce paramètre est obligatoire.

Qualificatif 1 : Menu

*ALL

La liste de l'ensemble des menus de la bibliothèque indiquée apparaît à l'écran. Vous pouvez, à partir de cette liste, choisir le menu à afficher.

nom-générique

Indiquez le nom générique du menu à afficher. Un nom générique est une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*). La liste de l'ensemble des menus dont le nom commence par les caractères inclus dans la chaîne apparaît à l'écran. Vous pouvez, à partir de cette liste, choisir le menu à afficher.

nom

Indiquez le nom du menu à afficher.

Qualificatif 2: Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Point de retour (RTNPNT)

Indique si la touche EXIT permet ou non de revenir à l'écran à partir duquel la commande a été entrée.

*YES

La touche Exit permet de revenir à l'écran à partir duquel la commande a été entrée.

*NO

La touche Exit ne permet pas de revenir à l'écran à partir duquel la commande a été entrée.

Exemples

GO   MENU(PERSMENU)

Cette commande permet d'exécuter un menu appelé PERSMENU, stocké dans une bibliothèque identifiée en lançant une recherche dans la liste de bibliothèques (valeur par défaut *LIB).

Si vous appuyez sur la touche Exit lors de l'affichage du menu PERSMENU, l'écran dans lequel la commande GO a été entrée (valeur par défaut *YES pour le paramètre RTNPNT) s'affiche.

Messages d'erreur

Messages *ESCAPE

CPF6ACD

Menu &1 de &2 incompatible avec édition du système.

CPF6AC7

Menu &1 de &2 non affiché.