SBMJOB

La commande SBMJOB ((Soumettre un travail) permet à un travail en cours de traitement de soumettre un travail en file d'attente, en vue d'une exécution ultérieure. Un seul élément de donnée demande peut être placé dans la nouvelle file d'attente de messages du nouveau travail. La donnée demande peut être une commande CL, si le poste de routage indique un programme de traitement de commande CL (programme QCMD fourni par IBM, par exemple).

Restrictions :

1. L'utilisateur qui exécute la commande SBMJOB doit disposer des droits suivants :
   • Droit *USE sur le profil utilisateur indiqué au paramètre USER (Utilisat).
   • Droit *USE sur la commande spécifiée au paramètre CMD (Commande à exécuter) et droit *EXECUTE sur la bibliothèque contenant cette commande.
   • Droit *USE sur la description de travail indiquée au paramètre JOBD (Description de travail) et droit *EXECUTE sur la bibliothèque contenant cette description de travail.
   • Droit *USE sur la file d'attente de travaux indiquée au paramètre JOBQ (File d'attente de travaux) et droit *EXECUTE sur la bibliothèque contenant cette file d'attente de travaux.
   • Droits *USE et *ADD sur la file d'attente de messages indiquée au paramètre MSGQ (File attente messages) et droit *EXECUTE sur la bibliothèque contenant cette file d'attente de messages.
   • Droit spécial *JOBCTL pour utiliser le paramètre SBMFOR (Soumis pour).
   • Droit *USE sur la commande CHGACGCDE (Modifier le code comptabilité) afin d'indiquer un code comptabilité sous forme de caractères pour le paramètre JOBD (Code comptabilité).
2. Pour le travail soumis, l'utilisateur doit disposer des droits suivants :
   • Droit *USE sur la description de travail indiquée au paramètre JOBD (Description de travail).
   • Droit *READ sur la file d'attente en sortie indiquée au paramètre OUTQ (File d'attente en sortie) et droit *EXECUTE sur la bibliothèque contenant cette file d'attente en sortie, dans l'espace de nom du travail soumis.
   • Droit *USE sur toutes les bibliothèques spécifiées au paramètre SYSLIBL (Liste bibliothèques système).
   • Droit *USE sur la bibliothèque indiquée au paramètre CURLIB (Bibliothèque en cours).
   • Droit *USE sur toutes les bibliothèques spécifiées au paramètre INLLIBL (Liste bibliothèques initiale).
   • Droit *USE sur toutes les descriptions d'unité ASP indiquées au paramètre INLASPGRP (Groupe ASP initial).
   • Droit *USE sur la table de séquence de tri indiquée au paramètre SRTSEQ (Séquence de tri) et droit *EXECUTE sur la bibliothèque contenant la table de séquence de tri, dans l'espace de nom du travail soumis.
3. Cette commande est à unités d'exécution protégées sous certaines conditions. Si un point d'exit de notification de travail a été inscrit pour l'envoi d'un message dans une file d'attente de données DDM lors de la soumission d'un travail, le message ne sera pas envoyé si la commande SBMJOB (Soumettre un travail) est lancée dans un travail à unités d'exécution multiples. En revanche, le message sera envoyé si le point d'exit a été inscrit pour l'envoi du message dans une file d'attente de données locale. Pour plus d'informations sur la fonction de notification de travaux, reportez-vous au chapitre Work Management du manuel System API Reference.
4. Les variables d'environnement ne sont pas copiées à partir du travail de soumission si le système est mis hors tension avant le début du travail soumis.

Paramètres

Commande à exécuter (CMD)

Indique une commande à exécuter dans le travail par lots, si le programme de routage utilisé à l'initialisation du travail par lots est le programme de routage par défaut fourni par IBM (QCMD). Cette commande étant utilisée pour la donnée demande, ce paramètre est incompatible avec le paramètre Donnée demande ou commande (RQSDTA).

chaîne-commande

Indiquez la commande à exécuter dans le travail par lots (20000 caractères au maximum).

Travail (JOB)

Indique le nom associé au travail traité.

*JOBD

Le nom du travail est celui de la description de travail.

nom

Indiquez le nom de travail à utiliser lors du traitement.

Description de travail (JOBD)

Indique la description du travail utilisée avec le travail.

Valeurs uniques

*USRPRF

Pour le travail soumis, le système utilise la description de travail définie dans le profil utilisateur sous lequel le travail s'exécute.

Qualificatif 1 : Description de travail

nom

Entrez le nom de la description de travail à utiliser.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La description de travail est recherchée dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez la bibliothèque contenant la description de travail.

File d'attente de travaux (JOBQ)

Indique le nom de la file d'attente de travaux dans laquelle le travail est placé.

Valeurs uniques

*JOBD

Le travail soumis est placé dans la file d'attente définie dans la description de travail.

Qualificatif 1 : File d'attente de travaux

nom

Indiquez le nom de la file d'attente de travaux.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La file d'attente de travaux est recherchée dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez la bibliothèque contenant la file d'attente de travaux.

Priorité du travail (en JOBQ) (JOBPTY)

Indique la priorité de soumission dans la file d'attente. La priorité la plus élevée est 1 et la moins élevée 9.

*JOBD

La priorité de soumission du travail est définie dans la description de travail.

1-9

Indiquez le niveau de priorité du travail.

Priorité de sortie (en OUTQ) (OUTPTY)

Indique la priorité de sortie pour les fichiers spoule en sortie produits par ce travail. Le niveau de priorité le plus élevé est 1, et le niveau le plus bas est 9.

*JOBD

La priorité de sortie du travail est définie dans la description de travail.

1-9

Indiquez le niveau de priorité des fichiers de sortie du travail soumis.

Unité imprimante (PRTDEV)

Indique le nom qualifié de l'unité imprimante par défaut pour ce travail. Si le fichier imprimante spécifie une sortie spoule, celle-ci est placée dans la file d'attente en sortie de l'unité, qui porte le même nom que cette dernière.

Remarque :Cela suppose que les valeurs par défaut pour le fichier imprimante, la description de travail, le profil utilisateur et le poste de travail ont été indiquées au paramètre OUTQ (File d'attente en sortie).

*CURRENT

Le travail soumis utilise la même imprimante que le travail en cours.

*USRPRF

Le travail utilise l'imprimante définie dans le profil utilisateur avec lequel il s'exécute initialement. Le nom de l'imprimante est déterminé lors de l'exécution de la commande.

*SYSVAL

Le travail utilise l'imprimante indiquée dans la valeur système QPRTDEV, lors de l'exécution de la commande.

*JOBD

Le travail soumis utilise l'imprimante définie dans la description de travail.

nom

Indiquez le nom de l'imprimante à utiliser pour le travail soumis.

File d'attente en sortie (OUTQ)

Indique le nom qualifié de la file d'attente en sortie utilisée pour les fichiers spoule précisant OUTQ(*JOB). Ce paramètre ne s'applique qu'aux fichiers imprimante pour lesquels la valeur *JOB a été indiquée au paramètre OUTQ.

Valeurs uniques

*CURRENT

Le travail soumis utilise la même file d'attente en sortie que le travail en cours.

*USRPRF

Le travail soumis utilise la file d'attente en sortie définie dans le profil utilisateur du travail. Le système extrait le nom de la file d'attente à l'exécution de la commande.

*DEV

La file d'attente associée à l'imprimante indiquée dans le paramètre DEV (Unité) du fichier imprimante est utilisée. Cette file a le même nom que l'imprimante. Le paramètre DEV du fichier imprimante est déterminé par les commandes CRTPRTF (Créer un fichier imprimante), CHGPRTF (Modifier un fichier imprimante) ou OVRPRTF (Substituer fichier imprimante.

Remarque :Cela suppose que les valeurs par défaut pour le fichier imprimante, la description de travail, le profil utilisateur et le poste de travail ont été indiquées au paramètre OUTQ.

*JOBD

La file d'attente en sortie définie dans la description du travail soumis est la file d'attente en sortie par défaut.

Qualificatif 1 : File d'attente en sortie

nom

Indiquez le nom de la file d'attente en sortie utilisée par défaut par le travail soumis.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La file d'attente en sortie est recherchée dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez la bibliothèque contenant la file d'attente en sortie.

Utilisat (USER)

Indique quel profil utilisateur est utilisé pour le travail soumis. Si *RQD est défini dans la description de travail, *JOBD ne peut pas être indiqué. Vous devez entrer un nom utilisateur ou *CURRENT.

Remarque : Les objets suivants fournis par IBM ne sont pas admis pour ce paramètre :

• QDBSHR
• QDFTOWN
• QDOC
• QLPAUTO
• QLPINSTALL
• QRJE
• QSECOFR
• QSPL
• QSYS
• QTSTRQS

*CURRENT

Le travail soumis utilise le profil utilisateur du travail en cours.

*JOBD

Le travail soumis utilise le profil utilisateur défini dans la description de travail.

nom

Indiquez le nom du profil utilisateur à utiliser pour le travail soumis.

Code comptabilité (ACGCDE)

Indique le code comptabilité utilisé par le travail envoyé lors de la consignation de l'utilisation des ressources système dans le journal du compte système (QACGJRN).

*CURRENT

Le code comptabilité utilisé par le travail en cours d'exécution est utilisé pour le travail envoyé.

*USRPRF

Le code comptabilité indiqué dans le profil utilisateur avec lequel le travail envoyé est exécuté à l'origine est utilisé.

*JOBD

Le code comptabilité indiqué dans la description du travail associée au travail envoyé est utilisé.

valeur-caractère

Indiquez le code comptabilité à 15 caractères à utiliser pour le travail envoyé. Si vous entrez moins de 15 caractères, la zone est justifiée à gauche et complétée à droite par des espaces.

Texte à imprimer (PRTTXT)

Indique le texte imprimé au bas de chaque page de la sortie imprimée et sur les pages intercalaires.

*CURRENT

Le texte à imprimer est celui du travail qui a soumis ce travail.

*JOBD

C'est la valeur définie dans la description de travail qui est utilisée.

*SYSVAL

La valeur système QPRTTXT est utilisée.

*BLANK

Aucun texte n'est imprimé.

valeur-caractère

Indiquez la chaîne de caractères à imprimer au bas de chaque page (30 caractères au maximum, placés entre apostrophes).

Donnée de routage (RTGDTA)

Indique les données de routage utilisées pour démarrer la phase d'activation suivante du travail. Ces données permettent de déterminer le poste de routage identifiant le programme exécuté par le travail.

QCMDB

La donnée de routage spécifiée par les sous-systèmes fournis par IBM, pour diriger les travaux par lots vers le processeur de langage de contrôle QCMD fourni par IBM, est utilisée.

*JOBD

Le système utilise la donnée de routage indiquée dans la description de travail.

*RQSDTA

Les 80 premiers caractères de la données demande indiquée dans le paramètre (RQSDTA) (Donnée demande ou commande) de cette commande sont utilisés comme donnée de routage pour le travail.

valeur-caractère

Indiquez la chaîne de caractères utilisée comme donnée de routage pour démarrer le travail. (80 caractères au maximum, placés entre apostrophes si nécessaire).

Donnée demande ou commande (RQSDTA)

Indique les données de demande constituant le dernier poste de la file d'attente de messages du travail. Il peut s'agir d'une commande CL à exécuter ou d'une chaîne de caractères utilisée par un autre programme.

*CMD

La donnée indiquée pour le paramètre CMD (Commande à exécuter est placée dans la file d'attente de messages du travail.

*JOBD

La donnée demande définie dans la description de travail est placée dans la file d'attente de messages du travail.

*NONE

Aucune donnée demande n'est placée dans la file d'attente de messages du travail.

*RTGDTA

La donnée de routage indiquée dans le paramètre RTGDTA (Donnée de routage) de cette commande est placée à la fin de la file d'attente de messages du travail.

valeur-caractère

Indiquez la chaîne de caractères devant constituer le dernier poste de la file d'attente de messages du travail soumis (3000 caractères au maximum, placés entre apostrophes si nécessaire).

Liste bibliothèques système (SYSLIBL)

Indique quelle partie système de la liste des bibliothèques le travail soumis doit utiliser.

*CURRENT

Le travail soumis utilise la liste des bibliothèques système de l'unité d'exécution en cours.

*SYSVAL

Le travail utilise la liste des bibliothèques système par défaut. Cette liste comporte les noms des bibliothèques définis dans la valeur système QSYSLIBL au démarrage du travail.

Bibliothèque en cours (CURLIB)

Indique le nom de la bibliothèque en cours associée au travail soumis.

*CURRENT

Le travail soumis utilise la même bibliothèque en cours que l'unité d'exécution en cours.

*USRPRF

La bibliothèque en cours du travail soumis est la bibliothèque en cours définie dans le profil utilisateur avec lequel ce travail s'exécute initialement.

*CRTDFT

Il n'existe pas de bibliothèque en cours pour le travail soumis. Si des objets sont créés, QGPL est utilisée par défaut comme bibliothèque en cours.

nom

Indiquez le nom de la bibliothèque en cours du travail soumis.

Liste bibliothèques initiale (INLLIBL)

Indique la partie utilisateur initiale de la liste des bibliothèques dans laquelle sont recherchés les noms d'objets qui ont été indiqués sans qualificatif de bibliothèque.

Remarque :La duplication des noms de bibliothèque dans la liste des bibliothèques n'est pas admise.

Valeurs uniques

*CURRENT

La liste des bibliothèques de l'unité d'exécution en cours est utilisée pour le travail soumis.

*JOBD

La liste des bibliothèques indiquée dans la description de travail est utilisée comme liste initiale des bibliothèques utilisateur.

*SYSVAL

Le travail utilise la liste des bibliothèques utilisateur par défaut. Cette liste comporte les noms des bibliothèques définis dans la valeur système QUSRLIBL au lancement du travail.

*NONE

Aucune bibliothèque utilisateur ne figure dans la liste initiale des bibliothèques.

Autres valeurs (jusqu'à 250 répétitions)

nom

Indiquez le nom d'une ou de plusieurs bibliothèques qui constitueront la partie utilisateur de la liste des bibliothèques utilisée par le travail. La recherche s'effectue dans l'ordre dans lequel figurent les bibliothèques dans la liste.

Groupe ASP initial (INLASPGRP)

Indique la configuration initiale pour le nom de groupe de pools de mémoire secondaire (ASP) pour l'unité d'exécution initiale du travail soumis. Une unité d'exécution peut utiliser la commande SETASPGRP (Définir groupe ASP) pour modifier son espace de nom de bibliothèque. Lorsqu'un groupe d'ASP est associé à une unité d'exécution, toutes les bibliothèques des ASP indépendants du groupe d'ASP sont accessibles et les objets de ces bibliothèques peuvent être référencés à l'aide de la syntaxe de nom qualifié d'objet de la bibliothèque classique. Les bibliothèques des ASP indépendants du groupe d'ASP indiqué plus les bibliothèques de l'ASP système (numéro d'ASP 1) et des ASP utilisateur de base (numéros d'ASP 2 à 32) forment l'espace de nom de bibliothèque pour l'unité d'exécution.

*CURRENT

Le nom de groupe d'ASP pour l'unité d'exécution en cours est utilisé pour le travail soumis.

*JOBD

Le nom de groupe d'ASP initial indiqué dans la description de travail est utilisé pour le travail soumis.

*NONE

Indique que l'unité d'exécution initiale du travail soumis va être lancée sans groupe d'ASP. L'espace de nom de bibliothèque n'inclura aucune bibliothèque des groupes d'ASP. Seules les bibliothèques de l'ASP système et des ASP utilisateur de base se trouveront dans l'espace de nom de bibliothèque.

nom

Indiquez le nom du groupe d'ASP qui doit être défini pour l'unité d'exécution initiale du travail soumis. Le nom de groupe d'ASP est le nom de l'unité ASP principale au sein du groupe d'ASP. Toutes les bibliothèques de tous les ASP de ce groupe d'ASP vont être incluses dans l'espace de nom de bibliothèque.

Consignation des messages (LOG)

Indique les valeurs de consignation de message utilisées pour déterminer la quantité et le type des informations placées dans l'historique du travail. Ce paramètre comporte trois éléments : le niveau de consignation, la gravité et le niveau de texte des messages.

Elément 1 : Niveau

*JOBD

C'est la valeur définie dans la description de travail qui est prise en compte.

0-4

Indiquez le niveau de consignation des messages utilisé pour ce travail. Il existe cinq niveaux :

0

Aucun message n'est consigné.

1

Tous les messages envoyés dans la file d'attente de messages externe du travail qui sont affectés d'un niveau de gravité supérieur ou égal à la valeur indiquée sont consignés. Sont inclus les messages de début, d'arrêt et d'achèvement du travail.

2

Les informations suivantes sont consignées :

• informations de niveau 1,
• messages de demande donnant lieu à l'émission d'un message de haut niveau dont le code de gravité est supérieur ou égal à la gravité de consignation définie. Le message de demande ainsi que tous les messages associés sont consignés.

Remarque :Un message de haut niveau est un message envoyé dans la file d'attente de messages du programme qui reçoit la demande. Par exemple, QCMD est un programme de traitement des demandes fourni par IBM qui reçoit des messages de demande.

3

Les informations suivantes sont consignées :

• informations de niveau 1 et 2,
• tous les messages de demande
• les commandes exécutées par un programme CL sont consignées si les valeurs de consignation de l'attribut de travail et de l'attribut de consignation du programme l'admettent.

4

Les informations suivantes sont consignées :

• tous les messages de demande et tous les messages dont le niveau de gravité est supérieur ou égal au niveau de gravité de consignation de messages défini, y compris les messages de trace,
• les commandes exécutées par un programme CL sont consignées si les valeurs de consignation de l'attribut de travail et de l'attribut de consignation du programme l'admettent.

Elément 2 : Filtre de gravité

*JOBD

C'est la valeur définie dans la description de travail qui est prise en compte.

0-99

Indiquez le niveau de gravité à utiliser avec le niveau de consignation pour déterminer les messages d'erreur à consigner dans l'historique du travail.

Elément 3 : Texte

*JOBD

C'est la valeur définie dans la description de travail qui est prise en compte.

*MSG

Seul le texte du message est consigné dans l'historique.

*SECLVL

Le texte de message et l'aide sur le message (sections Cause et Que faire) du message d'erreur sont écrits dans l'historique du travail.

*NOLIST

Si le travail se termine normalement, aucun historique du travail n'est généré. L'historique du travail n'est généré qu'en cas de fin anormale du travail (code de fin de travail égal ou supérieur à 20). Les messages qui s'affichent dans l'historique du travail contiennent à la fois le texte du message et l'aide correspondante.

Consigner cdes programme CL (LOGCLPGM)

Indique si les commandes exécutées dans un programme en langage de contrôle (CL) sont consignées dans l'historique du travail via la file d'attente de messages du programme CL. Ce paramètre détermine l'état de l'indicateur de consignation du travail. Si *JOB a été indiqué à l'invite Consignation des messages (paramètre LOG) dans la commande CRTCLPGM (Créer un programme CL), l'indicateur défini à l'invite Consigner cdes programme CL (paramètre LOGCLPGM) est utilisé. Les autres valeurs de l'invite Consignation des messages (paramètre LOG) se substituent aux valeurs de l'invite Consigner cdes programme CL (paramètre LOGCLPGM). Les commandes sont consignées de la même façon que les demandes.

*JOBD

Le système utilise la valeur définie dans la description de travail.

*NO

Les commandes de programme CL ne sont pas consignées dans l'historique du travail.

*YES

Les commandes de programme CL sont consignées dans l'historique du travail.

Sortie historique du travail (LOGOUTPUT)

Permet de définir la façon dont l'historique du travail sera créé lorsque le travail sera terminé. Ceci ne concerne pas les historiques de travaux générés lorsque la file d'attente de messages est saturée et que l'action correspondante est *PRTWRAP. Les messages contenus dans la file d'attente de messages du travail sont écrits dans un fichier spoule à partir duquel l'historique du travail peut être imprimé, sauf si l'API QMHCTLJL était utilisée dans le travail pour indiquer que les messages de l'historique du travail doivent être écrits dans un fichier base de données.

La valeur de sortie d'historique du travail peut être modifiée à tout moment tant que l'historique n'est pas généré ou supprimé. Pour ce faire, vous pouvez utiliser l'API QWTCHGJB ou la commande CHGJOB.

La valeur de sortie d'historique du travail peut être affichée à tout moment tant que l'historique n'est pas généré ou supprimé. Pour ce faire, utilisez la commande DSPJOBLOG.

L'historique du travail peut être supprimé lorsque l'exécution du travail est terminée et que l'historique du travail n'a pas encore été généré ou supprimé. Pour supprimer l'historique du travail, vous pouvez utiliser l'API QWTRMVJL ou la commande ENDJOB.

*JOBD

Le système utilise la valeur définie dans la description de travail.

*SYSVAL

La valeur spécifiée dans la valeur système QLOGOUTPUT est utilisée.

*JOBLOGSVR

L'historique du travail sera généré par un serveur d'historique de travail. Pour en savoir plus sur les serveurs d'historique de travail, reportez-vous à la commande STRLOGSVR.

*JOBEND

L'historique du travail sera généré par le travail lui-même. Si le travail ne peut pas générer son propre historique, celui-ci sera créé par le serveur d'historique du travail. Par exemple, un travail ne génère pas son propre historique lorsque le système traite une commande PWRDWNSYS.

*PND

L'historique du travail ne sera pas généré. Il restera en instance jusqu'à ce qu'il soit supprimé.

Taille maxi file messages trav (JOBMSGQMX)

Indique la taille maximale de la file d'attente de messages du travail.

*JOBD

La valeur indiquée dans la description du travail détermine la taille maximale de la file d'attente de messages du travail.

*SYSVAL

Lors du démarrage du travail, la taille maximale de la file d'attente est déterminée par la valeur système QJOBMSGQMX.

2-64

Indiquez la taille maximale (en Mo) de la file d'attente de messages de ce travail.

Action file msg trav saturée (JOBMSGQFL)

Indique l'action à entreprendre lorsque la file d'attente de messages du travail est saturée.

*JOBD

La valeur indiquée dans la description de travail détermine l'action à entreprendre.

*SYSVAL

La valeur système QJOBMSGQFL est utilisée.

*NOWRAP

La file d'attente de messages ne boucle pas lorsqu'elle est saturée. Le travail est arrêté.

*WRAP

La file d'attente de messages boucle lorsqu'elle est saturée et elle se remplit à nouveau.

*PRTWRAP

La file d'attente de messages boucle lorsqu'elle est saturée et les messages qui vont ainsi être écrasés sont imprimés.

Réponse message interrogation (INQMSGRPY)

Indique le mode de réponse aux messages prédéfinis envoyés à la suite de l'exécution de ce travail. Vous pouvez déterminer que le contrôle des réponses des messages d'interrogation est issu de la description du travail, que tous les messages d'interrogation reçoivent une réponse ou qu'une réponse par défaut est émise, ou encore qu'une réponse appropriée est recherchée dans la liste des réponses du système à chaque envoi de message d'interrogation prédéfini.

*JOBD

C'est la valeur définie dans la description de travail qui définit le type de réponse à donner aux messages d'interrogation.

*RQD

Toute personne recevant un message d'interrogation lors du traitement de la commande doit y répondre.

*DFT

Le système envoie une réponse par défaut à tout message d'interrogation émis lors de l'exécution de la commande.

*SYSRPYL

Le système vérifie, dans la liste des réponses système, si un poste existe pour tout message d'interrogation émis par ce travail avec un identificateur et, éventuellement, une donnée de comparaison identiques. Si c'est le cas, il utilise la réponse de ce poste. Sinon, une réponse au message est obligatoire.

Suspendre en file de travaux (HOLD)

Indique si le travail était suspendu quand il a été placé en file d'attente. Un travail demeure suspendu, jusqu'à ce qu'il soit libéré par la commande RSLJOB ( Libérer un travail) ou arrêté par la commande ENDJOB (Arrêter un travail) ou CLRJOBQ (Mettre à blanc une file d'attente de travaux).

*JOBD

C'est la valeur définie dans la description de travail qui détermine si le travail est suspendu lorsqu'il est placé en file d'attente.

*NO

Le travail n'est pas suspendu lorsqu'il est placé en file d'attente.

*YES

Le travail est suspendu lorsqu'il est placé en file d'attente, et ce jusqu'à ce qu'il soit libéré ou arrêté.

Date planifiée (SCDDATE)

Indique la date à laquelle le travail planifié doit être soumis à la file d'attente de travaux, pour être exécuté.

Si votre système ou votre travail utilise le format de date Julien, les valeurs *MONTHSTR et *MONTHEND sont calculées comme s'il n'utilisait pas ce format.

*CURRENT

Le travail soumis doit être exécuté à la date du jour.

*MONTHSTR

Le travail soumis doit être exécuté le premier jour du mois. Si la date du jour correspond au premier jour du mois, mais que l'heure indiquée au paramètre SCDTIME n'est pas passée, l'exécution du travail doit avoir lieu ce jour. Sinon, elle est reportée au premier jour du mois suivant.

*MONTHEND

Le travail soumis doit être exécuté le dernier jour du mois. Si la date du jour correspond au dernier jour du mois, mais que l'heure indiquée au paramètre SCDTIME n'est pas passée, l'exécution du travail doit avoir lieu ce jour. Si la date du jour correspond au dernier jour du mois, mais que l'heure indiquée au paramètre SCDTIME n'est pas passée, l'exécution du travail doit avoir lieu le dernier jour du mois suivant.

*MON

Le travail doit être exécuté lundi.

*TUE

Le travail doit être exécuté mardi.

*WED

Le travail doit être exécuté mercredi.

*THU

Le travail doit être exécuté jeudi.

*FRI

Le travail doit être exécuté vendredi.

*SAT

Le travail doit être exécuté samedi.

*SUN

Le travail doit être exécuté dimanche.

date

Indiquez une date, avec ou sans séparateurs, dans le format de date du travail.

Heure planifiée (SCDTIME)

Indique l'heure à laquelle le travail doit être exécuté à la date planifiée.

Remarque :Bien que vous puissiez définir l'heure d'exécution du travail à la seconde près, une éventuelle surcharge du système peut en retarder le démarrage.

L'ordre d'affichage dans la file d'attente de travaux des postes travaux dont les valeurs SCDDATE et SCDTIME sont identiques peut différer de leur ordre d'arrivée. De la même manière, l'ordre de départ de ces travaux de la file d'attente en vue de leur traitement peut différer de leur ordre d'arrivée. Il faut donc garder en mémoire que les travaux ne sont pas entrés ni traités de manière séquentielle lorsqu'il est prévu qu'ils démarrent simultanément.

*CURRENT

L'heure de soumission du travail est l'heure en cours.

heure

Indiquez l'heure de démarrage souhaitée pour le travail. Pour cela, utilisez le format 24 heures, avec ou sans séparateur :

• Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), hh représentant les heures, mm les minutes et ss les secondes. Les valeurs admises pour les heures s'échelonnent entre 00 et 23. Elles s'échelonnent entre 00 et 59 pour les minutes et les secondes.
• Si vous utilisez des séparateurs, entrez une chaîne de 5 ou 8 chiffres, où le séparateur indiqué pour votre travail délimite les heures, les minutes et les secondes. Si cette commande est lancée a partir de la ligne de commande, la chaîne doit être entrée entre apostrophes. Si vous utilisez un autre séparateur que celui indiqué pour votre travail, la commande échouera.

Date du travail (DATE)

Indique la date attribuée au travail lors du démarrage de celui-ci.

*JOBD

La date du travail est la date définie dans la description de travail.

*SYSVAL

La date du travail est celle de la valeur système QDATE au démarrage du travail.

date

Indiquez la date de travail à utiliser après le démarrage du travail. Cette valeur doit être indiquée selon le format de la date du travail.

Indicateurs externes (SWS)

Indique l'état initial des huit indicateurs externes du travail. Ces indicateurs peuvent être testés ou définis dans un programme CL ; ils permettent de contrôler le flot du programme. Les indicateurs ne peuvent prendre que les valeurs 1 (actif) ou 0 (inactif), que vous pouvez préciser dans la chaîne de 8 caractères.

*JOBD

C'est la valeur donnée dans la description de travail qui définit l'état initial des indicateurs externes.

valeur-caractère

Indiquez l'état initial des indicateurs externes du travail (combinaison de huit chiffres, de valeur 0 ou 1).

Affichage par WRKSBMJOB (DSPSBMJOB)

Indique si le travail soumis peut figurer dans l'écran Gestion des travaux soumis. Tous les travaux soumis dont le type correspond à celui indiqué par le paramètre SBMFROM (Travaux soumis de) de la commande WRKSBMJOB (Gérer les travaux soumis) peuvent être affichés si le travail n'est pas bloqué par ce paramètre.

*YES

Ce travail peut être affiché par la commande WRKSBMJOB.

*NO

Ce travail ne figure sur aucun des écrans produits par la commande WRKSBMJOB.

Soumis pour (SBMFOR)

Indique le nom de travail à utiliser dans le paramètre SBMFROM (Travaux soumis de) de la commande WRKSBMJOB (Gérer les travaux soumis).

Valeurs uniques

*CURRENT

Le nom du travail actuellement actif est utilisé.

Qualificatif 1 : Soumis pour

nom

Indiquez le nom du travail.

Qualificatif 2 : Utilisat

nom

Indiquez le nom de l'utilisateur qui identifie le profil utilisateur sous lequel le travail s'exécute.

Qualificatif 3 : Numéro

000000-999999

Indiquez le numéro du travail.

Remarque :Vous devez disposer des droits spéciaux (*JOBCTL) pour utiliser ce paramètre.

File attente messages (MSGQ)

Indique la file d'attente de messages dans laquelle le message d'achèvement est envoyé lorsque le travail soumis est terminé, que la fin soit normale ou anormale. En cas de fin anormale, l'aide associée au message précise les causes possibles de l'incident.

Valeurs uniques

*USRPRF

Un message d'achèvement est envoyé dans la file d'attente de messages définie dans le profil utilisateur associé au travail qui a demandé cette soumission.

*WRKSTN

Un message d'achèvement est envoyé dans la file d'attente de messages du poste de travail à partir duquel le travail est soumis. Aucun message n'est envoyé si le travail est soumis par un travail par lots.

*NONE

Aucun message d'achèvement n'est envoyé.

Qualificatif 1 : File attente messages

nom

Indiquez le nom de la file d'attente de messages à laquelle le message d'achèvement doit être envoyé.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La file d'attente de messages est recherchée dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez la bibliothèque contenant la file d'attente de messages.

Séquence de tri (SRTSEQ)

Indique la table de séquence de tri à utiliser pour effectuer des comparaisons de chaînes pour ce travail.

Valeurs uniques

*CURRENT

La table de tri indiquée pour le travail en cours d'exécution est utilisée.

*USRPRF

La table de tri utilisée est celle qui est indiquée dans le profil utilisateur sous lequel le travail soumis est initialement exécuté. Le profil utilisateur est indiqué dans le paramètre USER (Utilisat).

*SYSVAL

La valeur système QSRTSEQ est utilisée.

*HEX

Aucune table de séquence de tri n'est utilisée. Les valeurs hexadécimales des caractères sont utilisées pour déterminer la séquence de tri.

*LANGIDUNQ

Une table de tri à poids uniques est utilisée.

*LANGIDSHR

Une table de tri à poids partagés est utilisée.

Qualificatif 1 : Séquence de tri

nom

Indiquez le nom de la table de séquence de tri.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche est effectuée dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez la bibliothèque contenant la table de séquence de tri.

Identificateur de langue (LANGID)

Indique l'identificateur de langue à associer à ce travail. L'identificateur de langue est utilisé lorsque *LANGIDUNQ ou *LANGIDSHR est indiqué dans le paramètre SRTSEQ (Séquence de tri). Si l'ID codé de jeu de caractères (CCSID) du travail est 65535, ce paramètre est également utilisé pour déterminer la valeur du CCSID par défaut du travail (DFTCCSID).

*CURRENT

L'identificateur de langue indiqué pour le travail en cours d'exécution est utilisé.

*USRPRF

L'identificateur de langue utilisé est celui qui est indiqué dans le profil utilisateur sous lequel le travail soumis est exécuté. Le profil utilisateur est indiqué dans le paramètre USER (Utilisat).

*SYSVAL

La valeur système QLANGID est utilisée.

valeur-caractère

Indiquez l'identificateur de langue qui sera utilisé par le travail.

ID pays ou région (CNTRYID)

Indique l'identificateur de pays ou région que le travail doit utiliser.

*CURRENT

L'identificateur de pays ou région indiqué pour le travail en cours d'exécution est utilisé.

*USRPRF

L'identificateur de pays ou région utilisé est celui qui est indiqué dans le profil utilisateur sous lequel le travail soumis est exécuté. Le profil utilisateur est indiqué dans le paramètre USER (Utilisat).

*SYSVAL

La valeur système QCNTRYID est utilisée.

valeur-caractère

Indiquez l'identificateur de pays ou région qui sera utilisé par le travail.

ID codé de jeu de caractères (CCSID)

Indique le CCSID associé au travail soumis.

*CURRENT

Le CCSID utilisé est celui associé au travail en cours.

*USRPRF

Le CCSID utilisé est celui indiqué dans le profil utilisateur associé au travail en cours.

*SYSVAL

Le CCSID utilisé est celui indiqué dans la valeur système QCCSID au moment du démarrage du travail.

*HEX

Le CCSID utilisé est 65535.

1-65535

Indiquez le CCSID.

Copier variables environnement (CPYENVVAR)

Indique si les variables d'environnement du travail de soumission sont copiées dans le nouveau travail.

*NO

Les variables d'environnement ne sont pas copiées.

*YES

Les variables d'environnement sont copiées.

Unités exéc multiples admises (ALWMLTTHD)

Indique si le travail admet l'exécution d'unités d'exécution multiples définies par l'utilisateur. Cet attribut n'empêche pas la création d'unités d'exécution définies par le système dans le travail. Cet attribut ne peut pas être modifié une fois le travail soumis.

*JOBD

La valeur indiquée dans la description du travail détermine si ce dernier peut exécuter des unités d'exécution multiples définies par l'utilisateur.

*NO

Le travail ne peut pas exécuter d'unités d'exécution multiples définies par l'utilisateur.

*YES

Le travail peut exécuter d'unités d'exécution multiples définies par l'utilisateur.

Action de fichier spoule (SPLFACN)

Indique si l'accès aux fichiers spoule se fait par les interfaces de travail après l'arrêt du travail ou non. Le fait de conserver les fichiers spoule avec les travaux permet aux commandes de travail, telles que WRKSBMJOB (Gérer les travaux soumis), de gérer les fichiers spoule même après l'arrêt du travail. Le fait de détacher les fichiers spoule des travaux réduit l'utilisation des ressources système en permettant aux structures de travail d'être recyclées lors de l'arrêt du travail.

*CURRENT

La valeur du travail en cours est utilisée pour le travail soumis.

*JOBD

C'est la valeur indiquée dans la description de travail qui est prise en compte.

*SYSVAL

La valeur indiquée dans la valeur système QSPLFACN est utilisée.

*KEEP

Si les fichiers spoule du travail se trouvent sur le pool de mémoire secondaire système (ASP 1) ou sur un pool utilisateur de base (ASP 2-32) lors de l'arrêt du travail, ils sont conservés avec le travail et l'état du travail est mis à jour pour indiquer que le travail est terminé. Lorsque tous les fichiers spoule restants se trouvent sur des ASP indépendants (ASP 33-255), ils sont détachés du travail et ce dernier est retiré du système.

*DETACH

Lorsque le travail est arrêté, les fichiers spoule sont détachés du travail et celui-ci est enlevé du système.

Exemples

Exemple 1 : Soumission d'un travail

SBMJOB   JOB(SPECIAL)  JOBD(MYLIB/MYJOBD)  CMD(CALL MYPROG)

Cette commande permet de soumettre un travail appelé SPECIAL. A l'exception de la commande, la plupart des attributs du travail proviennent de la description de travail MYJOBD ou du travail en cours d'exécution. La commande CALL est placée dans la file d'attente de messages du travail soumis afin que le programme MYPROG puisse être appelé et exécuté ultérieurement.

Exemple 2 : Soumission d'un travail

SBMJOB   JOB(PAYROLL)  JOBD(PAYROLL)  INQMSGRPY(*RQD)

Cette commande permet de soumettre un travail appelé PAYROLL au système. Toutes les informations nécessaires (notamment la file d'attente de travaux, la donnée de routage mais pas la valeur de contrôle) se trouvent dans la description de travail PAYROLL ou dans le travail en cours d'exécution. La liste de bibliothèques en cours pour le travail qui émet cette commande est utilisée pour identifier la description de travail. Tous les messages d'interrogation envoyés lors de l'exécution de ce travail requièrent une réponse du destinataire de ces messages.

Exemple 3 : Soumission d'un travail à une file d'attente de travaux

SBMJOB   JOBD(*USRPRF)  JOB(COPY12)  JOBQ(NIGHTQ)
         CMD(CPYF FILEA FILEB)

Cette commande permet de soumettre à la file d'attente de travaux NIGHTQ le travail COPY12, qui utilise la description de travail indiquée dans le profil utilisateur associé. Le paramètre CMD fournit la commande CL nécessaire pour exécuter le travail. Ce type de commande peut être utilisée pour copier le fichier la nuit, lorsque le système fonctionne en mode automatique.

Messages d'erreur

Messages *ESCAPE

CPF133A

SBMJOB non admis pendant un IPL.

CPF1338

Erreurs dans la commande SBMJOB.

CPF1651

La table de séquence de tri est inaccessible.