SNDNETF

Envoyer un fichier au réseau

En bref

La commande SNDNETF (Envoyer un fichier au réseau) permet d'envoyer un fichier sauvegarde ou un membre de fichier physique base de données à un autre utilisateur d'un système local ou éloigné via le réseau SNADS.

SNDNETF se lit SND (Envoyer) + NETF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SNDNETF FILE(…) TOUSRID(…)

Paramètres

FILE Fichier obligatoire
TOUSRID ID utilisateur obligatoire
MBR Membre
TOTYPE Type de fichier de destination
CLASS Classe VM/MVS
FORMAT Format d'envoi
PTY Priorité d'envoi

Astuce : dans une session 5250, tapez SNDNETF 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 : Tous les environnements (*ALL)
Compatible multitâche : Non

Envoyer des fichiers de données à un utilisateur.
Envoyer des fichiers source à un utilisateur. Les informations relatives à la séquence du source sont conservées dans les fichiers envoyés.
Envoyer à un utilisateur d'autres types d'objets stockés dans un fichier sauvegarde.

Lorsqu'un fichier arrive à destination, un message est envoyé au destinataire et à l'expéditeur du fichier.

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.

Remarque :Les fichiers sauvegarde créés sur le système System i5 ne peuvent pas être distribués sur l'IBM 38. Toutefois, les fichiers sauvegarde créés sur l'IBM 38 peuvent être distribués sur le System i5.

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 CCSID du travail en cours dans le jeu de caractères multinational 697/500.

Restrictions :

L'utilisateur doit être inscrit dans le répertoire de distribution du système.
La taille maximale d'un fichier pouvant être envoyé à l'aide de la commande SNDNETF est de 2 milliards d'octets (environ).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TOUSRID	ID utilisateur	Values (jusqu'à 50 répétitions): Liste d'éléments	Obligatoire, positionnel 2
	Élément 1: ID utilisateur	Valeur caractère
	Élément 2: Adresse	Valeur caractère
MBR	Membre	Nom, *FIRST	Facultatif, positionnel 3
TOTYPE	Type de fichier de destination	FROMFILE, DATA	Facultatif
CLASS	Classe VM/MVS	A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9	Facultatif
FORMAT	Format d'envoi	V, F, *U	Facultatif
PTY	Priorité d'envoi	NORMAL, HIGH	Facultatif

Fichier (FILE)

Indique le nom et la bibliothèque du fichier envoyé. Ce fichier peut être soit un fichier physique, soit un fichier sauvegarde. Les fichiers logiques et les fichiers unité ne sont pas acceptés. Les substitutions au fichier indiqué ne sont pas prises en compte.

Ce paramètre est obligatoire.

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.

ID utilisateur (TOUSRID)

Indique l'ID du ou des utilisateurs auxquels est envoyé le fichier, ou le nom de la ou des listes de diffusion contenant ces ID. Dans cette commande il est possible d'indiquer à la fois des ID utilisateur et des noms de listes de diffusion. Ces ID et ces noms de listes doivent se présenter en deux parties, toutes deux étant indispensables.

Ce paramètre est obligatoire.

Ce paramètre admet des valeurs multiples.

Membre (MBR)

Indique le membre du fichier qui est envoyé. Vous ne pouvez pas indiquer de nom de membre s'il s'agit d'un fichier sauvegarde.

*FIRST: Le premier membre (par ordre de création) est envoyé.
nom-membre: Indiquez le nom du membre qui est envoyé.

Type de fichier de destination (TOTYPE)

Indique, lorsque vous envoyez un fichier source, si les zones Numéro de séquence et Date sont à supprimer de la copie du fichier transmise. Le fichier source n'est pas modifié. Ce paramètre n'est admis que pour les fichiers source.

Les valeurs possibles sont les suivantes :

*FROMFILE: Le type du fichier source est utilisé lors de l'envoi du fichier. Le fichier transmis ne change pas.
*DATA: Le fichier est envoyé comme un fichier non source. La copie transmise est envoyée sans les zones Numéro de séquence et Date.

Classe VM/MVS (CLASS)

Indique la classe SYSOUT de VM/MVS pour les distributions envoyées à un système hôte VM ou MVS.

Les valeurs possibles sont les suivantes :

A: La classe est A.
B-Z, 0-9: Indiquez la classe de distribution. Les valeurs possibles vont de B à Z et de 0 à 9.

Format d'envoi (FORMAT)

Indique le format d'enregistrement utilisé pour la transmission du fichier réseau.

Les valeurs possibles sont les suivantes :

*V: Le fichier est envoyé sous forme d'enregistrements de longueur variable dont les blancs de fin ont été retirés.
*F: Le fichier est envoyé sous forme d'enregistrements de longueur fixe dont les blancs de fin ont été conservés. Cette valeur ne s'applique qu'aux fichiers réseau envoyés à un IBM 370. Il est déconseillé de l'utiliser pour l'envoi de fichiers vers d'autres systèmes System i5.
*U: Si le fichier contient des zones admettant des valeurs indéfinies, cette valeur, lorsqu'elle est indiquée, permet à la commande SNDNETF d'envoyer le fichier ainsi que des informations de mappage identifiant les zones admettant une valeur indéfinie. Cette valeur pour le paramètre FORMAT ne produit l'effet escompté que lorsque le fichier est envoyé à un autre AS/400 doté de l'OS/400 V4R2M0 ou d'une édition ultérieure.
Remarque :Le fait d'indiquer FORMAT(*F) peut augmenter le temps et la mémoire secondaire nécessaires à la transmission du fichier réseau. Le fait d'indiquer FORMAT(*U) requiert également la présence d'un fichier base de données sur le système de réception, créé avec les mêmes mappages de zones que le fichier en cours d'envoi, afin que celui-ci soit reçu correctement.

Priorité d'envoi (PTY)

Indique la priorité de file d'attente applicable au fichier lorsque celui-ci est transmis via un réseau SNADS.

Les valeurs possibles sont les suivantes :

*NORMAL: Le fichier est transmis avec un niveau de service correspondant à des "données non prioritaires". C'est ce niveau qui est utilisé pour la plupart des transmissions de données. Sur un système System i5, les données non prioritaires sont placées dans la file d'attente de distribution normale indiquée pour la route.
*HIGH: Le fichier est transmis avec un niveau de service correspondant à des "données prioritaires". C'est ce niveau qui est utilisé pour les transmissions de données prioritaires. Sur un système System i5, les données prioritaires sont placées dans la file d'attente de distribution prioritaire indiquée pour la route.

Exemples

Exemple 1 : envoi d'un membre

SNDNETF   TOUSRID((JONES SYSTEM1))  FILE(EMPLOYEE)  MBR(PGMR)

Cette commande permet d'envoyer le membre PGMR du fichier EMPLOYEE vers l'utilisateur identifié dans le réseau sous l'ID utilisateur (JONES SYSTEM1). Le fichier est recherché dans la liste des bibliothèques.

Exemple 2 : envoi d'un fichier non-source

SNDNETF   TOUSRID((JONES SYSTEM2))  FILE(EMPLOYEE)  MBR(PGMR)
          TOTYPE(*DATA)

Cette commande permet d'envoyer le membre PGMR du fichier EMPLOYEE vers l'utilisateur identifié dans le réseau sous l'ID utilisateur (JONES SYSTEM2). Le fichier est recherché dans la liste des bibliothèques. Le fichier est envoyé en tant que fichier non-source et supprime les numéros de séquence et les champs de date.

Messages d'erreur

Messages *ESCAPE

CPF8057: &1 de &2 n'est ni un fichier physique ni un fichier sauvegarde.
CPF8058: &1 est un fichier spoule.
CPF8059: Nom de membre non admis pour les fichiers sauvegarde.
CPF8063: La ressource nécessaire ne peut pas être allouée.
CPF8064: Membre &3 du fichier &1 de &2 non envoyé.
CPF8066: Commande comportant un ou plusieurs ID utilisateur incorrects.
CPF8068: Erreur détectée lors du traitement du fichier à envoyer.
CPF8072: L'objet à envoyer dépasse la taille maximale de 2 Go.
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.
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.