ENDRCV

Arrêter la réception

En bref

La commande ENDRCV (Arrêter la réception) permet d'arrêter (d'annuler) une demande d'entrée émise précédemment par une commande RCVF ou SNDRCVF avec le paramètre WAIT(*NO).

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

Syntaxe minimale

ENDRCV

Paramètres

DEV Unité écran
OPNID ID ouverture fichier

Astuce : dans une session 5250, tapez ENDRCV 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 :

Programme batch (*BPGM)
Programme interactif (*IPGM)

Compatible multitâche : Non

La commande ENDRCV (Arrêter la réception) permet d'arrêter (d'annuler) une demande d'entrée émise précédemment par une commande RCVF ou SNDRCVF avec le paramètre WAIT(*NO). Lors de l'exécution de la commande ENDRCV, la demande d'entrée est annulée même si l'utilisateur est en train de saisir les données demandées sur son clavier-écran. Dans ce cas, les données demandées, entrées puis envoyées au programme sont perdues. Si aucune demande d'entrée n'est en attente, la commande n'est pas prise en compte.

Restrictions :

Cette commande est valide uniquement pour les fichiers écran dans un programme CL ou une procédure CL ILE. Elle ne peut pas être employée pour les fichiers base de données.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité écran	Nom, *FILE	Facultatif, positionnel 1
OPNID	ID ouverture fichier	Nom simple, *NONE	Facultatif

Unité écran (DEV)

Indique le nom de l'unité-écran pour laquelle la demande d'entrée doit être annulée.

*FILE: Nom de l'unité dont la réponse doit être annulée. Il figure dans le fichier unité déclaré dans le paramètre Fichier (FILE) de la commande DCLF (Déclarer un fichier). Si le fichier unité contient plusieurs noms d'unité, vous ne pouvez pas indiquer *FILE.
nom: Indiquez le nom de l'unité-écran à partir de laquelle une réponse doit être annulée.

ID ouverture fichier (OPNID)

Indique l'ID d'ouverture de fichier déclaré dans une commande DCLF (Déclarer un fichier) précédente dans le même programme CL ou la même procédure CL ILE. Vous ne pouvez pas indiquer une variable CL comme valeur de ce paramètre.

*NONE: Aucun ID d'ouverture de fichier n'est fourni. Cette commande utilise le fichier associé à la commande DCLF ayant *NONE indiqué au paramètre OPNID. Un seul fichier peut être déclaré dans un programme CL ou une procédure CL ILE ayant *NONE comme ID d'ouverture de fichier.
nom-simple: Indiquez le nom correspondant à la valeur du paramètre OPNID indiqué dans une commande DCLF précédente dans le même programme CL ou la même procédure CL ILE.

Exemples

Exemple 1 : Arrêt de la commande RCVF précédente

ENDRCV   DEV(MYDISPLAY)

Supposez qu'une commande RCVF avec WAIT(*NO) a été émise au préalable dans le programme CL ou la procédure CL ILE pour demander la réception à partir d'un fichier d'unité déclaré auparavant dans la commande DCLF et à partir de l'unité-écran MYDISPLAY. Lorsque cette commande ENDRCV est traitée, la demande de réception à partir de MYDISPLAY prend fin.

Exemple 2 : Utilisation d'un ID d'ouverture de fichier

DCLF   FILE(MYLIB/MYDSPFILE)  RCDFMT(FMT1)  OPNID(DSPFILE1)
 :
SNDRCVF   DEV(DSP02)  RCDFMT(FMT1)  OPNID(DSPFILE1)  WAIT(*YES)
 :
ENDRCV   DEV(DSP02)  OPNID(DSPFILE1)

Cette commande termine la demande précédente de la commande SNDRCVF (Envoyer/recevoir un fichier) de réception à partir d'une unité-écran de poste de travail DSP02.

Messages d'erreur

Messages *ESCAPE

CPF0883: *FILE incorrect pour le paramètre DEV, dans le fichier &1.
CPF4101: Fichier &2 de &3 non trouvé ou fichier spoule en entrée manquant.