CHGNETJOBE
Modifier poste travaux réseau
En bref
La commande CHGNETJOBE (Modifier un poste travaux du réseau) permet de modifier les attributs d'un poste travaux du réseau existant sur le système.
CHGNETJOBE se lit CHG
(Modifier) + NETJOBE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGNETJOBE FROMUSRID(…)
Paramètres
-
FROMUSRIDID utilisateur obligatoire -
ACTIONAction pour travaux du réseau -
SBMUSERProfil utilisateur -
MSGQFile attente messages -
JOBQFile d'attente de travaux
Astuce : dans une session 5250, tapez CHGNETJOBE 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 CHGNETJOBE (Modifier un poste travaux du réseau) permet de modifier les attributs d'un poste travaux du réseau existant sur le système. Un poste permet de définir l'opération à effectuer lors de l'envoi d'un flot de travaux en entrée à un utilisateur à l'aide de la commande SBMNETJOB (Soumettre un travail au réseau).
Selon la valeur indiquée, le flot de travaux en entrée sera automatiquement soumis, placé dans la file d'attente des fichiers du réseau d'un utilisateur ou rejeté. Le poste permet également d'indiquer le profil utilisateur utilisé pour vérifier les droits sur la description de travail indiquée dans le flot en entrée. Chaque utilisateur ou groupe de distribution soumettant des travaux au système doit disposer d'un poste. La soumission de travaux est contrôlée au moyen de l'attribut réseau JOBACN (Action pour travaux du réseau), qui permet un contrôle général des soumissions de travaux sur le réseau ; sa valeur doit être *SEARCH pour qu'une recherche d'action s'effectue dans la table de travaux réseau. Si l'attribut de réseau est *REJECT, tous les travaux en entrée sont rejetés. Si cet attribut est *FILE, tous les travaux réseau en entrée sont sauvegardés dans la file d'attente de fichiers réseau de l'utilisateur, sans qu'il soit tenu compte du poste travaux réseau.
Chaque poste travaux réseau est identifié par l'ID en deux parties de l'émetteur. Lorsqu'un flot de travaux en entrée arrive, l'ID utilisateur de l'émetteur est utilisé pour rechercher un poste travaux réseau. Si aucun poste n'est trouvé, la deuxième partie de l'ID est utilisée pour la recherche, *ANY étant utilisé pour la première partie. En cas d'échec, une nouvelle recherche est effectuée avec *ANY pour les deux parties de l'ID utilisateur. Si aucun poste n'est trouvé, le travail est rejeté.
Restrictions :
- Cette commande est fournie avec le droit public *EXCLUDE.
- La valeur interne d'un identificateur de noeud peut être différente des caractères indiqués par la commande CHGNETJOBE selon le type de poste de travail (langue) utilisé. Si la valeur de chaîne de caractères binaires spécifiée pour le paramètre de la commande FROMUSRID ne répond pas aux règles définies pour la valeur d'un identificateur de noeud interne ou si elle ne correspond pas à la valeur interne d'un noeud défini (pas de distinction majuscules/minuscules), une erreur peut se produire.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| FROMUSRID | ID utilisateur | Liste d'éléments | Obligatoire, clé, positionnel 1 |
| Élément 1: ID utilisateur | Valeur caractère | ||
| Élément 2: Qualificatif ID utilisateur | Valeur caractère | ||
| ACTION | Action pour travaux du réseau | *SAME, *FILE, *REJECT, *SUBMIT | Facultatif, positionnel 2 |
| SBMUSER | Profil utilisateur | Nom, *SAME | Facultatif, positionnel 3 |
| MSGQ | File attente messages | Valeurs uniques: *SAME, *USRPRF, *NONE Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File attente messages | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| JOBQ | File d'attente de travaux | Valeurs uniques: *SAME Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File d'attente de travaux | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB |
ID utilisateur (FROMUSRID)
Indique l'ID en deux parties de l'utilisateur qui soumet un flot de travaux en entrée à ce système. Tous les flots de travaux en entrée reçus de l'utilisateur sont traités comme indiqué dans ce poste travaux réseau. Les deux parties de l'ID utilisateur sont requises. La valeur spéciale *ANY peut être indiquée pour la première partie ou les deux parties de l'ID utilisateur.
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 WRKNETJOBE (Gérer postes travaux du réseau). Si la valeur de chaîne de caractères binaires spécifiée pour le paramètre FROMUSRID 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.
Action pour travaux du réseau (ACTION)
Indique le traitement appliqué aux travaux contrôlés par ce poste.
- *SAME
- L'option indiquée précédemment reste inchangée.
- *REJECT
- Le flot de travaux en entrée est rejeté.
- *FILE
- Le flot de travaux en entrée est placé dans la file d'attente des fichiers du réseau de l'utilisateur destinataire.
- *SUBMIT
- Le flot de travaux en entrée est soumis à une file d'attente de travaux par lots. Le profil utilisateur indiqué dans le poste de travaux du réseau est utilisé pour vérifier les droits requis sur les files d'attente de travaux.
Profil utilisateur (SBMUSER)
Indique le profil utilisateur utilisé pour soumettre les travaux. Ce profil permet de vérifier les droits sur les files d'attente et les descriptions de travail indiquées dans le flot de travaux en entrée. La valeur spécifiée pour ce paramètre est prise en compte si ACTION(*SUBMIT) est spécifié avec cette commande ou avec la commande ADDNETJOBE (Ajouter poste travaux réseau)
- *SAME
- Le profil de l'utilisateur qui soumet les travaux sur le poste ne change pas.
- profil-utilisateur
- Indiquez le nom du profil utilisateur utilisé pour soumettre les travaux.
File attente messages (MSGQ)
Indique le nom et la bibliothèque de la file d'attente recevant les messages d'arrivée d'un flot de travaux en entrée. Un message est également envoyé dans l'historique du système (QHST).
- *SAME
- La file d'attente des messages du poste ne change pas.
- *USRPRF
- La file d'attente de messages utilisée est celle du profil utilisateur à qui est envoyé le travail.
- *NONE
- Aucun utilisateur ne reçoit de message ; toutefois, un message est envoyé dans l'historique du système.
- nom-file-attente-messages
- Indiquez le nom de la file d'attente destinée à recevoir les messages.
Pour la bibliothèque, les valeurs possibles sont les suivantes :
- *LIBL
- La file d'attente de messages est recherchée dans la liste des bibliothèques.
- *CURLIB
- La file d'attente de messages est recherchée 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 la file d'attente de messages.
File d'attente de travaux (JOBQ)
Indique le nom et la bibliothèque de la file d'attente de travaux où seront placés les travaux. Les travaux sont placés dans cette file d'attente si *RDR a été indiqué en regard de l'invite File d'attente de travaux (paramètre JOBQ) de la commande BCHJOB. Si *RDR n'est pas spécifié avec la commande BCHJOB, la file d'attente spécifiée avec la commande BCHJOB ou dans la description de travail est utilisée (la file d'attente de travaux peut être différente pour chaque travail du flot en entrée). Ce paramètre n'est admis que si ACTION(*SUBMIT) est spécifié avec cette commande, dans le poste travaux réseau existant ou dans une commande CHGNETJOBE (Modifier un poste travaux du réseau) lancée ultérieurement.
- *SAME
- La file d'attente de travaux du poste ne change pas.
- nom-file-attente-travaux
- Indiquez le nom de la file d'attente de travaux utilisée.
Pour la bibliothèque, les valeurs possibles sont les suivantes :
- *LIBL
- La file d'attente de travaux est recherchée dans la liste des bibliothèques.
- *CURLIB
- La file d'attente de travaux est recherchée 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 la bibliothèque contenant la file d'attente de travaux.
Exemples
CHGNETJOBE FROMUSRID(JOHN SMITH) SBMUSER(ANDERSON)
Cette commande permet de modifier le poste travaux réseau dont la fonction est de déterminer l'action effectuée pour tout flot en entrée reçu de l'utilisateur JOHN SMITH. L'option et la file d'attente de messages du poste existant ne sont pas modifiées. Le profil utilisateur utilisé pour vérifier les droits sur les files d'attente et les descriptions de travail indiquées dans le flot de travaux en entrée est modifié et reçoit la valeur ANDERSON.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.