DEFINE_TRACE

Article
07/21/2023

Le verbe DEFINE_TRACE active ou désactive le suivi des API spécifiées et contrôle le niveau de suivi.

La structure suivante décrit le bloc de contrôle de verbe (VCB) utilisé par le verbe DEFINE_TRACE.

Syntaxe

  
struct define_trace {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        reserv3[8];  
    unsigned char        dt_set;  
    unsigned char        appc;  
    unsigned char        reserv4;  
    unsigned char        srpi;  
    unsigned char        sdlc;  
    unsigned char        tkn_rng_dlc;  
    unsigned char        pcnet_dlc;  
    unsigned char        dft;  
    unsigned char        acdi;  
    unsigned char        reserv5;  
    unsigned char        ehllapi;  
    unsigned char        x25_api;  
    unsigned char        x25_dlc;  
    unsigned char        twinax;  
    unsigned char        reserv6;  
    unsigned char        lua_api;  
    unsigned char        etherand;  
    unsigned char        subsym;  
    unsigned char        reserv7[8];  
    unsigned char        reset_trc;  
    unsigned short       trunc;  
    unsigned short       strg_size;  
    unsigned char        reserv8;  
    unsigned char        phys_link[8];  
    unsigned char        reserv9[56];  
};

Membres

opcode
Paramètre fourni. Le verbe identifiant le code d’opération, SV_DEFINE_TRACE.

opext
Un champ réservé.

reserv2
Champ réservé.

primary_rc
Paramètre retourné. Spécifie le code de retour principal défini par APPC à l’achèvement du verbe. Les codes de retour valides dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

secondary_rc
Paramètre retourné. Spécifie le code de retour secondaire défini par APPC à l’achèvement du verbe. Les codes de retour valides dépendent du verbe APPC émis. Consultez la section Codes de retour pour connaître les codes d’erreur valides pour ce verbe.

reserv3
Un champ réservé.

dt_set
Paramètre fourni. Définit l’état du suivi.

Utilisez SV_ON pour activer le suivi d’une API particulière si le paramètre correspondant à l’API (par exemple, APPC ou comm_serv) est défini sur SV_CHANGE.
Utilisez SV_OFF pour désactiver le suivi d’une API particulière si le paramètre correspondant à l’API est défini sur SV_CHANGE.

appc
Paramètre fourni. Indique si le suivi d’APPC est souhaité.

Utilisez SV_CHANGE pour activer ou désactiver le suivi pour APPC, en fonction du paramètre dt_set.
Utilisez SV_IGNORE afin de conserver le suivi dans son état actuel pour APPC.

Les valeurs autorisées activent ou désactivent le bit 0. Les bits 1 à 7 sont réservés.

reserv4
Un champ réservé.

srpi
Paramètre fourni. Indique si le suivi de SRPI est souhaité.

Utilisez SV_CHANGE pour activer ou désactiver le suivi pour APPC, en fonction du paramètre dt_set.
Utilisez SV_IGNORE afin de conserver le suivi dans son état actuel pour APPC.

sdlc
Un champ réservé.

tkn_rng_dlc
Un champ réservé.

pcnet_dlc
Un champ réservé.

dft
Un champ réservé.

acdi
Un champ réservé.

reserv5
Un champ réservé.

comm_serv
Paramètre fourni. Indique si le suivi de COMM_SERV_API est souhaité.

Utilisez SV_CHANGE pour activer ou désactiver le suivi pour APPC, en fonction du paramètre dt_set.
Utilisez SV_IGNORE afin de conserver le suivi dans son état actuel pour APPC.

ehllapi
Un champ réservé.

x25_api
Un champ réservé.

x25_dlc
Un champ réservé.

twinax
Un champ réservé.

reserv6
Un champ réservé.

lua_api
Un champ réservé.

etherand
Un champ réservé.

subsym
Un champ réservé.

reserv7
Un champ réservé.

reset_trc
Paramètre fourni. Indique si le pointeur du fichier de trace doit être réinitialisé.

Utilisez SV_NO pour ne pas réinitialiser le pointeur du fichier de trace au début de ce fichier. Les enregistrements de suivi précédents ne sont pas remplacés.
Utilisez SV_YES pour réinitialiser le pointeur du fichier de trace au début de ce fichier. Les enregistrements de suivi précédents sont remplacés.

trunc
Paramètre fourni. Spécifie le nombre maximal d’octets pour chaque enregistrement de suivi. Les octets excédentaires sont tronqués. Définissez cette valeur sur zéro si vous ne souhaitez aucune troncation.

strg_size
Un champ réservé.

reserv8
Un champ réservé.

phys_link
Un champ réservé.

reserv9
Un champ réservé.

Codes de retour

SV_OK
Code de retour principal ; le verbe s’est exécuté correctement.

SV_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas été exécuté en raison d’une erreur de paramètre.

SV_INVALID_RESET_TRACE
Code de retour secondaire ; le paramètre reset_trc contient une valeur non valide.

SV_INVALID_SET
Code de retour secondaire ; le paramètre dt_set contient une valeur non valide.

SV_STATE_CHECK
Code de retour principal ; le verbe n’a pas été exécuté, car il a été émis dans un état non valide.

SV_COPY_TRACE_IN_PROGRESS
Code de retour secondaire ; un paramètre COPY_TRACE_TO_FILE précédemment émis est toujours en cours. Les traces ne peuvent pas être actives lors de l’utilisation de DEFINE_TRACE.

SV_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; un composant requis n’a pas pu être chargé ou arrêté lors du traitement du verbe. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour résoudre le problème.

SV_INVALID_VERB
Code de retour principal ; le paramètre opcode ne correspondait pas au code d’opération d’un verbe. Aucun verbe n’est exécuté.

SV_INVALID_VERB_SEGMENT
Code de retour principal : le VCB s’étend au-delà de la fin du segment de données.

SV_UNEXPECTED_DOS_ERROR
Code de retour principal ; l’une des conditions suivantes s’est produite :

Le système Microsoft® Windows® a rencontré une erreur lors du traitement du verbe. Le code de retour du système d’exploitation a été retourné via le code de retour secondaire. Si le problème persiste, contactez l’administrateur système pour résoudre le problème.
Un fichier CSV a été émis à partir d’une boucle de message appelée par une autre application émettant un appel de fonction Windows SendMessage, plutôt que l’appel de fonction Windows PostMessage le plus courant. Le traitement du verbe ne peut pas avoir lieu.
Un fichier CSV a été émis lorsque SendMessage a appelé votre application. Vous pouvez déterminer si votre application a été appelée avec SendMessage à l’aide de l’appel de fonction API Windows InSendMessage.

Notes

Pour plus d’informations sur l’exécution et l’utilisation des traces, consultez le manuel correspondant à votre produit.

Partager via

DEFINE_TRACE

Syntaxe

Membres

Codes de retour

Notes

Ressources supplémentaires