ENDRQS

Arrêter la demande en cours

En bref

La commande ENDRQS (Arrêter la demande en cours) permet d'annuler une opération demandée (commande).

ENDRQS se lit END (Arrêter) + RQS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDRQS

Paramètres

RQSLVL Niveau de demande

Astuce : dans une session 5250, tapez ENDRQS puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande ENDRQS (Arrêter la demande en cours) permet d'annuler une opération demandée (commande). Cette commande est généralement utilisée pour annuler une demande interrompue à un point d'arrêt. Elle peut également être lancée à partir du menu Appel Système.

Il peut arriver que la commande ENDRQS (Arrêter la demande en cours) ne soit pas traitée immédiatement ; c'est le cas lorsqu'une fonction système ne pouvant pas être interrompue est en cours d'exécution.

Lorsqu'une demande est arrêtée, un message d'arrêt programme est envoyé au programme traitant la demande, pour le niveau de demande à annuler. Les programmes de traitement de demandes peuvent être annulés. Ils peuvent intercepter ce message pour effectuer toutes les opérations d'apurement liées à l'annulation de la demande (remise à blanc, etc.) La mémoire statique et les fichiers ouverts sont récupérés pour les programmes appelés par le programme de traitement de demandes. Ces programmes n'étant pas avertis de l'annulation, ils n'ont pas la possibilité d'interrompre le traitement.

Un programme doit recevoir un message de demande (type *RQS) pour devenir un programme de traitement de demandes.

Si la commande ENDRQS fait partie d'un programme, ce dernier doit devenir un programme de traitement de demandes avant d'exécuter cette commande.

Pour plus de détails sur la configuration d'un programme devant être remplacé par un programme de traitement de demandes, reportez-vous au manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Les objets externes verrouillés par la commande ALCOBJ (Allouer un objet) ne sont pas déverrouillés à la suite de l'annulation de la demande.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RQSLVL	Niveau de demande	Entier, *PRV	Facultatif, positionnel 1

Niveau de demande (RQSLVL)

Indique le niveau de demande auquel a été entrée la commande à annuler.

*PRV: La commande à annuler a été entrée au niveau précédent.
entier: Précisez le niveau de demande auquel a été entrée la commande à annuler. Tous les niveaux de demande compris entre le niveau indiqué et le niveau actuel sont annulés.

Exemples

Exemple 1 : arrêt d'une commande

CALL PROGA        (Niveau 1)
 :
Point d'arrêt
CALL PROGB        (Niveau 2)
 :
Point d'arrêt
ENDRQS         (Niveau 3)

Dans cet exemple, puisque RQSLVL(*PRV) intervient par défaut, la demande formulée au niveau 2 est annulée. L'utilisateur peut ensuite entrer une autre commande au niveau 2 ou appuyer sur F3 pour afficher à nouveau l'écran de point d'arrêt PROGA.

Exemple 2 : arrêt d'une commande

CALL PROGA        (Niveau 1)
 :
Point d'arrêt
CALL PROGB        (Niveau 2)
 :
Point d'arrêt
ENDRQS  RQSLVL(1) (Niveau 3)

Dans cet exemple, la demande formulée au plus haut niveau (CALL PROGA) est annulée. Par conséquent, toute demande formulée entre le niveau 1 et le niveau 3 est également annulée.

Messages d'erreur

Aucun