WRKHSTJS
Gérer l'historique JS
En bref
La commande WRKHSTJS permet de gérer l'historique des travaux de Job Scheduler en fonction des états d'achèvement, des plages de date et des séquences.
WRKHSTJS se lit WRK
(Gérer) + HSTJS.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
WRKHSTJS
Paramètres
-
JOBTravail JS -
DTALIBBibliothèque de données -
STATUSEtat d'achèvement -
PERIODPériode pour sortie historique -
RMTLOCNAMENom de lieu éloigné -
SEQOPTOption de séquence -
STARTPostes à afficher en premier
Astuce : dans une session 5250, tapez WRKHSTJS 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 QIJS)
Où s'exécute : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non
La commande WRKHSTJS permet de gérer l'historique des travaux de Job Scheduler en fonction des états d'achèvement, des plages de date et des séquences. Son exécution affiche l'écran Gestion de l'historique qui contient des informations sur les travaux, leur dernière exécution et leur état d'achèvement, en fonction des paramètres indiqués dans la commande.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| JOB | Travail JS | Liste d'éléments | Facultatif, positionnel 1 |
| Élément 1: Travail | Nom générique, nom, *ALL | ||
| Élément 2: Groupe | Nom générique, nom, *ALL, *NONE | ||
| Élément 3: Séquence dans le groupe | 1-99, *ALL, *NONE | ||
| DTALIB | Bibliothèque de données | Nom, *USRPRF | Facultatif |
| STATUS | Etat d'achèvement | Valeurs uniques: *ALL Autres valeurs (jusqu'à 7 répétitions): *NORMAL, *ABNORMAL, *ABNGRP, *SBMERROR, *PROCESS, *JOBQ, *CANCELLED, *RESET |
Facultatif |
| PERIOD | Période pour sortie historique | Liste d'éléments | Facultatif |
| Élément 1: Heure et date de début | Liste d'éléments | ||
| Élément 1: Heure de début | Heure, *AVAIL | ||
| Élément 2: Date de début | Valeur caractère, *CURRENT, *BEGIN | ||
| Élément 2: Heure et date de fin | Liste d'éléments | ||
| Élément 1: Heure de fin | Heure, *AVAIL | ||
| Élément 2: Date de fin | Valeur caractère, *CURRENT, *END | ||
| RMTLOCNAME | Nom de lieu éloigné | Nom, *ALL, *LCL, *JOBCTL | Facultatif |
| SEQOPT | Option de séquence | *DATE, *JOB, *GROUP | Facultatif |
| START | Postes à afficher en premier | *LAST, *FIRST | Facultatif |
Travail JS (JOB)
Nom des travaux à gérer. Vous pouvez spécifier un groupe et le numéro de séquence des travaux dont vous voulez gérer l'historique. Vous pouvez afficher les données en les classant par travail, par date ou par groupe. Lorsque vous appuyez sur ENTREE, vous obtenez l'écran Gestion de l'historique à partir duquel vous pouvez effectuer diverses actions sur les informations de l'historique.
Elément 1 : Travail
- *ALL
- Gestion de l'historique de tous les travaux correspondant aux critères indiqués dans la commande.
- nom-générique
- Le travail est générique. Par exemple, si vous indiquez TRAV*, tous les travaux dont le nom commence TRAV s'afficheront sur l'écran Gestion de l'historique.
- nom
- Indiquez le nom du travail que vous voulez gérer.
Elément 2 : Groupe
- *ALL
- Gestion de l'historique de tous les travaux membres d'un groupe, quel qu'il soit.
- *NONE
- Le travail n'appartient à aucun groupe.
- nom-générique
- Le groupe est générique. Par exemple, si vous indiquez GROUP*, tous les groupes dont le nom commence par GROUP s'afficheront sur l'écran Gestion de l'historique.
- nom
- Indiquez le nom du groupe que vous voulez gérer.
Elément 3 : Séquence dans le groupe
- *ALL
- Tous les travaux auxquels est attribué un numéro de séquence sont affichés.
- *NONE
- Le travail ne comporte pas de numéro de séquence.
- 1-99
- Indiquez le numéro de séquence du travail à gérer.
Bibliothèque de données (DTALIB)
Indique la bibliothèque de données à laquelle accéder.
- *USRPRF
- La bibliothèque de données utilisée est celle qui figure dans le profil utilisateur de l'utilisateur en cours.
- nom
- Indiquez la bibliothèque de données à affecter au profil utilisateur. Tant que vous n'indiquerez pas d'autre nom, cette bibliothèque sera utilisée pour le profil utilisateur en cours.
Etat d'achèvement (STATUS)
Etat d'achèvement des travaux en fonction duquel les informations d'historique d'IBM Advanced Job Scheduler for i seront affichées.
Valeurs uniques
- *ALL
- Tous les travaux sont affichés sur l'écran Gestion de l'historique, quel que soit leur état d'achèvement.
Autres valeurs (jusqu'à 7 répétitions)
- *NORMAL
- Le travail s'est terminé de façon normale.
- *ABNORMAL
- Le travail s'est terminé de façon anormale. Vous pouvez utiliser le journal d'IBM Advanced Job Scheduler for i pour identifier l'origine de cet incident.
- *ABNGRP
- Le groupe s'est arrêté de façon anormale. Cet état d'achèvement s'applique à tous les travaux du groupe qui ne se sont pas exécutés parce que l'exécution d'un groupe de travaux précédent n'a pas abouti.
- *SBMERROR
- Le travail n'a pas abouti car une erreur s'est produite au cours de sa soumission (par exemple, lorsqu'un travail est soumis par un utilisateur ne disposant pas des droits appropriés pour cette opération).
- *PROCESS
- Le travail est en cours de traitement sur le système.
- *JOBQ
- Le travail se trouve dans la file d'attente de travaux et attend son exécution.
- *CANCELLED
- Le travail a été annulé avant l'achèvement de son exécution.
- *RESET
- Le travail a été réinitialisé manuellement.
Période pour sortie historique (PERIOD)
Période en fonction de laquelle les postes d'historique sont sélectionnés en vue d'être affiché à l'écran.
Elément 1 : Heure et date de début
Indique les date et heure de début à partir desquelles les postes d'historique doivent être inclus. Aucun des travaux démarrés avant l'heure et la date indiquées n'est affiché à l'écran.
-
Elément 1 : Heure de début
- *AVAIL
- Toute heure disponible pour la date de début est prise en compte.
- heure
- Pour la date de début spécifiée, indiquez l'heure à partir de laquelle les postes d'historique devront être inclus.
L'heure est indiquée dans un format 24 heures, avec ou sans séparateur :
- Sans séparateur, entrez une chaîne de 4 chiffres (hhmm), hh représentant l'heure et mm les minutes. Les heures et les minutes doivent être indiquées à l'aide de deux chiffres (insérez un zéro en première position si nécessaire.)
- Si un séparateur est utilisé, entrez une chaîne de 5 chiffres dans laquelle le séparateur délimitera les heures, les minutes et les secondes. Si vous entrez cette commande à partir de la ligne de commande, la chaîne doit figurer entre apostrophes. Utilisez le séparateur indiqué pour votre travail, sinon la commande échouera.
-
Elément 2 : Date de début
- *BEGIN
- Tous les postes depuis le début de l'historique sont inclus.
- *CURRENT
- Les travaux dont la date d'exécution figure dans la plage délimitée par l'heure de début et l'heure de fin (si indiquées) sont inclus.
- date
- Indiquez la date de début en utilisant le format de date du travail.
- nombre
- Indiquez le nombre de jours avant la date du jour devant être inclus dans la recherche. Par exemple, si vous indiquez 10 et si la date du jour est le 12/03/09 (format de date jj/mm/aa), la date de début pour l'historique d'IBM Advanced Job Scheduler for i sera le 02/03/09.
Elément 2 : Heure et date de fin
Date et heure de fin avant lesquelles les postes d'historique sont inclus. Aucun travail achevé après l'heure et la date spécifiées ne sera affiché à l'écran.
-
Elément 1 : Heure de fin
- *AVAIL
- Toute heure disponible pour la date de fin est incluse.
- heure
- Pour la date de fin spécifiée, indiquez l'heure après laquelle aucun poste ne sera pris en compte.
-
Elément 2 : Date de fin
- *END
- Tous les postes, jusqu'à la fin de l'historique, sont affichés à l'écran.
- *CURRENT
- Les postes correspondant à des travaux dont la date d'exécution est la date en cours ou est antérieure à celle-ci sont affichés à l'écran.
- date
- Indiquez la date de fin en utilisant le format de date du travail.
- nombre
- Indiquez le nombre de jours avant la date du jour devant être inclus dans la recherche. Par exemple, si vous indiquez 10 et si la date du jour est le 22/03/09 (format de date jj/mm/aa), la date de fin pour l'historique d'IBM Advanced Job Scheduler for i sera le 12/03/09.
Nom de lieu éloigné (RMTLOCNAME)
Lieu éloigné et identificateur réseau associés au système qui a créé l'historique à gérer.
- *ALL
- Les historiques de tous les systèmes du réseau sont sélectionnés.
- *LCL
- Les historiques du système local sont sélectionnés.
- *JOBCTL
- Les historiques correspondant au nom de lieu éloigné *JOBCTL sont sélectionnés.
- nom-lieu-éloigné
- Indiquez le nom de lieu éloigné associé au système pour lequel vous voulez gérer l'historique.
- ID-réseau.nom-lieu-éloignée
- Indiquez l'identificateur réseau et le nom de lieu éloigné associés au système. Utilisez pour cela le format nnnnnnnn.cccccccc où nnnnnnnn représente l'identificateur réseau et cccccccc, le nom de lieu éloigné.
Option de séquence (SEQOPT)
Critères de tri en fonction desquels les informations seront affichées sur l'écran Gestion de l'historique.
- *DATE
- Les données sont triées par date.
- *JOB
- Les données sont triées par travail.
- *GROUP
- Les données sont triées par groupe.
Postes à afficher en premier (START)
Indique si les postes de l'historique du travail doivent être affichés du plus récent au plus ancien ou inversement. Si la liste des postes n'est pas visible en totalité sur une seule page d'écran, vous pouvez la faire défiler.
- *LAST
- Le dernier poste de l'historique (le plus récent) est affiché sur la dernière ligne de l'écran.
- *FIRST
- Le premier poste de l'historique (le plus ancien) est affiché sur la première ligne de l'écran.
Exemples
WRKHSTJS SEQOPT(*JOB)
Cette commande affiche l'écran Gestion de l'historique pour tous les travaux et tous les groupes, triés par travail.
Messages d'erreur
Unknown© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.