Aller au contenu

WRKNETF

Gérer les fichiers du réseau

En bref

La commande WRKNETF (Gérer les fichiers du réseau) permet d'afficher ou d'imprimer la liste des fichiers reçus par un utilisateur.

WRKNETF se lit WRK (Gérer) + NETF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKNETF

Paramètres

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

La commande WRKNETF (Gérer les fichiers du réseau) permet d'afficher ou d'imprimer la liste des fichiers reçus par un utilisateur. Elle permet également de créer un fichier de sortie contenant la liste des fichiers. Lorsque celle-ci est affichée, vous pouvez :

  • recevoir le fichier dans un fichier utilisateur,
  • supprimer le fichier,
  • consulter le fichier (ne s'applique pas aux fichiers sauvegarde),
  • soumettre les fichiers ou le flot de travaux en entrée (ne s'applique pas aux fichiers sauvegarde).

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 afficher les fichiers réseau de tout autre utilisateur. Les utilisateurs ne disposant pas de ce droit peuvent afficher uniquement les fichiers qui leur ont été envoyés ou ont été envoyés à leur profil de groupe.
  2. Pour utiliser l'une des options de cet écran, vous devez disposer de droits sur la commande correspondant à cette option. Vous devez, par exemple, disposer de droits sur la commande DSPPFM (Afficher membre fichier physique) pour accéder à la fonction de lecture ou de droits sur la commande SBMDBJOB (Soumettre des travaux BD) pour utiliser la fonction de soumission de travaux.
  3. Pour exécuter WRKNETF en mode débogage, la mise à jour des fichiers de production doit être admise en spécifiant UPDPROD(*YES) dans la commande STRDBG.

Paramètres

Mot-clé Description Valeurs possibles Remarques
USER Utilisat Nom, *CURRENT, *ALL Facultatif, positionnel 1
OUTPUT Sortie *, *PRINT, *OUTFILE Facultatif, positionnel 2
OUTFILE Fichier recevant la sortie Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

Utilisat (USER)

Indique l'utilisateur dont les fichiers sont à afficher.

*CURRENT
Les fichiers à afficher sont ceux de l'utilisateur en cours.
*ALL
Les fichiers à afficher sont ceux de tous les utilisateurs.
nom-utilisateur
Indiquez le nom de l'utilisateur dont les fichiers sont à afficher.

Sortie (OUTPUT)

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 sont les suivantes :

*
Le résultat est affiché (si demandé par un travail interactif) ou placé dans un fichier spoule de la file d'attente en sortie (si demandé par un travail en traitement par lots).
*PRINT
Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.
*OUTFILE
La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Fichier recevant la sortie (OUTFILE)

Indique le nom et la bibliothèque du fichier base de données destiné à recevoir le résultat. Si le fichier n'existe pas, cette commande crée un fichier base de données dans la bibliothèque indiquée.

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.

Membre recevant la sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Les valeurs possibles sont les suivantes :

*FIRST
Le premier membre du fichier reçoit les données en sortie. A défaut de membre existant, le système crée un membre du nom du fichier indiqué en regard de l'invite Fichier recevant la sortie (paramètre OUTFILE).
nom-membre
Indiquez le nom du membre du fichier destiné à recevoir le résultat. Si aucun membre de ce nom n'existe, le système le crée.

Les valeurs permettant de définir le stockage des informations 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.

Exemples

Exemple 1 : travail avec les fichiers réseau de l'utilisateur

WRKNETF

Cette commande permet de gérer tous les fichiers réseau de l'utilisateur exécutant cette commande. Si la commande est lancée en tant que travail interactif, la liste de fichiers s'affiche sur le poste de travail demandeur. Si la commande est lancée en tant que travail par lots, la liste de fichiers est imprimée avec la sortie spoule du travail.

Exemple 2 : impression d'une sortie

WRKNETF   USER(USR1)  OUTPUT(*PRINT)

Cette commande permet gérer les fichiers réseau de USR1 et d'imprimer la sortie avec la sortie spoule du travail. Cette commande peut uniquement être exécutée par USR1, par un membre du groupe USR1 ou par un utilisateur ayant les droits d'accès du responsable de la sécurité.

Exemple 3 : travail avec les fichiers réseau de tous les utilisateurs

WRKNETF   USER(*ALL)  OUTPUT(*OUTFILE)  OUTFILE(NETFILES)

Cette commande permet de gérer les fichiers réseau de tous les utilisateurs et s'imprime dans le premier membre d'une base de données appelée NETFILES. Si le fichier existe dans une bibliothèque figurant dans la liste des bibliothèques, ce dernier est utilisé ; dans tous les autres cas, le fichier est créé dans la bibliothèque QGPL. Si le fichier n'existe pas ou ne contient pas de membre, un membre portant le même nom que le fichier est ajouté au fichier ; dans tous les autres cas, le premier membre du fichier est supprimé et utilisé. Cette commande peut uniquement être exécutée par un utilisateur disposant des droits d'accès du responsable de la sécurité.

Messages d'erreur

Messages *ESCAPE

CPF2204
Profil utilisateur &1 non trouvé.
CPF8070
Non autorisé à traiter des fichiers pour l'utilisateur &1.
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.
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.
CPF9860
Erreur lors du traitement du fichier de sortie.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.