SNDNETSPLF

La commande SNDNETSPLF (Envoyer un fichier spoule au réseau) permet d'envoyer un fichier spoule à un autre utilisateur d'un système local ou éloigné via le réseau SNADS. Le fichier est placé dans la file d'attente en sortie indiquée dans le profil de l'utilisateur destinataire.

Lorsqu'un fichier arrive à destination, un message est envoyé au destinataire et à l'expéditeur pour leur signaler l'arrivée du fichier spoule.

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 :

1. L'utilisateur doit être inscrit dans le répertoire de distribution du système pour exécuter cette commande. L'émetteur doit disposer des droits de lecture, d'ajout et de suppression sur la file d'attente en sortie réceptrice lorsqu'il effectue un envoi vers un utilisateur sur le même système.
2. L'une des conditions suivantes doit être vérifiée :
   • Le demandeur est le créateur du fichier.
   • Le demandeur dispose du droit *READ sur la file d'attente en sortie dans laquelle se trouve le fichier et DPSDTA(*YES) a été spécifié par la commande CRTOUTQ.
   • Le demandeur dispose du droit spécial *SPLCTL.
   • Le demandeur dispose du droit spécial *JOBCTL et OPRCTL(*YES) a été spécifié par la commande CRTOUTQ pour la file d'attente en sortie dans laquelle réside le fichier.
   • DSPDTA(*YES) a été spécifié par la commande CRTOUTQ pour la file d'attente en sortie.
   • Le demandeur dispose du droit de propriété sur la file d'attente en sortie dans laquelle réside le fichier et AUTCHK(*OWNER), DSPDTA(*YES) ou DSPDTA(*NO) a été spécifié par la commande CRTOUTQ pour la file d'attente.
   • Le demandeur dispose des droits *READ, *ADD et *DELETE sur la file d'attente en sortie dans laquelle réside le fichier et AUTCHK(*DTAAUT) et DSPDTA(*YES) ou DSPDTA(*NO) ont été spécifiés par la commande CRTOUTQ pour la file d'attente.
3. DTAFMT(*RCDDATA) doit être utilisé lors de l'envoi d'un fichier spoule à un système antérieur à la version 1, édition 3, modification 0 (V1R3).

Paramètres

Fichier spoule (FILE)

Indique le nom du fichier spoule qui est envoyé à l'utilisateur indiqué. Ce nom est celui du fichier unité utilisé par le programme pour générer le fichier spoule en sortie.

Ce paramètre est obligatoire.

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. Chaque ID utilisateur ou liste de distribution est spécifié sous la forme d'un nom comprenant deux parties et ces deux parties sont requises. L'utilisateur présent dans la liste de distribution peut être éloigné ou local.

Remarque :Selon le type de poste de travail utilisé, la valeur interne d'un ID utilisateur peut être différente des caractères affichés à l'aide de la commande DSPDIRE. Si la valeur de chaîne de caractères binaires spécifiée pour le paramètre TOUSRID ne répond pas aux règles définies pour un ID utilisateur interne ou ne correspond pas à la valeur interne d'un utilisateur inscrit, une erreur peut être signalée.

Ce paramètre est obligatoire.

Ce paramètre admet des valeurs multiples.

Travail (JOB)

Indique le nom du travail qui a créé le fichier spoule dont les enregistrements doivent être envoyés.

*

Le fichier spoule a été créé par le travail ayant émis la commande.

nom-travail-qualifié

Indiquez le nom qualifié du travail qui a créé le fichier spoule. Si aucun qualifiant n'est défini, le nom simple est alors recherché dans tous les travaux en cours sur le système.

Numéro de fichier spoule (SPLNBR)

Indique le numéro du fichier spoule créé par le travail dont les enregistrements doivent être envoyés.

*ONLY

Un seul fichier spoule du travail porte le nom indiqué ; il n'est donc pas nécessaire de préciser son numéro.

*LAST

Le fichier spoule avec le nom indiqué et dont le numéro est le plus élevé est utilisé.

*ANY

Le numéro du fichier spoule n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre du nom du système de travail ou à celui de la date et heure de création du fichier spoule par rapport au le numéro de ce dernier lors de la sélection d'un fichier spoule.

numéro-fichier-spoule

Indiquez le numéro du fichier spoule qui porte le nom du fichier dont les enregistrements doivent être envoyés.

Nom de système de travail (JOBSYSNAME)

Indique le nom du système dans lequel s'exécute le travail qui a créé le fichier spoule (paramètre JOB). Ce paramètre est pris en considération une fois les conditions de travail, de nom d'utilisateur, de numéro de travail, de nom de fichier spoule et de numéro de fichier spoule remplies.

*ONLY

Il y a un fichier spoule correspondant aux noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, date et heure de création de fichier spoule précisés.

*CURRENT

Le fichier spoule, créé sur le système en cours, avec ce nom de travail, d'utilisateur, ce numéro de travail, ce nom et numéro de fichier spoule, ces date et heure de création de fichier spoule, est utilisé.

*ANY

Le nom du système de travail n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre de date et heure de création du fichier spoule par rapport au nom du système de travail lors de la sélection d'un fichier spoule.

nom

Indiquez le nom du système où s'exécute le travail ayant créé le fichier spoule.

Fichier spoule créé (CRTDATE)

Indique la date et l'heure de création du fichier spoule. Ce paramètre est pris en considération une fois les conditions relatives au nom de travail, au nom d'utilisateur, au numéro de travail, au nom du fichier spoule, au numéro de fichier spoule et au nom de système du travail remplies.

Valeurs uniques

*ONLY

Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés.

*LAST

Le fichier spoule, correspondant à la dernière date et heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés, est utilisé.

Elément 1 : Date de création

date

Indiquez la date de création du fichier spoule.

Elément 2 : Heure de création

*ONLY

Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du fichier de travail et date de création de fichier spoule précisés.

*LAST

Le fichier spoule, correspondant à la dernière heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du système de travail et date de création de fichier spoule précisés, est utilisé.

heure

Indiquez l'heure de création du fichier spoule.

Format des données (DTAFMT)

Format dans lequel les fichiers spoule sont transmis. Ce paramètre s'applique uniquement aux fichiers spoule d'impression. Il n'est pas pris en compte pour les fichiers disquette.

Les fichiers spoule contenant des caractéristiques spéciales d'unité ne peuvent pas être envoyés au moyen de cette commande si *RCDDATA est indiqué en regard de l'invite Format des données (paramètre DTAFMT).

Remarque :Les caractéristiques spéciales d'unité font partie des attributs du fichier spoule. Pour les visualiser, utilisez la commande WRKSPLFA ou l'option d'attributs dans la commande WRKSPLF. Si les attributs du fichier comprennent des caractéristiques spéciales d'unité (si la lettre "O" apparaît à l'écran en regard d'un ou de plusieurs caractéristiques d'unité), le fichier spoule ne peut pas être envoyé. Indiquez DTAFMT(*ALLDATA) ou copiez le fichier spoule dans un fichier base de données à l'aide de la commande CPYSPLF (Copier un fichier spoule), puis envoyez le fichier en tant que fichier de données à l'aide de la commande SNDNETF (Envoyer un fichier au réseau).

Si la valeur *RCDDATA est précisée à l'invite Format des données (paramètre DTAFMT), les attributs suivants du fichier spoule sont conservés :

• Fichier
• Nombre d'exemplaires
• Caractères au pouce
• Tiroir
• Type d'imprimé
• Indicateur de données IGC
• Lignes au pouce
• Hauteur de la page
• Largeur de la page
• Rotation d'impression
• Police de caractères
• Texte à imprimer
• Label de la disquette
• Dates de création et de péremption de la disquette
• Type de code de la disquette
• Type d'échange de la disquette

Les valeurs possibles sont les suivantes :

*RCDDATA

Le fichier spoule est envoyé dans le format antérieur à la version 1.3. Ce format n'admettant pas les fonctions évoluées, certaines fonctions sont retirées des données envoyées dans ce format. Utilisez ce format pour envoyer des fichiers spoule sur un IBM 36, un IBM 38 et un IBM 370.

*ALLDATA

Le fichier spoule est envoyé sous sa forme initiale, sans perte d'attributs. Tous les attributs nécessaires à la reproduction du fichier sur le système récepteur sont également envoyés. Utilisez la valeur *ALLDATA pour envoyer des fichiers spoule sur la version 1, édition 3, niveau de modification 0 de l'AS/400 ou sur des éditions ultérieures.

REMARQUES :

1. Si un fichier est destiné à être imprimé sur le système récepteur, il doit l'être sur le même type d'imprimante que celle sur laquelle il devait être imprimé sur le système source.
2. Les fichiers spoule nécessitant des ressources AFP peuvent s'imprimer différemment sur le système récepteur. Pour que les fichiers spoule soient imprimés de la même façon, les conditions suivantes doivent être remplies :
   • Avant d'utiliser cette commande pour envoyer un fichier à un utilisateur sur le même système, vérifiez que les bibliothèques contenant des ressources AFP non fournies par IBM se trouvent dans la liste des bibliothèques.
   • Avant d'utiliser cette commande pour envoyer un fichier à un autre système ou utilisateur, vérifiez que les bibliothèques contenant des ressources AFP non fournies par IBM se trouvent dans la liste de bibliothèques initiale de l'utilisateur recevant les fichiers spoule.
3. Utilisez ce format pour envoyer des fichiers unité de type imprimante *LINE, *AFPDS et *AFPDSLINE au système 370.

Classe VM/MVS (CLASS)

Indique la classe SYSOUT VM/MVS des distributions envoyées sur 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.

Priorité d'envoi (PTY)

Indique la priorité de file d'attente applicable à ce fichier spoule lorsque celui-ci est transmis via un réseau SNADS (Services de distribution SNA).

Les valeurs possibles sont les suivantes :

*NORMAL

Le fichier spoule est transmis avec un niveau de service non prioritaire. 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 spoule est transmis avec un niveau de service prioritaire. 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 fichier spoule

SNDNETSPLF   FILE(QPRINT)  TOUSRID((JDE SYS1))
             JOB(142857/PAPER/PRINT)
             SPLNBR(*LAST)  DTAFMT(*ALLDATA)

Cette commande permet d'envoyer la dernière copie (l'exemplaire le plus récemment créé) du fichier spoule QPRINT du travail 142857/PAPER/PRINT à l'utilisateur portant l'ID JDE SYS1. Toutes les fonctions de fichier spoule seront envoyées.

Exemple 2 : envoi d'attributs d'impression

SNDNETSPLF   DTAFMT(*RCDDATA)

Cette commande permet d'envoyer un ensemble limité d'attributs d'impression.

Exemple 3 : envoi de tous les attributs d'impression

SNDNETSPLF   DTAFMT(*ALLDATA)

Cette commande permet d'envoyer tous les attributs d'impression. *ALLDATA est admis uniquement lorsqu'il est envoyé à partir d'un System i5 vers un System i5 de même type.

Messages d'erreur

Messages *ESCAPE

CPF2207

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

CPF3205

Fichier non créé.

CPF3207

Membre non ajouté. Des erreurs se sont produites.

CPF3303

Fichier &1 non trouvé dans travail &5/&4/&3.

CPF3309

Aucun fichier portant le nom &1 n'est actif.

CPF3330

Ressource nécessaire non disponible.

CPF3340

Plusieurs fichiers du nom indiqué dans travail &5/&4/&3.

CPF3342

Travail &5/&4/&3 non trouvé.

CPF3343

Plusieurs travaux portant le même nom.

CPF3344

Le fichier &1 numéro &8 n'est plus dans le système.

CPF3429

Le fichier &1 numéro &7 ne peut pas être affiché, copié ou envoyé.

CPF3482

La demande de copie a échoué : fichier spoule &1 ouvert.

CPF3486

Valeur du paramètre CHLVAL incorrecte.

CPF3492

Non autorisé à utiliser le fichier spoule.

CPF3493

Paramètre CTLCHAR incorrect pour le fichier &1.

CPF3499

Enreg du fichier &1 précédant toutes les valeurs de canaux assignées.

CPF8055

Fichier spoule contenant des caractéristiques spéciales d'unité : non envoyé.

CPF8063

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

CPF8066

Commande comportant un ou plusieurs ID utilisateur incorrects.

CPF8067

Fichier &1 non envoyé.

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.

CPF9820

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

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.

CPF9849

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