ADDNETJOBE

La commande ADDNETJOBE (Ajouter un poste travaux du réseau) permet d'ajouter un nouveau poste à la table travaux du réseau sur le système. Ce poste permet de définir le type de traitement qui sera appliqué à un flot de travaux en entrée envoyé par la commande SBMNETJOB (Soumettre un travail au réseau), à un utilisateur du système.

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). Sa valeur doit être *SEARCH pour qu'une recherche d'action soit effectuée dans la table travaux du 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 en entrée sont sauvegardés dans la file d'attente de fichiers réseau de l'utilisateur, sans tenir compte des postes de travaux réseau. L'attribut réseau peut être modifié à l'aide de la commande CHGNETA (Modifier les attributs 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é.

Le manuel SNA Distribution Services, SC41-5410, contient des informations complémentaires sur la table de travaux réseau.

Restrictions :

1. Cette commande est fournie avec le droit public *EXCLUDE.
2. L'utilisateur doit disposer du droit *ALLOBJ (Tous les objets).
3. La valeur interne d'un identificateur de noeud peut être différente des caractères indiqués par la commande ADDNETJOBE 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 une valeur d'identificateur de noeud interne, ou ne correspond pas à la valeur interne d'un noeud défini (pas de distinction majuscules/minuscules), une erreur peut être signalée.

Paramètres

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 DSPNETJOBE. 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é au flot de travaux en entrée contrôlé par ce poste, si l'attribut du réseau JOBACN est *SEARCH.

Ce paramètre est obligatoire.

*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 sera appliquée si ACTION(*SUBMIT) est spécifié avec cette commande ou avec la commande CHGNETJOBE (Modifier poste travaux réseau).

QUSER

Le profil utilisateur QUSER fourni par IBM est utilisé pour soumettre les travaux.

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).

*USRPRF

La file d'attente de messages utilisée est celle du profil utilisateur à qui est envoyé le travail. Cet utilisateur est spécifié sur le paramètre TOUSRID de la commande SBMNETJOB ; il peut ou non s'agir du même utilisateur que celui indiqué au paramètre SBMUSER de cette commande.

*NONE

Aucun utilisateur ne reçoit de message ; toutefois, un message est envoyé dans l'historique du système (QHST).

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 la file d'attente dans laquelle sont placés les postes de travaux. Un poste de travaux est placé sur cette file d'attente pour chaque travail du flot de travaux en entrée dans lequel JOBQ(*RDR) est spécifié avec la commande BCHJOB (Début de travail par lots). 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.

Les valeurs possibles sont les suivantes :

QBATCH

Le poste utilise la file d'attente de travaux QBATCH.

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

Exemple 1 : transmission automatique de flots en entrée

ADDNETJOBE   FROMUSRID(JOHN SMITH)  ACTION(*SUBMIT)
             SBMUSER(ANDERSON)  JOBQ(QGPL/QPGMRL)

Cette commande permet d'ajouter un poste travaux réseau dont la fonction est de déterminer l'action effectuée pour tout flot en entrée reçu d'un utilisateur portant l'ID JOHN SMITH. Les flots en entrée sont transmis automatiquement. Le profil utilisateur ANDERSON est utilisé pour vérifier les droits d'accès aux files d'attente et aux descriptions de travaux spécifiées dans le flot en entrée. Les messages sont envoyés dans la file d'attente de messages définie dans le profil de l'utilisateur destinataire du flot en entrée. Si aucune file d'attente de travaux n'est définie dans la commande // BCHJOB reçue ou dans la description de travail référencée, les travaux sont placés dans la file d'attente de travail QPGMRL, dans la bibliothèque QGPL.

Exemple 2 : envoi de messages vers une file d'attente de messages spécifique

ADDNETJOBE   FROMUSRID(*ANY JONES)  ACTION(*FILE)
             MSGQ(BROWN) SBMUSER(ANDERSON)

Cette commande permet d'ajouter un poste travaux réseau dont la fonction est de déterminer l'action effectuée pour tout flot en entrée reçu d'un utilisateur dont la seconde partie de l'ID utilisateur est JONES et pour lequel il n'existe aucun poste travaux réseau spécifique. Le flot de travaux en entrée est placé dans la file d'attente des fichiers reçus de l'utilisateur destinataire, et un message est envoyé dans la file d'attente de messages BROWN.

Messages d'erreur

Messages *ESCAPE

CPF8050

Impossible d'accéder à la table des travaux du réseau.

CPF8051

*ANY incorrect en seconde partie d'ID utilisateur.

CPF8052

Poste travaux du réseau &1 &2 non ajouté.

CPF9040

Caractères incorrects dans ID utilisateur/adresse, ou dans ID liste &1 &2.