TRANSFER_MS_DATA

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 un diagnóstico y 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 o 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 servicios de sistemas (SSCP-PU) en la conexión configurada para diagnósticos.

  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.

  Opciones
  Parámetro proporcionado. Especifica las opciones deseadas activando o desactivando los 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
  Un 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 ignore.

  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 ejecutó correctamente.

SV_PARAMETER_CHECK
Código de retorno principal; el verbo no se ejecutó debido a un error de 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 encabezados y subvectores agregados debe caber en una única 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; no se envió el NMVT; la sesión de SSCP-PU no estaba activa, el nodo configurado para recibir información de diagnóstico no estaba activa 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 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 operativo 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 .

  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; la conexión al servidor se perdió 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.

Observaciones

Para especificar opciones, active o desactive los bits como se indica a continuación: