MC_RECEIVE_LOG_DATA

El verbo MC_RECEIVE_LOG_DATA permite al usuario registrarse para recibir los datos de registro asociados a un informe de error de encabezado de administración de funciones 7 (FMH7) entrante. El verbo pasa un búfer a APPC y los datos de registro recibidos se colocan en ese búfer. APPC sigue utilizando este búfer a medida que llegan los FMH7 sucesivos hasta que se le proporciona otro búfer (es decir, hasta que el programa de transacciones (TP) emite otro MC_RECEIVE_LOG_DATA especificando 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 MC_RECEIVE_LOG_DATA especificando un nuevo búfer o un búfer de longitud cero, o esperar hasta que la conversación haya finalizado 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 devuelve a cero. Es el TP el que comprueba el búfer cada vez que un código de retorno de un verbo de recepción indica que se ha recibido un error.

La siguiente estructura describe el bloque de control de verbo (VCB) utilizado por el verbo MC_RECEIVE_LOG_DATA verbo.

Sintaxis

  
struct mc_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_M_RECEIVE_LOG_DATA.

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

reserve1
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 se devuelve TP_STARTED en el TP invocando o mediante RECEIVE_ALLOCATE en el TP invocado.

conv_id
Parámetro proporcionado. Proporciona el identificador de conversación. El valor de este parámetro se devuelve MC_ALLOCATE en el TP invocando o mediante 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 está entre 0 y 65535. Tenga en cuenta que una longitud de cero aquí indica que se debe cancelar cualquier MC_RECEIVE_LOG_DATA verbo 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 TP asignado por APPC.