Condividi tramite

DEFINE_TRACE

  • Articolo

Il verbo DEFINE_TRACE abilita o disabilita la traccia per le API specificate e controlla la quantità di traccia.

Nella struttura seguente viene descritto il blocco di controllo verbo (VCB) utilizzato dal verbo DEFINE_TRACE .

Sintassi

  
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];  
};

Members

Opcode
Parametro fornito. Verbo che identifica il codice dell'operazione SV_DEFINE_TRACE.

opext
Un campo riservato.

reserv2
Un campo riservato.

Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

reserv3
Un campo riservato.

dt_set
Parametro fornito. Imposta lo stato di traccia.

  • Usare SV_ON per abilitare la traccia per una determinata API se il parametro relativo all'API (ad esempio appc o comm_serv) è impostato su SV_CHANGE.
  • Usare SV_OFF per disabilitare la traccia per una determinata API se il parametro relativo all'API è impostato su SV_CHANGE.

Appc
Parametro fornito. Indica se la traccia dell'APPC è desiderata.

  • Usare SV_CHANGE per abilitare o disabilitare la traccia per APPC, a seconda del parametro dt_set .
  • Usare SV_IGNORE per lasciare traccia nello stato corrente per APPC.

I valori consentiti attivano o disattivano bit 0; i bit da 1 a 7 sono riservati.

reserv4
Un campo riservato.

srpi
Parametro fornito. Indica se la traccia di SRPI è desiderata.

  • Usare SV_CHANGE per abilitare o disabilitare la traccia per APPC, a seconda del parametro dt_set .
  • Usare SV_IGNORE per lasciare traccia nello stato corrente per APPC.

Sdlc
Un campo riservato.

tkn_rng_dlc
Un campo riservato.

pcnet_dlc
Un campo riservato.

Dft
Un campo riservato.

acdi
Un campo riservato.

reserv5
Un campo riservato.

comm_serv
Parametro fornito. Indica se è necessario tracciare COMM_SERV_API.

  • Usare SV_CHANGE per abilitare o disabilitare la traccia per APPC, a seconda del parametro dt_set .
  • Usare SV_IGNORE per lasciare traccia nello stato corrente per APPC.

ehllapi
Un campo riservato.

x25_api
Un campo riservato.

x25_dlc
Un campo riservato.

twinax
Un campo riservato.

reserv6
Un campo riservato.

lua_api
Un campo riservato.

etherand
Un campo riservato.

sottosym
Un campo riservato.

reserv7
Un campo riservato.

reset_trc
Parametro fornito. Indica se il puntatore al file di traccia deve essere reimpostato.

  • Utilizzare SV_NO per non reimpostare il puntatore del file di traccia all'inizio del file di traccia. I record di traccia precedenti non vengono sovrascritti.
  • Usare SV_YES per reimpostare il puntatore del file di traccia all'inizio del file di traccia. I record di traccia precedenti vengono sovrascritti.

troncamento
Parametro fornito. Specifica il numero massimo di byte per ogni record di traccia. I byte in eccesso vengono troncati. Impostare questo valore su zero se non si vuole troncare.

strg_size
Un campo riservato.

reserv8
Un campo riservato.

phys_link
Un campo riservato.

reserv9
Un campo riservato.

Codici restituiti

SV_OK
Codice restituito primario; il verbo eseguito correttamente.

SV_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

SV_INVALID_RESET_TRACE
Codice restituito secondario; il parametro reset_trc contiene un valore non valido.

SV_INVALID_SET
Codice restituito secondario; il parametro dt_set contiene un valore non valido.

SV_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato emesso in uno stato non valido.

SV_COPY_TRACE_IN_PROGRESS
Codice restituito secondario; è ancora in corso un COPY_TRACE_TO_FILE emesso in precedenza. Le tracce non possono essere attive durante l'utilizzo di DEFINE_TRACE.

SV_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente richiesto durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva avvenire. Contattare l'amministratore di sistema per un'azione correttiva.

SV_INVALID_VERB
Codice restituito primario; il parametro opcode non corrisponde al codice dell'operazione di alcun verbo. Nessun verbo eseguito.

SV_INVALID_VERB_SEGMENT
Codice restituito primario; VCB si estende oltre la fine del segmento di dati.

SV_UNEXPECTED_DOS_ERROR
Codice restituito primario; si è verificata una delle condizioni seguenti:

  • Il sistema Microsoft® Windows® ha rilevato un errore durante l'elaborazione del verbo. Il codice restituito dal sistema operativo è stato restituito tramite il codice restituito secondario. Se il problema persiste, contattare l'amministratore di sistema per un'azione correttiva.
  • Un volume condiviso cluster è stato emesso da un ciclo di messaggi richiamato da un'altra applicazione che emette una chiamata di funzione SendMessage di Windows, anziché dalla chiamata di funzione PostMessage di Windows più comune. L'elaborazione dei verbi non può essere eseguita.
  • È stato generato un file CSV quando SendMessage ha richiamato l'applicazione. È possibile determinare se l'applicazione è stata richiamata con SendMessage usando la chiamata di funzione API Windows InSendMessage .

Commenti

Per informazioni su come eseguire e usare le tracce, vedere il manuale appropriato per il prodotto.