Compartir a través de

LOG_MESSAGE

Solo para el sistema operativo/2, el verbo LOG_MESSAGE registra un mensaje en el archivo de registro de errores y, opcionalmente, muestra el mensaje en la pantalla de los usuarios. Este verbo se incluye para la compatibilidad con las aplicaciones existentes.

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

Sintaxis

  
struct log_message {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned short       msg_num;  
    unsigned char        origntr_id[8];  
    unsigned char        msg_file_name[3];  
    unsigned char        msg_act;  
    unsigned short       msg_ins_len;  
    unsigned char FAR *  msg_ins_ptr;  
};

Miembros

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

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.

msg_num
Parámetro proporcionado. Especifica el número del mensaje en el archivo de mensajes especificado por msg_file_name.

origntr_id
Parámetro proporcionado. Especifica el nombre del componente que emite LOG_MESSAGE o una cadena proporcionada por el usuario de 8 bytes.

msg_file_name
Parámetro proporcionado. Especifica el nombre del archivo que contiene el mensaje que se va a registrar.

msg_act
Parámetro proporcionado. Especifica la acción que se va a realizar al procesar el mensaje:

  • Use SV_INTRV para registrar la intervención con un nivel de gravedad de 12 y mostrar el mensaje en la pantalla de los usuarios. El usuario debe presionar una tecla para quitar el mensaje de la pantalla.

  • Use SV_NO_INTRV para registrar la intervención con un nivel de gravedad de 12, pero no mostrar el mensaje.

msg_ins_len
Parámetro proporcionado. Especifica la longitud de los datos que se van a insertar en el mensaje. Establezca este parámetro en cero si no se va a insertar ningún dato.

msg_ins_ptr
Parámetro proporcionado. Especifica la dirección de los datos que se van a insertar en el mensaje.

Use este parámetro solo si msg_ins_len es mayor que cero.

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_DATA_SEGMENT
Código de retorno secundario; los datos que se van a insertar en el mensaje se extienden más allá del límite del segmento.

SV_INVALID_MESSAGE_ACTION
Código de retorno secundario; el parámetro msg_act contenía un valor no válido.

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_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_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

El valor de msg_file_name debe tener tres caracteres. Relleno con espacios si es necesario. El. La extensión MSG se agrega automáticamente.

La longitud total de msg_ins_len, incluida la información de encabezado (40 bytes), el texto del mensaje y los datos insertados, no debe superar los 256 bytes. Si la longitud es mayor que 256 bytes, el sistema de comunicación intentará registrar solo la información del encabezado y el texto insertado; el texto del mensaje se dejará fuera.

Al crear el archivo de mensaje de registro, puede especificar dónde se insertarán los datos adicionales en el mensaje. A continuación se proporciona más información.

Los datos de msg_ins_ptr constan de una serie de hasta nueve cadenas terminadas en NULL. (Dado que IBM OS/2 ES versión 1.0 solo admite tres cadenas de datos, puede limitar el texto insertado a tres cadenas para garantizar la compatibilidad).

Crear un archivo de mensaje

Si desea crear su propio archivo de mensaje, debe usar la utilidad MKMSGF.

Los tres primeros caracteres del número de mensaje deben coincidir con el nombre de tres caracteres del archivo de mensaje de registro. Estos tres caracteres también se declaran en la parte superior del archivo.

El sistema busca el archivo de mensaje de la siguiente manera:

  • Si usa su propio archivo de mensaje, el sistema supone que el archivo está en el mismo directorio que el archivo ejecutable de programas.

  • Si usa el archivo de mensaje predeterminado, COM. MSG, el sistema busca automáticamente el archivo, siempre que se cargue SnaBase para Microsoft Host Integration Server.

  • Si usa el archivo de mensaje predeterminado sin cargar el software mencionado anteriormente, el sistema espera que DPATH indique la ruta de acceso al archivo de mensaje. Esto solo se aplica a la versión 3 de Windows. Sistemas operativos x y OS/2.

  • Last updated on