Compartir a través de

TRANSFER_MS_DATA

  • Artículo

El verbo TRANSFER_MS_DATA compila una unidad de solicitud SNA que contiene datos de transporte de vectores de administración de red (NMVT). El verbo puede enviar los datos de NMVT a NetView para el diagnóstico y la resolución centralizados de problemas. Los datos se registran en el archivo de auditoría local.

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

Sintaxis

  
struct transfer_ms_data {  
    unsigned short       opcode;  
    unsigned char        data_type;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        options;  
    unsigned char        reserv3;  
    unsigned char        origntr_id[8];  
    unsigned short       dlen;  
    unsigned char FAR *  dptr;  
};

Miembros

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

data_type
Parámetro proporcionado. Especifica el tipo de datos proporcionados por este verbo:

  • Use SV_NMVT para generar un NMVT (incluido el encabezado NS, el vector de administración de red principal y los subvectores).

  • Use SV_ALERT_SUBVECTORS para generar una RU que contenga datos para una alerta en el formato adecuado, sin el encabezado NS ni el vector nmVT principal.

  • Use SV_PDSTATS_SUBVECTORS para generar una RU que contenga datos para las estadísticas de determinación de problemas en el formato adecuado, sin el encabezado NS ni el vector NMVT principal.

  • Use SV_USER_DEFINED para generar datos definidos por el usuario; estos datos se registran en el registro de errores, pero no se pueden enviar en la sesión de unidad física de punto de control de sistemas (SSCP-PU) en la conexión configurada para diagnósticos.

    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.

    options
    Parámetro proporcionado. Especifica las opciones deseadas activando o desactivando bits individuales. (Los bits 1, 2 y 3 se omiten si data_type está establecido en SV_USER_DEFINED). Consulte la sección Comentarios.

    reserv3
    Campo reservado.

    origntr_id
    Parámetro proporcionado. Especifica el nombre del componente que emite TRANSFER_MS_DATA. Este parámetro es opcional. Establézcalo en 0x00 si desea que el sistema lo omita.

    dlen
    Parámetro proporcionado. Especifica la longitud de los datos que se van a proporcionar a este verbo. La longitud total de los datos (datos proporcionados por el usuario y los encabezados o subvectores agregados) debe caber en una RU. La longitud máxima de RU es de 512 bytes.

    dptr
    Parámetro proporcionado. Especifica la dirección de los datos que se van a enviar.

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 ha ejecutado debido a un error en un parámetro.

SV_DATA_EXCEEDS_RU_SIZE

Código de retorno secundario; los datos que se van a enviar eran demasiado largos. La longitud de los datos proporcionados por el usuario más los encabezados y los subvectores agregados deben caber en una sola RU que no tenga más de 512 bytes de longitud.

SV_INVALID_DATA_SEGMENT

Código de retorno secundario; el búfer al que apunta dptr no era un segmento legible ni se extendía más allá del límite del segmento.

SV_INVALID_DATA_TYPE

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

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

SV_SSCP_PU_SESSION_NOT_ACTIVE

Código de retorno secundario; el NMVT no se envió; la sesión de SSCP-PU no estaba activa, el nodo configurado para recibir información de diagnóstico no estaba activo o no se configuró ninguna conexión de administración de red.

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 al administrador del sistema para aplicar 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 ha ejecutado ningún verbo.

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

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

  • El sistema operativo 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.

    SV_CANCELLED
    Código de retorno principal; Este código se devuelve para un verbo asincrónico cuando se ha cerrado mediante una llamada a WinCSVCleanup .

    SV_SERVER_RESOURCE_NOT_FOUND
    Código de retorno principal; no se encontró ningún servidor de comunicación que pudiera proporcionar la función solicitada.

    SV_SERVER_RESOURCES_LOST
    Código de retorno principal; el servidor de comunicaciones que proporcionaba la función se perdió debido a un error de conexión.

    SV_SERVER_CONN_FAILURE

    Código de retorno secundario; se perdió la conexión al servidor debido a problemas de ruta de acceso física; por ejemplo, es posible que el servidor se haya apagado.

    SV_THREAD_BLOCKING
    Código de retorno principal; este verbo supera el número máximo de verbos sincrónicos simultáneos permitidos.

Comentarios

Para especificar opciones, active o desactive los bits de la siguiente manera:

bit Descripción
0 TIME_STAMP_SUBVECTOR. Agrega un subvector de fecha y hora a los datos. Los valores permitidos incluyen SV_ADD y SV_NO_ADD.
1 PRODUCT_SET_ID_SUBVECTOR. Agrega Product_Set_ID subvector a los datos. Esto permite a los servicios de administración de red identificar al remitente de una alerta. Los valores permitidos incluyen SV_ADD y SV_NO_ADD.
2 SSCP_PU_SESSION. Envía los datos de la sesión SSCP-PU en la conexión configurada para diagnósticos si la sesión está activa. (Los datos se agregan al registro de errores, independientemente de si se envían en la sesión o si se devuelven SV_STATE_CHECK o SV_COMM_SUBSYSTEM_NOT_LOADED). Los valores permitidos incluyen SV_SEND y SV_NO_SEND.
3 LOCAL_LOGGING. Registra las alertas locales que se recuperan del registro de errores y se reenvía al host. Esta opción solo es válida cuando se especifica data_type SV_NMVT o data_type SV_ALERT_SUBVECTORS con SV_SEND de opción. Los valores permitidos incluyen SV_LOG y SV_NO_LOG.
De 4 a 7 Reservado