RECEIVE_LOG_DATA

El verbo RECEIVE_LOG_DATA permite al usuario registrarse para recibir los datos de registro asociados a un informe de errores de encabezado de administración de funciones entrante 7 (FMH7). El verbo pasa un búfer a APPC y los datos de registro recibidos se colocan en ese búfer. APPC sigue usando este búfer cuando llegan fmH7 sucesivos hasta que se proporciona con otro (es decir, hasta que el programa de transacciones (TP) emite otro RECEIVE_LOG_DATA especificar un búfer diferente o ningún búfer en absoluto).

Tenga en cuenta que el propio TP es responsable de asignar y liberar el búfer. Después de pasar el búfer a APPC, el TP debe emitir otro RECEIVE_LOG_DATA especificar un nuevo búfer o un búfer de longitud cero, o esperar hasta que la conversación haya terminado antes de liberar el búfer original.

Cuando se recibe un FMH7, APPC copia cualquier flujo de datos general (GDS) del registro de errores asociado en el búfer. Si no hay ninguna variable de registro de errores asociada, el búfer se va a cero. Es hasta el TP para comprobar el búfer cada vez que un código de retorno de un verbo de recepción indica que se ha recibido un error.

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

Sintaxis

  
struct receive_log_data {  
    unsigned short      opcode;  
    unsigned char       opext;  
    unsigned char       reserv1;  
    unsigned short      primary_rc;  
    unsigned long       secondary_rc;  
    unsigned char       tp_id[8];  
    unsigned long       conv_id;  
    unsigned short      log_dlen;  
    unsigned char FAR * log_dptr;  
};   

Miembros

opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_B_RECEIVE_LOG_DATA.

opext
Parámetro proporcionado. Especifica la extensión de operación de verbo, AP_BASIC_CONVERSATION.

reserv1
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.

tp_id
Parámetro proporcionado. Identifica el TP local. El valor de este parámetro lo devuelve TP_STARTED en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

conv_id
Parámetro proporcionado. Proporciona el identificador de conversación. El valor de este parámetro lo devuelve ALLOCATE en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

log_dlen
Parámetro proporcionado. Especifica la longitud máxima de los datos de registro que APPC puede colocar en el búfer (es decir, el tamaño del búfer). El intervalo va de 0 a 65535. Tenga en cuenta que una longitud de cero aquí indica que se debe cancelar cualquier verbo de RECEIVE_LOG_DATA anterior.

log_dptr
Parámetro proporcionado. Especifica la dirección del búfer que APPC usará para almacenar los datos de registro.

Códigos de retorno

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

AP_PARAMETER_CHECK
Código de retorno principal; el verbo no se ha ejecutado debido a un error en un parámetro.

AP_BAD_CONV_ID

Código de retorno secundario; el valor de conv_id no coincide con un identificador de conversación asignado por APPC.

AP_BAD_TP_ID

Código de retorno secundario; el valor de tp_id no coincide con un identificador de TP asignado por APPC.