ENDDBMON

La commande ENDDBMON (Arrêter moniteur base données) permet de mettre fin à la collecte des statistiques relatives aux performances de la base de données pour tous les travaux, pour un travail spécifique sur le système ou pour un ensemble de travaux (nom de travail générique).

Pour arrêter un moniteur, vous pouvez désigner le travail ou l'ID du moniteur (ou les deux). Si vous n'indiquez que le paramètre JOB, vous arrêtez le moniteur qui a été démarré avec ce même paramètre (lorsqu'il n'y a qu'un seul moniteur correspondant au paramètre JOB). Lorsqu'il existe plusieurs moniteurs actifs correspondant au paramètre JOB, l'utilisateur doit désigner distinctement celui qui doit être arrêté à l'aide du paramètre MONID. Lorsque le paramètre MONID est employé tout seul, on le compare à l'ID du moniteur du travail en cours et à l'ID de tous les moniteurs publics (moniteurs accessibles pour des travaux multiples). Le moniteur correspondant au paramètre MONID est arrêté.

L'ID moniteur est renvoyé dans le message d'information CPI436A qui est généré à chaque occurrence de la commande STRDBMON. L'ID moniteur figure également dans la colonne QQC101 de l'enregistrement dans la base de données QQQ3018.

Restrictions :

• Vous ne pouvez pas arrêter le moniteur base de données pour un travail spécifique en indiquant JOB(*ALL) dans la commande ENDDBMON. Pour arrêter un travail spécifique, vous devez le désigner à l'aide du paramètre JOB ou indiquer JOB(*).
• Si vous avez indiqué JOB(*ALL) dans la commande STRDBMON (Démarrer moniteur base données), vous ne pouvez pas arrêter le moniteur base de données pour un travail spécifique. Le paramètre ENDBMON JOB(*ALL) permet d'arrêter le moniteur actif utilisé pour tous les travaux. Vous ne pouvez arrêter un travail déterminé que s'il est désigné dans le paramètre JOB ou JOB (*).
• Cette commande autorise les unités d'exécution multiples sous certaines conditions. Elle ne les admet pas et risque d'échouer lorsque le paramètre OUTFILE de la commande STRDBMON désigne un fichier réparti ou un fichier DDM (Distributed Data Management) de type *SNA.
• Lorsque cette commande est utilisée avec un paramètre JOB générique ou s'appliquant à d'autres travaux utilisateur, vous devez disposer des droits spéciaux d'exploitation des travaux (*JOBCTL) ou être autorisé à utiliser la fonction d'administrateur SQL d'IBM i via l'administration d'applications de System i Navigator. La commande CHGFCNUSG, exécutée avec un ID fonction QIBM_DB_SQLADM, peut également être utilisée pour modifier la liste des utilisateurs autorisés.

Paramètres

Travail (JOB)

Indique le travail (ou les travaux) sur lequel le moniteur de base de données doit s'arrêter.

Valeurs uniques

*

Le moniteur de données du travail exécutant la commande ENDDBMON doit être arrêté.

*ALL

Le moniteur de données utilisé pour tous les travaux (démarré via JOB(*ALL)) doit être arrêté.

Qualificatif 1 : Travail

nom

Indiquez le nom du travail pour lequel le moniteur de base de données doit être arrêté. Si aucun nom d'utilisateur du travail ni aucun qualificatif de travail n'est indiqué, le nom du travail non qualifié est recherché dans tous les travaux en cours sur le système. Si plusieurs copies du travail recherché sont trouvées, vous devez indiquer un nom d'utilisateur du travail, un numéro de travail ou un ID moniteur pour identifier formellement le travail à modifier.

nom-générique

Indiquez le nom de travail générique du moniteur à arrêter. Le moniteur ayant été démarré avec le même nom de travail générique (ex : JOB(QZDA*)) va être arrêté.

Qualificatif 2 : Utilisat

nom

Indiquez le nom de l'utilisateur du travail pour lequel le moniteur de base de données doit être arrêté.

nom-générique

Indiquez l'utilisateur du travail générique du moniteur à arrêter. Le moniteur ayant été démarré avec le même utilisateur de travail générique (ex : JOB(*ALL/DEVLPR*)) va être arrêté.

Qualificatif 3 : Numéro

000000 à 999999

Indiquez le numéro du travail pour lequel le moniteur de base de données doit être arrêté.

ID moniteur (MONID)

Indique l'ID de moniteur distinct du moniteur de base de données à arrêter. Si plusieurs moniteurs ont été activés avec le même paramètre JOB, le paramètre MONID doit permettre d'identifier distinctement le moniteur à arrêter. La valeur d'un ID moniteur est générée par le système à chaque utilisation de la commande STRDBMON. Le message d'information CPI436A contient la valeur de l'ID moniteur générée par le système. La valeur de l'ID moniteur générée par le système figure également dans la colonne QQC101 de l'enregistrement dans la base de données QQQ3018.

*ALL

Lorsque ce paramètre est employé avec JOB(*ALL), tous les moniteurs publics (associés à plusieurs travaux) sont arrêtés. Lorsqu'il est employé avec un nom de travail générique (ex : JOB(QZDA*)), tous les moniteurs publics (associés à plusieurs travaux) qui ont été activés via JOB(QZDA*) sont arrêtés.

nom-unique

Indiquez l'ID moniteur de 10 octets associé au moniteur à arrêter.

Commentaire (COMMENT)

Description définie par l'utilisateur associée à l'enregistrement du moniteur base de données. Cette description est stockée dans l'enregistrement doté de l'ID 3018.

*BLANK

Aucun texte n'est indiqué.

valeur-caractère

Indiquez un texte de 100 caractères au maximum.

Exemples

Exemple 1: Arrêt du moniteur base de données pour un travail spécifique

ENDDBMON   JOB(*)

Cette commande arrête le moniteur base de données pour le travail en cours.

Exemple 2: Arrêt du moniteur base de données pour tous les travaux

ENDDBMON   JOB(*ALL)

Cette commande arrête le moniteur pour tous les travaux sur le système. Si plusieurs moniteurs sont actifs avec le paramètre JOB (*ALL), le paramètre MONID doit également être précisé pour identifier distinctement le moniteur à arrêter.

Exemple 3: Arrêt d'un moniteur public avec le paramètre MONID

ENDDBMON   JOB(*ALL) MONID(061601001)

Cette commande arrête le moniteur qui a été démarré avec JOB(*ALL) et qui a pour ID 061601001. Plusieurs moniteurs ont été activés avec JOB(*ALL). L'ID moniteur doit donc être précisé pour identifier distinctement le moniteur à arrêter.

Exemple 4: Arrêt d'un moniteur public avec le paramètre MONID

ENDDBMON   MONID(061601001)

Cette commande a le même effet que dans l'exemple précédent. Elle permet d'arrêter le moniteur qui a été démarré avec JOB(*ALL) ou JOB (*) et qui a pour ID 061601001.

Exemple 5: Arrêt de tous les moniteurs JOB(*ALL)

ENDDBMON   JOB(*ALL/*ALL/*ALL) MONID(*ALL)

Cette commande arrête tous les moniteurs actifs associés à des travaux multiples. Elle ne permet pas d'arrêter un moniteur actif associé à un travail spécifique ou au travail en cours.

Exemple 6: Arrêt d'un moniteur pour un travail générique

ENDDBMON   JOB(QZDA*)

Cette commande arrête le moniteur qui a été démarré avec JOB(QZDA*). Si plusieurs moniteurs sont actifs avec le paramètre JOB(QZDA*), le paramètre MONID doit également être précisé pour identifier distinctement le moniteur à arrêter.

Exemple 7: Arrêt d'un moniteur associé à un travail générique

ENDDBMON   JOB(QZDA*) MONID(061601001)

Cette commande arrête le moniteur qui a été démarré avec JOB(QZDA*) et qui a pour ID 061601001. Plusieurs moniteurs ont été activés avec JOB(QZDA*). L'ID moniteur doit donc être précisé pour identifier distinctement le moniteur à arrêter.

Exemple 8: Arrêt des moniteurs associés à un groupe de travaux génériques

ENDDBMON   JOB(QZDA*) MONID(*ALL)

Cette commande arrête les moniteurs qui ont été démarrés avec JOB(QZDA*).

Messages d'erreur

Messages *ESCAPE

CPF1321

Travail &3/&2/&1 non trouvé.

CPF436D

Le travail &1 ne fait pas l'objet d'un contrôle.

CPF436E

Travail &1 utilisateur &2 numéro &3 inactif.

CPF43A1

Le travail &1 indiqué dans la commande ENDDBMON n'est pas unique.