DMPTRC

Clicher la trace

En bref

La commande DMPTRC permet de copier des données de la table de trace VMC (microcode vertical) dans un fichier base de données.

DMPTRC se lit DMP (Vider (dump)) + TRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DMPTRC MBR(…)

Paramètres

MBR Membre obligatoire
LIB Bibliothèque
JOBQ File d'attente de travaux
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez DMPTRC 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 QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande DMPTRC permet de copier des données de la table de trace VMC (microcode vertical) dans un fichier base de données. Vous pouvez traiter le travail en interactif ou par lots. (Les travaux par lots seront exécutés sous la description de travail et le profil utilisateur de l'émetteur.)

Restrictions :

Cette commande est livrée avec le droit *EXCLUDE public.
Pour utiliser cette commande, vous devez disposer du droit spécial *SERVICE ou être autorisé à utiliser la fonction de trace de service du système d'exploitation. La commande CL CHGFCNUSG (Modifier utilisat. de fonction) ou l'API QSYCHFUI (Informations Modifier utilisat. de fonction), utilisée conjointement avec un ID de fonction QIBM_SERVICE_TRACE, peut être utilisée pour modifier la liste des utilisateurs autorisés à effectuer des opérations de trace.
Les profils utilisateur suivants sont autorisés à utiliser cette commande :
- QSRV
- QPGMR

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MBR	Membre	Nom	Obligatoire, positionnel 1
LIB	Bibliothèque	Nom, QPFRDATA	Facultatif
JOBQ	File d'attente de travaux	Valeurs uniques: NONE Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File d'attente de travaux	Nom, QCTL
	Qualificatif 2: Biblio	Nom, QSYS, LIBL, CURLIB
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif

Membre (MBR)

Indique le membre du fichier base de données dans lequel les données de la table de trace sont clichées.

Ce paramètre est obligatoire.

nom: Indiquez le nom du membre de fichier base de données à utiliser.

Bibliothèque (LIB)

Indique la bibliothèque où réside le fichier base de données contenant les données de traçage. Si le fichier n'est pas trouvé, le système le crée automatiquement dans cette bibliothèque.

QPFRDATA: La bibliothèque de données de performances fournie par IBM, QPFRDATA, doit être utilisée.
nom: Indiquez le nom de la bibliothèque à utiliser.

File d'attente de travaux (JOBQ)

Indique la file d'attente de travail à utiliser si vous souhaitez que cette commande DMPTRC (Clicher une trace) s'exécute sous forme de travail par lots.

Valeurs uniques

*NONE: Aucun travail n'est soumis. La demande DMPTRC s'exécute en interactif.

Qualificatif 1 : File d'attente de travaux

QCTL: La file d'attente de travail QCTL doit être utilisée.
nom: Indiquez le nom de la file d'attente de travail à utiliser.

Qualificateur 2: Biblio

QSYS: La file d'attente des travaux est recherchée dans la bibliothèque système QSYS, fournie par IBM.
*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Texte 'descriptif' (TEXT)

Indique un bref descriptif du membre de base de données.

*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Tapez un texte d'au plus 50 caractères, entre apostrophes.

Exemples

DMPTRC   MBR(TUESAM)

Cette commande entraîne l'écriture de données de trace VMC existantes dans le membre TUESAM de la bibliothèque QPFRDATA. Le fichier utilisé s'appelle QAPMDMPT. La demande est soumise à la file d'attente de travail QCTL dans la bibliothèque QSYS. Elle s'exécute sous forme de travail par lots.

Messages d'erreur

*ESCAPE Messages

CPF0A81: Impossible d'envoyer trace de performances dans fichier base de données.
CPF0A82: Impossible d'envoyer trace de performances dans fichier base de données.
CPF2110: Bibliothèque &1 non trouvée.
CPF3307: File d'attente de travaux &1 de &2 non trouvée.
CPF7207: Impossible de démarrer &2. Code retour &3. Not able to start &2. Return code &3.