RCVNETF

La commande RCVNETF (Recevoir un fichier du réseau) permet de recevoir un fichier du réseau et de copier ses enregistrements dans un fichier physique base de données ou un fichier sauvegarde. Une fois reçu, le fichier est supprimé de la file d'attente des fichiers du réseau.

Si le fichier d'origine est un fichier sauvegarde, il doit être reçu dans un fichier sauvegarde. Pour qu'un fichier puisse être reçu, le fichier spécifié par le paramètre TOFILE doit déjà exister.

Lorsqu'un fichier physique source est envoyé, le numéro de séquence source et la date de modification aux positions 1 à 12 de l'enregistrement sont envoyés avec le fichier. Ces éléments sont conservés si le fichier est reçu dans un fichier physique source et sont tronqués dans le cas contraire. Lorsqu'un fichier physique non source à l'origine est reçu dans un fichier physique source, les numéros d'ordre du source sont créés et placés en regard des enregistrements.

Si le fichier est un fichier physique, la longueur d'enregistrement du fichier de destination doit être au moins égale à la longueur d'enregistrement du fichier d'origine. Si la longueur d'enregistrement du fichier de destination est supérieure à celle du fichier d'origine, la fin des enregistrements est complétée avec la valeur d'enregistrement par défaut du fichier de destination.

Cette commande n'effectue pas de conversion de CCSID sur le contenu du fichier. Néanmoins, l'ID utilisateur et l'adresse du destinataire et de l'expéditeur sont converties du jeu de caractères multinational 697/500 dans le CCSID du travail en cours.

Restrictions :

1. Un utilisateur disposant du droit de responsable de la sécurité peut recevoir les fichiers envoyés à tout autre utilisateur. Les utilisateurs disposant de droits autres que celui de responsable de la sécurité ne peuvent recevoir que les fichiers qui leur sont envoyés ou sont envoyés à leur profil de groupe.
2. L'utilisateur doit disposer du droit de lecture sur la bibliothèque contenant le fichier de destination, et des droits d'utilisation et d'ajout sur le fichier de destination. Les droits suivants peuvent être requis :
   • Droit de gestion de l'objet, si un membre est ajouté au fichier.
   • Droit de gestion de l'objet et droit de suppression, si un fichier sauvegarde ou un membre de fichier physique est mis à blanc.

Paramètres

Fichier d'origine (FROMFILE)

Indique le nom du fichier qui est reçu. Il s'agit du nom que porte le fichier sur le système émetteur.

Ce paramètre est obligatoire.

Fichier de destination (TOFILE)

Indique le nom du fichier qui reçoit le fichier du réseau. Les substitutions à ce fichier ne sont pas prises en compte.

Les valeurs possibles sont les suivantes :

*FROMFILE

Le fichier du réseau est reçu dans un fichier portant le même nom que le fichier envoyé.

nom-fichier

Indiquez le nom et la bibliothèque du fichier destinataire.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*LIBL

Le fichier est recherché dans la liste des bibliothèques.

*CURLIB

Le fichier est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque contenant le fichier.

Nom du membre à recevoir (FROMMBR)

Indique le nom du membre reçu.

Les valeurs possibles sont les suivantes :

*ONLY

Un seul membre est reçu pour ce fichier. Si *ONLY est indiqué en réponse à l'invite Numéro de fichier (paramètre NBR), la file d'attente des fichiers reçus ne contient qu'un seul membre par fichier.

nom-membre

Indiquez le nom du membre reçu. Vous ne pouvez pas indiquer de nom de membre s'il s'agit d'un fichier sauvegarde.

Membre de destination (TOMBR)

Indique le membre du fichier base de données qui reçoit les données.

Les valeurs possibles sont les suivantes :

*FROMMBR

Les données sont reçues dans un membre de même nom que celui indiqué en regard de l'invite Nom du membre à recevoir (paramètre FROMMBR).

*FIRST

Le premier membre du fichier reçoit les données en sortie.

nom-membre

Indiquez le nom du membre qui reçoit les enregistrements. Vous ne pouvez pas indiquer de nom de membre s'il s'agit d'un fichier sauvegarde.

Remplacement ou ajout enregs (MBROPT)

Indique si les nouveaux enregistrements remplacent ou sont ajoutés aux enregistrements existants.

Les valeurs possibles 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.

Numéro de fichier (NBR)

Indique le numéro du fichier reçu. Ce numéro permet d'identifier le membre reçu lorsque plusieurs membres portent le même nom.

Les valeurs possibles sont les suivantes :

*LAST

Le dernier membre du fichier du réseau indiqué est reçu. Ce membre est celui qui arrive en dernier sur votre système.

Remarque :Le membre de fichier arrivé en dernier sur le système de l'utilisateur peut ne pas être le dernier envoyé par l'émetteur. Le réseau ne garantit pas l'ordre d'arrivée de fichiers envoyés séparément.

*ONLY

Un seul membre du fichier indiqué est reçu.

numéro-membre

Indiquez le numéro du membre à recevoir.

Utilisat (USER)

Indique l'utilisateur à qui le fichier a été envoyé.

Les valeurs possibles sont les suivantes :

*CURRENT

Les fichiers envoyés à l'utilisateur en cours sont reçus.

nom-utilisateur

Indiquez le nom de l'utilisateur à qui sont envoyés les fichiers. Seuls les utilisateurs qui disposent des droits du responsable de la sécurité peuvent indiquer un nom différent du leur ou de leur profil de groupe.

Type de fichier d'origine (FROMTYPE)

Indique le type du fichier reçu. Cette option sera principalement utilisée s'il s'agit d'un fichier source System i5 ou IBM 38 envoyé par l'utilisateur d'un système 370 VM ou MVS. Les systèmes VM et MVS ne pouvant pas identifier un fichier source, vous pouvez préciser s'il s'agit d'un fichier source ou non.

Les valeurs possibles sont les suivantes :

*NETFILE

Le type du fichier du réseau permet de déterminer si une conversion de type de fichier est nécessaire.

S'il ne s'agit pas d'un fichier source et qu'il est :

• reçu dans un fichier non source, la conversion n'a pas lieu.
• reçu dans un fichier source, les zones Numéro de séquence et Date sont ajoutées.

S'il s'agit d'un fichier source et qu'il est :

• reçu dans un fichier non source, les zones Numéro de séquence et Date sont supprimées (soit les 12 premiers octets de chaque enregistrement).
• reçu dans un fichier source, la conversion n'a pas lieu.

*SRC

Le fichier reçu est un fichier source. Les zones Numéro de séquence et Date figurent dans le fichier. Si le fichier est reçu dans un autre fichier source, ces zones ne sont pas ajoutées. Par contre, si le fichier est reçu dans un fichier non source, elles sont supprimées (soit les 12 premiers octets de chaque enregistrement).

Remarque :*SRC ne doit pas être indiqué si le fichier du réseau ne contient pas de zones Numéro de séquence et Date dans les 12 premiers octets de chaque enregistrement.

Exemples

Exemple 1 : réception d'un membre

RCVNETF   FROMFILE(FILEA)  TOFILE(FILEB/FILEA)
          FROMMBR(PAYROLL)

Cette commande permet de recevoir le membre PAYROLL du fichier FILEA dans le membre PAYROLL du fichier FILEA de la bibliothèque FILEB. Si un membre existant porte ce nom, les enregistrements de celui-ci sont remplacés. Si plusieurs membres de ce nom sont disponibles, le dernier d'entre eux qui arrivera au système de destination sera reçu.

Exemple 2 : réception d'un fichier réseau

RCVNETF   FROMFILE(PERSONNEL)  NBR(*LAST)  USER(USR1)

Cette commande permet de recevoir un fichier réseau nommé PERSONNEL, envoyé à l'utilisateur USR1, dans un fichier portant le même nom. Le paramètre FROMMBR n'étant pas défini, ce fichier doit comporter un seul nom de membre. USR1 étant défini, cette commande est accessible uniquement par un utilisateur ayant le profil USR1, par un utilisateur ayant un profil de groupe de USR1 ou par un utilisateur disposant des droits d'accès de responsable de la sécurité.

Exemple 3 : réception d'un fichier source

RCVNETF   FROMFILE(FILEA)  TOFILE(FILEB/FILEA)
          FROMMBR(PAYROLL)  FROMTYPE(*SRC)

Cette commande indique que le fichier reçu est un fichier source et que les numéros de séquence et les champs de date ne sont pas ajoutés à ce fichier.

Messages d'erreur

Messages *ESCAPE

CPF2204

Profil utilisateur &1 non trouvé.

CPF2207

Non autorisé à utiliser objet &1 de &3 type *&2.

CPF4101

Fichier &2 de &3 non trouvé ou fichier spoule en entrée manquant.

CPF5715

Fichier &1 non trouvé dans la bibliothèque &2.

CPF8057

&1 de &2 n'est ni un fichier physique ni un fichier sauvegarde.

CPF8059

Nom de membre non admis pour les fichiers sauvegarde.

CPF8060

Aucun fichier correspondant à la sélection indiquée.

CPF8062

Longueur d'enreg du fichier réseau supérieure à celle du fichier destination.

CPF8063

La ressource nécessaire ne peut pas être allouée.

CPF8070

Non autorisé à traiter des fichiers pour l'utilisateur &1.

CPF8077

Plusieurs fichiers portent le nom indiqué. Voir messages précédents.

CPF8080

MBROPT(*ADD) non admis pour fichier sauvegarde.

CPF8081

Fichier &5 membre &6 numéro &7 déjà traité.

CPF8082

Impossible d'allouer le fichier réseau &5 mbr &6 numéro &7.

CPF9005

Les ressources système nécessaires pour traiter cette demande ne sont pas disponibles.

CPF9006

Utilisateur non inscrit dans le répertoire de distribution du système.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9807

Une ou plusieurs bibliothèques de la liste ont été supprimées.

CPF9808

Allocation impossible pour une ou plusieurs bibliothèques de la liste.

CPF9810

Bibliothèque &1 non trouvée.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9843

Accès à l'objet &1 de &3 type &2 impossible.

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.

CPF9848

Ouverture du membre &3 du fichier &1 de &2 impossible.

CPF9849

Erreur lors du traitement du membre &3 de &1 dans &2.