COPY_TRACE_TO_FILE

El verbo COPY_TRACE_TO_FILE concatena archivos de seguimiento del servicio de vínculo/API individuales para formar un archivo único.

En la estructura siguiente se describe el bloque de control de verbo (VCB) que el verbo COPY_TRACE_TO_FILE utiliza.

Sintaxis

struct copy_trace_to_file {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        reserv3[8];  
    unsigned char        file_name[64];  
    unsigned char        file_option;  
    unsigned char        reserv4[12];  
};   

Miembros

opcode
Parámetro proporcionado. Verbo que identifica el código de operación, SV_COPY_TRACE_TO_FILE.

opext
Campo reservado.

reserv2
Campo reservado.

primary_rc
Parámetro devuelto. Especifica el código de retorno principal que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.

secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.

reserv3
Campo reservado.

file_name
Parámetro proporcionado. Especifica el nombre del archivo en el que se copiarán los datos de seguimiento. Este parámetro es una cadena de caracteres de 64 bytes y puede incluir una ruta de acceso. Si el nombre tiene menos de 64 bytes, use espacios a la derecha como relleno.

file_option
Parámetro proporcionado. Especifica la opción de copia del archivo de salida:

• Use SV_NEW para copiar el seguimiento solo si el archivo especificado todavía no existe.

• Use SV_OVERWRITE para copiar el seguimiento en un archivo existente y sobrescribir los datos actuales. Si es necesario, se aumenta el tamaño del archivo y el archivo se crea si todavía no existe.

reserv4
Dirección en la que residen los datos proporcionados.

Códigos de retorno

SV_OK
Código de retorno principal; el verbo se ha ejecutado correctamente.

SV_PARAMETER_CHECK
Código de retorno principal; el verbo no se ejecutó debido a un error de parámetro.

SV_INVALID_FILE_OPTION
Código de retorno secundario; se especificó un valor distinto de SV_NEW o SV_OVERWRITE para file_option.

SV_STATE_CHECK
Código de retorno principal; el verbo no se ejecutó porque se emitió en un estado no válido.

SV_COPY_TRACE_IN_PROGRESS
Código de retorno secundario; hay un verbo COPY_TRACE_TO_FILE emitido anteriormente todavía en curso.

SV_TRACE_FILE_EMPTY
Código de retorno secundario; no hay datos en los archivos de seguimiento.

SV_TRACE_NOT_STOPPED
Código de retorno secundario; había un seguimiento en curso cuando se emitió el verbo.

SV_COMM_SUBSYSTEM_NOT_LOADED
Código de retorno principal; no se pudo cargar o finalizar un componente necesario durante el procesamiento del verbo. Por tanto, no se pudo establecer la comunicación. Consulte con el administrador del sistema para aplicar una acción correctiva.

SV_FILE_ALREADY_EXISTS
Código de retorno principal; cuando se usó la opción de archivo SV_NEW, el nombre del archivo especificado era el nombre de un archivo existente.

SV_INVALID_VERB
Código de retorno principal; el parámetro opcode no coincide con el código de operación de ningún verbo. No se ha ejecutado ningún verbo.

SV_INVALID_VERB_SEGMENT
Código de retorno principal; el bloque de control de verbo (VCB) se ha extendido más allá del final del segmento de datos.

SV_OUTPUT_DEVICE_FULL
Código de retorno principal; no hay espacio suficiente en el dispositivo donde reside el archivo de salida. Vuelva a intentar la operación después de liberar espacio en disco adicional.

SV_UNEXPECTED_DOS_ERROR
Código de retorno principal; se ha producido una de las condiciones siguientes:

• El sistema Microsoft Windows encontró un error al procesar el verbo. El código de retorno del sistema operativo se devolvió mediante el código de retorno secundario. Si el problema persiste, póngase en contacto con el administrador del sistema para aplicar una acción correctiva.

• Se emitió un CSV desde un bucle de mensajes invocado por otra aplicación que emite una llamada a la función SendMessage de Windows, en lugar de la llamada a la función PostMessage de Windows, más común. No se pueden procesar verbos.

• Se emitió un CSV cuando SendMessage invocó la aplicación. Para averiguar si la aplicación se invocó con SendMessage, use la llamada a la función de la API de Windows InSendMessage.

Comentarios

Hay dos archivos de seguimiento del servicio de vínculo/API. Los archivos se utilizan de manera alterna; el seguimiento cambia de un archivo al otro cuando uno está lleno (más de 250 000). Cuando se llama a COPY_TRACE_TO_FILE, se concatenan estos archivos de seguimiento y se copian en un archivo único, cuyo nombre se especifica como un parámetro de la llamada.

El seguimiento del servicio de vínculo/API se detiene antes de emitir el verbo y se reinicia una vez que se completa la copia. Los archivos de seguimiento se restablecen cuando este verbo se completa correctamente.