SBMNETJOB

Soumettre un travail au réseau

En bref

SBMNETJOB se lit SBM (Soumettre) + NETJOB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SBMNETJOB FILE(…) TOUSRID(…)

Paramètres

FILE Fichier obligatoire
TOUSRID ID utilisateur obligatoire
MBR Membre
PTY Priorité d'envoi

Astuce : dans une session 5250, tapez SBMNETJOB 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 SBMNETJOB (Soumettre un travail au réseau) permet d'envoyer un flot de travaux en entrée à un autre utilisateur via le réseau SNADS (cet utilisateur peut alors classer, soumettre ou rejeter les travaux). L'attribut de réseau JOBACT (Action pour travaux du réseau) permet de gérer la destination du flot de travaux en entrée reçu. Si la valeur de l'attribut JOBACN est *SEARCH, le poste figurant dans la table des travaux du réseau du système destinataire est utilisé pour déterminer l'opération à effectuer. Une fois dans le système, le travail peut être immédiatement soumis, classé par le destinataire ou encore rejeté.

Lorsque le flot de travaux en entrée arrive à destination, un message est envoyé au destinataire et à l'expéditeur de ce flot. L'usage de cette commande est réservé à l'envoi d'un flot de travaux en entrée par lots à un utilisateur d'un système éloigné.

Restrictions :

Pour utiliser cette commande, l'utilisateur doit disposer des droits d'opération et de lecture sur le fichier soumis et sur la bibliothèque dans laquelle il se trouve.
L'utilisateur doit être inscrit dans le répertoire de distribution du système pour utiliser cette commande. (Le manuel SNA Distribution Services, SC41-5410, contient des informations sur la procédure d'inscription.)
Si l'attribut réseau JOBACN du système récepteur est sur *SEARCH, il doit exister un poste pour l'utilisateur dans la table de travaux réseau du système récepteur. Le poste de cette table spécifie un profil utilisateur sur le système récepteur qui est utilisé pour vérifier que l'utilisateur est autorisé à soumettre le travail sur ce système. Le profil utilisateur du système récepteur doit être autorisé à utiliser les files d'attente de travaux, et doit disposer du droit d'opération sur l'objet pour la description de travail spécifiée par les commandes JOB du flot d'entrée.
Le fichier soumis ne peut pas contenir plus de 2 milliards d'octets de données (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
PTY	Priorité d'envoi	NORMAL, HIGH	Facultatif

Fichier (FILE)

Indique le nom et la bibliothèque du fichier physique contenant le flot de travaux en entrée envoyé.

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 soumis le flot d'entrée, ou bien le nom de la ou des listes de diffusion contenant les ID du ou des utilisateurs à qui le fichier doit être envoyé. Chaque commande peut mentionner à 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.

REMARQUES :

Selon le poste de travail utilisé, la valeur interne d'un ID utilisateur peut être différente des caractères indiqués par la commande DSPDIRE (Afficher postes du répertoire). Si la valeur de chaîne de caractères binaire spécifiée pour le paramètre TOUSRID ne répond pas aux règles définies pour une valeur d'ID utilisateur interne, ou ne correspond pas à la valeur interne d'un utilisateur inscrit, une erreur peut se produire.
L'utilisateur spécifié dans ce paramètre, ou dans la liste de distribution, doit être un utilisateur éloigné. La commande SBMNETJOB ne peut pas être utilisée pour envoyer des flots en entrée à des utilisateurs locaux.

Ce paramètre admet des valeurs multiples.

Membre (MBR)

Indique le membre du fichier qui est envoyé.

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

Priorité d'envoi (PTY)

Indique la priorité de file d'attente applicable au flot de données en entrée lorsque celui-ci est transmis via un réseau SNADS.

Les valeurs possibles sont les suivantes :

*NORMAL: Le flot de données en entrée 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 flot de données en entrée est transmis avec un niveau de service correspondant à des "données prioritaires". Ce niveau est utilisé pour les transmissions de données à priorité élevée. 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

SBMNETJOB   FILE(PAYROLL)  TOUSRID(PAYROLL SYSTEM1)
            MBR(WEEKLY)

Cette commande permet d'envoyer les flots de travaux entrée contenus dans le membre WEEKLY du fichier PAYROLL vers l'ID utilisateur PAYROLL SYSTEM1.

Messages d'erreur

Messages *ESCAPE

CPF8056: &1 de &2 n'est pas un fichier physique.
CPF8058: &1 est un fichier spoule.
CPF8063: La ressource nécessaire ne peut pas être allouée.
CPF8065: Flot de travaux en entrée &1 de &2 membre &3 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.