RCVDST

La commande RCVDST (Recevoir une distribution) permet de recevoir des distributions entrantes, telles que des documents ou des fichiers. Ceux-ci peuvent être placés dans des dossiers ou documents, ou encore dans un fichier de sortie en vue de leur traitement.

Restriction : Le demandeur doit être inscrit dans le répertoire de distribution du système. Pour obtenir des informations sur des distributions pour le compte d'un autre utilisateur, vous devez avoir obtenu une procuration de ce dernier. Une telle procuration est donnée au moyen de la commande GRTUSRPMN (Accorder une procuration à un utilisateur). Un demandeur ne peut recevoir de distribution personnelle lorsqu'il travaille par procuration.

Paramètres

Identificateur de distribution (DSTID)

Indique l'identificateur unique de la distribution. Seules les distributions entrantes peuvent être reçues. Si l'identificateur renvoie à une distribution sortante, un message d'erreur est émis.

ID-distribution

L'identificateur de distribution comporte trois éléments, qui apparaissent dans l'ordre suivant : la deuxième partie du code ID de l'expéditeur, la première partie de ce code (comptant toutes deux 8 positions comblées, au besoin, par des caractères de remplissage à droite) et un numéro de séquence de 4 chiffres, en décimal étendu, avec zéros à gauche. Par exemple : 'NEWYORK SMITH 0204'. Ce paramètre est obligatoire lorsque la valeur *DSTID est indiquée à l'invite Information à envoyer (paramètre TYPE).

Ce paramètre est obligatoire.

Identificateur utilisateur (USRID)

ID utilisateur et adresse à associer à la demande.

*CURRENT

Vous exécutez la demande pour votre compte.

ID-utilisateur

Indiquez l'ID d'un autre utilisateur ou le vôtre. Vous devez disposer des droits appropriés pour travailler pour le compte d'un autre utilisateur.

adresse-ID-utilisateur

Indiquez l'adresse d'un autre utilisateur ou la vôtre. Vous devez disposer des droits appropriés pour travailler pour le compte d'un autre utilisateur.

Document (DOC)

Nom du document dans lequel la distribution reçue sera placée. Ce document ne doit pas exister ; il est créé en tant que document privé. Il vous appartient ou appartient à un utilisateur qui vous a donné une procuration.

*NONE

La distribution reçue n'est pas placée dans un document.

nom-du-document

Indiquez le nom du document dans lequel la distribution est placée. Vous pouvez entrer jusqu'à 12 caractères.

Dans le dossier (FLR)

Nom du dossier qui contient le document recevant la distribution. Ce dossier doit exister et vous devez être autorisé à y créer de nouveaux documents.

*NONE

Le document reçu n'est pas placé dans un dossier. Entrez cette valeur s'il est reçu dans un fichier base de données en vue de son traitement, et si aucune valeur n'est précisée à l'invite Document (paramètre DOC).

nom-du-dossier

Indiquez le nom du dossier contenant le document. Ce nom peut se composer d'une série de noms de dossiers si le document se trouve dans un dossier contenu dans un autre dossier. Vous pouvez entrer jusqu'à 63 caractères.

Fichier recevant la sortie (OUTFILE)

Nom et bibliothèque du fichier base de données dans lequel la sortie est envoyée. S'il n'existe pas de fichier de sortie, cette commande crée un fichier base de données dans la bibliothèque précisée. Le droit des utilisateurs sans droit spécifique est le même que le droit pour objets créés de la bibliothèque dans laquelle le fichier est créé. Ce droit peut être affiché à l'aide de la commande DSPLIBD (Afficher une description de bibliothèque).

*NONE

La sortie n'est pas envoyée dans un fichier base de données.

nom-du-fichier-base-de-données

Indiquez le nom du fichier base de données recevant la sortie.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*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

Le fichier base de données est recherché dans la bibliothèque en cours pour ce travail. Si aucune bibliothèque en cours ne figure dans la liste des bibliothèques, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque où se trouve le fichier base de données.

Remarque :Pour créer un nouveau fichier, le système utilise le fichier modèle QAOSIRCV de la bibliothèque QSYS, avec un nom de format OSRCVD.

Options pour membre de sortie (OUTMBR)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

Les valeurs possibles pour le membre recevant la sortie sont les suivantes :

*FIRST

Le premier membre du fichier reçoit la sortie. Si ce membre n'existe pas, le système en crée un du nom du fichier indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

nom-du-membre

Indiquez le nom du membre de fichier recevant la sortie. Si ce membre n'existe pas, le système le crée. S'il existe, le système ajoute à la fin les nouveaux enregistrements ou le met d'abord à blanc avant d'y ajouter les enregistrements.

Les valeurs possibles pour l'ajout ou le remplacement sont les suivantes :

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Type de données en sortie (OUTDTATYP)

Type de données relatives à la distribution, écrit dans le fichier base de données.

*DFT

Les codes d'enregistrement suivants sont écrits dans le fichier de sortie :

Code enreg

Description

010

Description de la distribution

020

Texte du message

105

Description du document

800

Données du document

*ALL

Tous les formats d'enregistrement sont écrits dans le fichier de sortie.

*DSTINFO

L'enregistrement de la description de la distribution est écrit (code 010).

*MSG

L'enregistrement du texte du message est écrit (code 020).

*DOCD

L'enregistrement de descriptions sur le document est écrit. Le code d'enregistrement est 105.

*DOCCLS

L'enregistrement de la classe du document est écrit (code 155).

*SUBJECT

L'enregistrement du sujet est écrit (code 165).

*FILCAB

L'enregistrement de la référence du classeur est écrit (code 160).

*AUTHOR

L'enregistrement de l'auteur est écrit (code 145).

*KWD

Les enregistrements de mot clé sont écrits (code 170).

*CPYLST

Les enregistrements de liste de copie sont écrits (code 150).

*FILDATE

L'enregistrement de la date du fichier est écrit (code 125).

*EXPDATE

L'enregistrement de la date d'expiration est écrit (code 115).

*DOCDATE

L'enregistrement de la date du document est écrit (code 120).

*CRTDATE

L'enregistrement de la date de création est écrit (code 110).

*ACTDATE

L'enregistrement de la date d'échéance est écrit (code 135).

*CHGDATE

L'enregistrement de la date de dernière modification est écrit (code 130).

*CMPDATE

L'enregistrement de la date d'achèvement est écrit (code 140).

*REF

L'enregistrement de la référence est écrit (code 175).

*STATUS

L'enregistrement de l'état est écrit (code 180).

*PROJECT

L'enregistrement relatif au projet est écrit (code 185).

*AUTUSR

L'ID utilisateur et l'adresse sont écrits. Il s'agit de l'utilisateur qui a autorisé la distribution (code 190).

*DSTEXPDATE

La date et l'heure d'expiration sont écrites (code 195).

*RPYDATE

La date et l'heure relatives à la réponse demandée sont écrites (code 200).

*IDP

L'enregistrement relatif au profil d'échange du document (IDP) est écrit (code 500).

*DOC

Les enregistrements des données du document sont écrits (code 800).

Accuser réception (ACKRCV)

Indique si un accusé de réception doit être envoyé à l'expéditeur de la distribution.

*YES

L'accusé de réception est envoyé à l'expéditeur.

*NO

L'accusé de réception n'est pas envoyé à l'expéditeur.

Suffixe ID de distribution (DSTIDEXN)

Indique le suffixe de l'identificateur de distribution, s'il en existe un, précisé à l'invite Identificateur de distribution(paramètre DSTID). Ce suffixe, qui est composé de deux chiffres, peut prendre une valeur de 01 et 99 et identifie de façon spécifique les distributions en double. La valeur par défaut est 01.

*NONE

Il n'y a pas de distribution en double. La valeur *NONE correspond au suffixe 01.

suffixe-ID-distribution

Indiquez le suffixe associé à la distribution, ce qui permettra d'identifier de façon spécifique les distributions en double.

Garder dans registre courrier (KEEP)

Indique si la distribution reçue doit être effacée ou non du registre courrier.

*NO

La distribution est supprimée du courrier Arrivée de l'utilisateur une fois que les informations demandées ont été écrites dans OUTFILE ou DOC.

*YES

La distribution n'est pas supprimée du courrier Arrivée de l'utilisateur une fois que les informations demandées ont été écrites dans OUTFILE ou DOC.

ID caractères pour commande (CMDCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant aux données saisies comme valeurs des paramètres de la commande. Cet identificateur dépend de l'écran utilisé pour l'entrée de la commande.

Si les valeurs entrées aux invites Identificateur de distribution (paramètre DSTID) et Identificateur utilisateur (paramètre USRID) sont extraites d'un fichier de sortie créé à l'aide de la commande QRYDST (Interroger les distributions), utilisez la valeur '930 500' pour ce paramètre.

*SYSVAL

Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.

*DEVD

Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767

Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767

Indiquez la page de codes à utiliser.

Exemples

Exemple 1 : réception de la distribution en cours de l'utilisateur

RCVDST   DISTID('SYSTEME1 UTILISATEURA 0001')
         OUTFILE(MYLIB/MYFILE)  OUTMBR(MYMBR *ADD)
         OUTDTATYP(*ALL)  CMDCHRID(*DEVD)

Cette commande permet de recevoir la distribution en cours de l'utilisateur dans le fichier de sortie MYFILE situé dans la bibliothèque MYLIB. La distribution est ajoutée au membre MYMBR. Toutes les informations du fichier de sortie sont ajoutées au fichier de sortie MYFILE.

Exemple 2 : réception d'une distribution envoyée à un utilisateur

RCVDST   DSTID('DURANT RCH38P 0019')  DSTINDEXN(01)
         OUTFILE(JOWLIB/DOCUMENTS)  USRID(*CURRENT)

Cette commande permet de recevoir une distribution envoyée à un utilisateur. Elle est copiée dans le premier membre d'un fichier de base de données nommé DOCUMENTS, situé dans une bibliothèque appelée JOWLIB.

Messages d'erreur

Messages *ESCAPE

CPF8A87

Le nom de document &2 est incorrect.

CPF8A97

Le nom de dossier &1 est incorrect.

CPF900B

ID util et adresse &1 &2 introuvables dans répertoire système.

CPF900C

L'ouverture de session et la vérification d'inscription de l'util ont échoué.

CPF905C

Erreur lors de la recherche d'une table de conversion.

CPF9096

Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.

CPF9098

Distribution non reçue.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9860

Erreur lors du traitement du fichier de sortie.