Compartir a través de

COPY_TRACE_TO_FILE

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

En la estructura siguiente se describe el bloque de control de verbos (VCB) usado por el verbo COPY_TRACE_TO_FILE .

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
Un campo reservado.

reserv2
Un campo reservado.

primary_rc
Parámetro devuelto. Especifica el código de retorno principal establecido por APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC emitido. Consulte Códigos de retorno para obtener códigos de error válidos para este verbo.

secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario establecido por APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC emitido. Consulte Códigos de retorno para obtener códigos de error válidos para este verbo.

reserv3
Un campo reservado.

file_name
Parámetro proporcionado. Especifica el nombre del archivo al que se van a copiar 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 es inferior a 64 bytes, use espacios para rellenarlo a la derecha.

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 aún no existe.

  • Use SV_OVERWRITE para copiar el seguimiento en un archivo existente y sobrescribir los datos actuales. Si es necesario, aumenta el tamaño del archivo; y el archivo se crea si aún 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 ejecutó 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; un verbo COPY_TRACE_TO_FILE emitido anteriormente todavía está 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; un seguimiento estaba en curso cuando se emitió el verbo.

SV_COMM_SUBSYSTEM_NOT_LOADED
Código de retorno principal; No se pudo cargar ni finalizar un componente necesario mientras se procesaba el verbo. Por lo tanto, no se pudo realizar la comunicación. Póngase en contacto con el administrador del sistema para obtener 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 de 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 ejecutó ningún verbo.

SV_INVALID_VERB_SEGMENT
Código de retorno principal; el VCB se extendió 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 produjo una de las condiciones siguientes:

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

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

  • Se emitió un CSV cuando SendMessage invocó la aplicación. Puede determinar si la aplicación se ha invocado con SendMessage mediante la llamada a la función api de Windows InSendMessage .

Observaciones

Hay dos archivos de seguimiento de API/link-service. Los archivos se usan alternativamente; el seguimiento cambia de un archivo a otro cuando un archivo está lleno (mayor que 250 000). Cuando se llama a COPY_TRACE_TO_FILE , estos archivos de seguimiento se concatenan y copian en un único archivo, el nombre de que se especifica como parámetro para la llamada.

El seguimiento de API/link-service se detiene antes de emitir el verbo y se reinicia una vez completada la copia. Los archivos de seguimiento se restablecen cuando este verbo se completa correctamente.

  • Last updated on