TRANSFER_MS_DATA

Le verbe TRANSFER_MS_DATA génère une unité de requête SNA contenant des données NMVT (Network Management Vector Transport). Le verbe peut envoyer les données NMVT à NetView pour le diagnostic et la résolution des problèmes centralisés. Les données sont consignées dans le fichier d’audit local.

La structure suivante décrit le bloc de contrôle de verbe (VCB) utilisé par le verbe TRANSFER_MS_DATA .

Syntaxe

  
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;  
};  

Membres

Opcode
Paramètre fourni. Verbe identifiant le code d’opération, SV_TRANSFER_MS_DATA.

data_type
Paramètre fourni. Spécifie le type de données fournies par ce verbe :

• Utilisez SV_NMVT pour générer un NMVT (y compris l’en-tête NS, le vecteur de gestion réseau principal et les sous-vecteurs).

• Utilisez SV_ALERT_SUBVECTORS pour générer une RU contenant des données pour une alerte au format approprié, sans l’en-tête NS ou le vecteur NMVT principal.

• Utilisez SV_PDSTATS_SUBVECTORS pour générer une RU contenant des données pour les statistiques de détermination des problèmes au format approprié, sans l’en-tête NS ou le vecteur NMVT principal.

• Utilisez SV_USER_DEFINED pour générer des données définies par l’utilisateur ; ces données sont enregistrées dans le journal des erreurs, mais ne peuvent pas être envoyées sur la session point physique point de contrôle des services système (SSCP-PU) sur la connexion configurée pour les diagnostics.

  réserver2
  Champ réservé.

  primary_rc
  Paramètre retourné. Spécifie le code de retour principal défini par APPC à l’achèvement du verbe. Les codes de retour valides varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

  secondary_rc
  Paramètre retourné. Spécifie le code de retour secondaire défini par APPC à l’achèvement du verbe. Les codes de retour valides varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

  Options
  Paramètre fourni. Spécifie les options souhaitées en activant ou désactivant des bits individuels. (Les bits 1, 2 et 3 sont ignorés si data_type est défini sur SV_USER_DEFINED .) Consultez la section Remarques.

  réserver3
  Champ réservé.

  origntr_id
  Paramètre fourni. Spécifie le nom du composant qui émet TRANSFER_MS_DATA. Ce paramètre est facultatif. Définissez-le sur 0x00 si vous souhaitez que le système l’ignore.

  dlen
  Paramètre fourni. Spécifie la longueur des données à fournir à ce verbe. La longueur totale des données (données fournies par l’utilisateur et tous les en-têtes ou sous-vecteurs ajoutés) doit s’adapter à une unité de requête. La longueur maximale des RU est de 512 octets.

  dptr
  Paramètre fourni. Spécifie l’adresse des données à envoyer.

Codes de retour

SV_OK
Code de retour principal ; le verbe exécuté avec succès.

SV_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas été exécuté en raison d’une erreur de paramètre.

SV_DATA_EXCEEDS_RU_SIZE

Code de retour secondaire ; les données à envoyer étaient trop longues. La longueur des données fournies par l’utilisateur ainsi que les en-têtes et les sous-vecteurs ajoutés doivent correspondre à une seule RU qui ne dépasse pas 512 octets.

SV_INVALID_DATA_SEGMENT

Code de retour secondaire ; la mémoire tampon pointée par dptr n’était pas un segment lisible ou étendu au-delà de la limite du segment.

SV_INVALID_DATA_TYPE

Code de retour secondaire ; le paramètre data_type contenait une valeur non valide.

SV_STATE_CHECK
Code de retour principal ; le verbe n’a pas exécuté, car il a été émis dans un état non valide.

SV_SSCP_PU_SESSION_NOT_ACTIVE

Code de retour secondaire ; le NMVT n’a pas été envoyé ; soit la session SSCP-PU n’était pas active, le nœud configuré pour recevoir les informations de diagnostic n’était pas actif ou aucune connexion de gestion réseau n’a été configurée.

SV_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; un composant requis n’a pas pu être chargé ou arrêté lors du traitement du verbe. Ainsi, la communication n’a pas pu avoir lieu. Contactez l’administrateur système pour obtenir une action corrective.

SV_INVALID_VERB
Code de retour principal ; le paramètre opcode ne correspond pas au code d’opération d’un verbe. Aucun verbe exécuté.

SV_INVALID_VERB_SEGMENT
Code de retour principal ; le VCB s’étend au-delà de la fin du segment de données.

SV_UNEXPECTED_DOS_ERROR
Code de retour principal ; l’une des conditions suivantes s’est produite :

• Le système d’exploitation Microsoft Windows a rencontré une erreur lors du traitement du verbe. Le code de retour du système d’exploitation a été retourné via le code de retour secondaire. Si le problème persiste, contactez l’administrateur système pour obtenir une action corrective.

• Un csv a été émis à partir d’une boucle de message appelée par une autre application qui émet un appel de fonction Windows SendMessage , plutôt que l’appel de fonction Windows PostMessage plus courant. Le traitement des verbes ne peut pas avoir lieu.

• Un csv a été émis lorsque SendMessage a appelé votre application. Vous pouvez déterminer si votre application a été appelée avec SendMessage à l’aide de l’appel de fonction API Windows InSendMessage .

  SV_CANCELLED
  Code de retour principal ; ce code est retourné pour un verbe asynchrone lorsqu’il a été arrêté par un appel WinCSVCleanup .

  SV_SERVER_RESOURCE_NOT_FOUND
  Code de retour principal ; aucun serveur de communication n’a été trouvé qui pouvait fournir la fonction demandée.

  SV_SERVER_RESOURCES_LOST
  Code de retour principal ; le serveur de communications qui fournissait la fonction a été perdu en raison d’une défaillance de connexion.

  SV_SERVER_CONN_FAILURE

  Code de retour secondaire ; la connexion au serveur a été perdue en raison de problèmes de chemin d’accès physique ; par exemple, le serveur a peut-être été éteint.

  SV_THREAD_BLOCKING
  Code de retour principal ; ce verbe dépasse le nombre maximal de verbes synchrones simultanés autorisés.

Remarques

Pour spécifier des options, activez ou désactivez les bits comme suit :