QUERY EVENT (Affichage de plannings d'événement d'administration)

Modifier en ligne

La commande QUERY EVENT permet d'afficher les événements planifiés et terminés pour les plannings de commande d'administration sélectionnés.

Classe de privilège

Tout administrateur peut émettre cette commande.

Syntaxe

Paramètres

nom_planification (obligatoire)

Désigne le nom du planning pour lequel les événements sont affichés. Vous pouvez utiliser des caractères génériques pour spécifier les noms.

Type=Administrative (obligatoire)

Indique que la requête affiche les événements relatifs aux plannings de commande d'administration.

BEGINDate

Indique la date de début de la période déterminant les événements à afficher. Tous les événements planifiés pour démarrer au cours de cette période s'affichent. Ce paramètre est facultatif. La valeur par défaut est la date actuelle.

Vous pouvez spécifier la date à l'aide d'une des valeurs suivantes :

Valeur	Description	Exemple
MM/JJ/AAAA	Une date déterminée	15/09/1998
TODAY	Date en cours	TODAY
TODAY+jours ou +jours	Date du jour, plus le nombre de jours spécifié. Le nombre maximal de jours admis est 9999.	TODAY +3 ou +3.
TODAY-jours ou -jours	Date actuelle moins le nombre de jours spécifié.	TODAY-7 ou -7. Pour rechercher les événements dont le démarrage est planifié au cours des 7 derniers jours, indiquez BEGINDATE=TODAY-7 ENDDATE=TODAY ou BEGINDATE=-7 ENDDATE=TODAY.
EOLM (End Of Last Month, fin du mois dernier)	Dernier jour du mois précédent	EOLM
EOLM-jours	Dernier jour du mois précédent moins les jours spécifiés	EOLM-1 Pour inclure les fichiers qui étaient actifs un jour avant le dernier jour du mois précédent.
BOTM (Beginning Of This Month, début de ce mois)	Premier jour du mois en cours	BOTM
BOTM +jours	Premier jour du mois en cours, plus les jours spécifiés	BOTM+9 Pour inclure les fichiers qui étaient actifs le 10e jour du mois en cours.

BEGINTime

Indique l'heure de début de la période déterminant les événements à afficher. Tous les événements planifiés pour démarrer au cours de cette période s'affichent. Ce paramètre est facultatif. La valeur par défaut est 00:00.

Vous pouvez spécifier l'heure avec l'une des valeurs suivantes :

Valeur	Description	Exemple
HH:MM:SS	Une heure spécifique à la date de début spécifiée.	10:30:08
NOW	Heure actuelle à la date de début spécifiée.	NOW
NOW+HH:MM ou +HH:MM	Heure actuelle plus les heures et les minutes à la date de début spécifiée	NOW+03:00 ou +03:00. Si vous exécutez cette commande à 9h00 de façon à rechercher les événements planifiés pour démarrer dans les trois heures à compter de l'heure actuelle, vous pouvez indiquer BEGINTIME=NOW+03:00 ou BEGINTIME=+03:00. IBM Storage Protect affiche les événements à 12:00 à la date de début spécifiée.
NOW-HH:MM ou -HH:MM	Heure actuelle moins les heures et les minutes à la date de début indiquée	NOW-04:00 ou -04:00. Si vous exécutez cette commande à 9h00 de façon à rechercher les événements planifiés pour démarrer au cours des quatre heures précédentes, vous pouvez indiquer BEGINTIME=NOW-04:00 ENDTIME=NOW ou BEGINTIME=-04:00 ENDTIME=NOW. IBM Storage Protect affiche les événements à 5:00 à la date de début spécifiée.

ENDDate

Indique la date de fin de la période déterminant les événements à afficher. Tous les événements planifiés pour démarrer au cours de cette période s'affichent. Ce paramètre est facultatif. La valeur par défaut est la valeur utilisée pour le paramètre BEGINDATE.

Vous pouvez spécifier la date à l'aide d'une des valeurs suivantes :

Valeur	Description	Exemple
MM/JJ/AAAA	Une date déterminée	15/09/1998
TODAY	Date en cours	TODAY
TODAY+jours ou +jours	Date du jour, plus le nombre de jours spécifié. Le nombre maximal de jours admis est 9999.	TODAY +3 ou +3.
TODAY-jours ou -jours	Date actuelle moins le nombre de jours spécifié.	TODAY-8 ou -8. Pour rechercher les événements planifiés pour démarrer pendant une période d'une semaine qui s'est terminée la veille, vous pouvez indiquer BEGINDATE=TODAY-8 ENDDATE=TODAY-1 ou BEGINDATE=-8 ENDDATE=-1.
EOLM (End Of Last Month, fin du mois dernier)	Dernier jour du mois précédent	EOLM
EOLM-jours	Dernier jour du mois précédent moins les jours spécifiés	EOLM-1 Pour inclure les fichiers qui étaient actifs un jour avant le dernier jour du mois précédent.
BOTM (Beginning Of This Month, début de ce mois)	Premier jour du mois en cours	BOTM
BOTM +jours	Premier jour du mois en cours, plus les jours spécifiés	BOTM+9 Pour inclure les fichiers qui étaient actifs le 10e jour du mois en cours.

ENDTime

Indique l'heure de fin de la période déterminant les événements à afficher. Tous les événements planifiés pour démarrer au cours de cette période s'affichent. Ce paramètre est facultatif. La valeur par défaut est 23:59.

Vous pouvez spécifier l'heure avec l'une des valeurs suivantes :

Valeur	Description	Exemple
HH:MM:SS	Une heure spécifique à la date de fin spécifiée.	10:30:08
NOW	Heure actuelle à la date de fin spécifiée.	NOW
NOW+HH:MM ou +HH:MM	Heure actuelle, plus le nombre d'heures et de minutes spécifié, à la date de fin indiquée	NOW+03:00 ou +03:00. Si vous exécutez cette commande à 9h00 de façon à rechercher les événements planifiés pour démarrer dans les trois heures à compter de l'heure actuelle, vous pouvez indiquer BEGINTIME=NOW ENDTIME=NOW+03:00 ou BEGINTIME=NOW ENDTIME=+03:00.
NOW-HH:MM ou -HH:MM	Heure actuelle, moins le nombre d'heures et de minutes spécifié, à la date de fin indiquée	NOW-04:00 ou -04:00

EXceptionsonly

Indique le type d'information que vous voulez obtenir sur les événements planifiés ou terminés. Ce paramètre est facultatif. La valeur par défaut est NO. Vous pouvez spécifier l'une des valeurs suivantes :

No: Les informations sur les événements passés et planifiés s'affichent.
Yes: Les événements qui ont échoué ou qui ne se sont pas déroulés selon la planification définie s'affichent.

Format

Indique sous quelle forme les informations s'affichent. Ce paramètre est facultatif. La valeur par défaut est STANDARD. Les valeurs admises sont les suivantes :

Standard: Indique que des données partielles sont affichées.
Detailed: Indique que les données complètes relatives aux événements sont affichées.

Exemple : Affichage des événements pour un planning d'administration spécifique

Affichez les informations partielles relatives à tous les événements planifiés pour un planning de commande d'administration nommé DOSADMIN. Limitez la requête aux événements planifiés pour le 30 mars 1999 (03/30/1999). Exécutez la commande :

query event dosadmin type=administrative 
begindate=03/30/1999 
enddate=03/30/1999

Scheduled Start      Actual Start          Schedule Status
                                           Name
-------------------- --------------------  --------- ---------
03/30/1999 00:00:00  03/30/1999 00:00:01   DOSADMIN  Completed
03/30/1999 04:00:00  03/30/1999 04:00:01   DOSADMIN  Completed
03/30/1999 12:00:00                        DOSADMIN  Future
03/30/1999 16:00:00                        DOSADMIN  Future

Description des champs

Démarrage planifié: Indique la date et l'heure de démarrage planifié de l'événement.
Démarrage réel: Indique la date et l'heure auxquelles le client a commencé à exécuter l'opération planifiée. Aucune donnée n'est affichée si l'exécution du planning n'a pas commencé.
Nom de planning: Indique le nom du planning qui a initié cet événement.
Statut: Pour les commandes d'administration ou les scripts indiquant WAIT=YES, le statut d'un événement planifié affiche STARTED jusqu'à ce que l'opération spécifiée par la commande ou le script soit terminée. Le statut final de l'événement planifié varie selon le code retour de l'opération. Toutefois, si WAIT=YES et si le planning exécute un script où PREVIEW=YES, le statut final affiche COMPLETED, à moins que le script ne contienne une erreur de syntaxe.
Pour les commandes d'administration ou les scripts affichant WAIT=NO, le statut d'un événement planifié affiche COMPLETED si la commande ou le script planifié(e) a démarré. La réussite du planning ne dépend pas de la réussite de l'opération effectuée par la commande ou le script.