Aller au contenu

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

  • JOB Travail JS
  • DTALIB Bibliothèque de données
  • STATUS Etat d'achèvement
  • PERIOD Période pour sortie historique
  • RMTLOCNAME Nom de lieu éloigné
  • SEQOPT Option de séquence
  • START Postes à 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.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.