Aller au contenu

DSPHSTJS

Afficher l'historique JS

En bref

La commande DSPHSTJS permet d'afficher ou d'imprimer l'historique relatif à l'achèvement des travaux.

DSPHSTJS se lit DSP (Afficher) + HSTJS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPHSTJS

Paramètres

Astuce : dans une session 5250, tapez DSPHSTJS 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 : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande DSPHSTJS permet d'afficher ou d'imprimer l'historique relatif à l'achèvement des travaux. Cet historique est constitué à partir des états d'achèvement, des plages de date et des séquences. L'exécution de cette commande affiche l'écran Historique qui contient des informations sur les travaux, sur leur dernière exécution et leur état d'achèvement, en fonction des paramètres sélectionné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
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
OUTPUT Sortie *, *PRINT Facultatif

Travail JS (JOB)

Nom des travaux à afficher ou à imprimer. Vous pouvez spécifier un groupe et le numéro de séquence des travaux dont vous voulez afficher ou imprimer l'historique. Les informations peuvent être affichées à l'écran ou imprimées dans le rapport en étant classées par travail, par date ou par groupe. Lorsque vous appuyez sur ENTREE, vous obtenez l'écran Historique à partir duquel vous pouvez effectuer diverses actions sur les informations de l'historique.

Elément 1 : Travail

*ALL
Affichage ou impression de l'historique IBM Advanced Job Scheduler for i pour tous les travaux correspondant aux critères de recherche indiqués dans la commande.
nom-générique
Indiquez un nom de travail générique. Par exemple, si vous spécifiez TRAV*, tous les travaux dont le nom commence par TRAV s'afficheront.
nom
Indiquez le nom du travail à afficher ou à imprimer.

Elément 2 : Groupe

*ALL
Affichage ou impression de l'historique IBM Advanced Job Scheduler for i pour tous les travaux, quel que soit le groupe auquel ils appartiennent.
*NONE
Le travail n'appartient à aucun groupe.
nom-générique
Indiquez un nom de groupe générique. Par exemple, si vous indiquez GROUP*, tous les groupes dont le nom commence par GROUP s'afficheront.
nom
Indiquez le nom du groupe dont vous voulez afficher ou imprimer des travaux.

Elément 3 : Séquence dans le groupe

*ALL
Tous les travaux auxquels est attribué un numéro de séquence sont affichés ou imprimés.
*NONE
Le travail ne comporte pas de numéro de séquence.
1-99
Indiquez le numéro de séquence du travail à afficher ou à imprimer.

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 ou imprimées.

Valeurs uniques

*ALL
Tous les travaux sont affichés sur l'écran 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 pour être affichés à l'écran ou imprimés dans le rapport.

Elément 1 : Heure et date de début

Indique les date et heure de début à partir desquelles les postes d'historique sont inclus. Aucun des travaux démarrés avant l'heure et la date indiquées n'est affiché à l'écran ou imprimé dans le rapport.

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.
entier
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 à partir desquelles les postes d'historique ne sont plus inclus. Aucun travail achevé après les date et heure spécifiées ne sera affiché à l'écran ou imprimé dans le rapport.

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 ou imprimés dans le rapport.
*CURRENT
Les postes correspondant à des travaux dont la date d'exécution est la date du jour ou est antérieure à celle-ci sont affichés à l'écran ou imprimés dans le rapport.
date
Indiquez la date de fin en utilisant le format de date du travail.
entier
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 de réseau associés au système qui a créé l'historique que vous voulez afficher ou imprimer.

*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 afficher ou imprimer l'historique.
ID-réseau.nom-lieu-éloigné
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 Historique.

*DATE
Les éléments sont triés par date.
*JOB
Les éléments sont triés par travail.
*GROUP
Les éléments sont triés 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.

Sortie (OUTPUT)

Indique si la sortie résultant de l'exécution de la commande s'affiche sur le poste de travail demandeur ou si elle est imprimée avec la sortie spoule du travail.

*
La sortie est affichée (travail interactif) ou imprimée avec le fichier spoule en sortie du travail (travail par lots).
*PRINT
La sortie est imprimée avec la sortie spoule du travail.

Exemples

Exemple 1 : Affichage de l'historique de Job Scheduler

DSPHSTJS   SEQOPT(*JOB)  OUTPUT(*PRINT)

Cette commande imprime le rapport d'historique de Job Scheduler pour tous les travaux et tous les groupes. Ce rapport est trié par travail.

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