TRANSFER_MS_DATA

Article
07/21/2023

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 un diagnostic et une résolution centralisés des problèmes. Les données sont enregistré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 fourni 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 dans le 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 SSCP-PU (Control Point Physical Unit) des services systèmes sur la connexion configurée pour diagnostics.

reserv2
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 dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

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 dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

options
Paramètre fourni. Spécifie les options souhaitées en activant ou en 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.

reserv3
Un champ réservé.

origntr_id
Paramètre fourni. Spécifie le nom du composant émetteur 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 tenir dans une seule RU. La longueur maximale de la RU est de 512 octets.

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

Codes de retour

SV_OK
Code de retour principal ; le verbe s’est exécuté correctement.

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 des en-têtes et des sous-vecteurs ajoutés doit tenir dans une seule RU qui ne dépasse pas 512 octets.

SV_INVALID_DATA_SEGMENT

Code de retour secondaire ; la mémoire tampon pointée vers dptr n’était pas un segment lisible ou étendue 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 été 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é ; 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. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour résoudre le problème.

SV_INVALID_VERB
Code de retour principal ; le paramètre opcode ne correspondait pas au code d’opération d’un verbe. Aucun verbe n’est 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 résoudre le problème.
Un fichier CSV a été émis à partir d’une boucle de message appelée par une autre application émettant un appel de fonction Windows SendMessage, plutôt que l’appel de fonction Windows PostMessage le plus courant. Le traitement du verbe ne peut pas avoir lieu.
Un fichier 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 pouvant fournir la fonction demandée n’a été trouvé.

SV_SERVER_RESOURCES_LOST
Code de retour principal ; le serveur de communication qui fournissait la fonction a été perdu en raison d’un échec de connexion.

SV_SERVER_CONN_FAILURE

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

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 :

bit	Description
0	TIME_STAMP_SUBVECTOR. Ajoute le sous-vecteur date/heure aux données. Les valeurs autorisées incluent SV_ADD et SV_NO_ADD.
1	PRODUCT_SET_ID_SUBVECTOR. Ajoute Product_Set_ID sous-vecteur aux données. Cela permet aux services de gestion réseau d’identifier l’expéditeur d’une alerte. Les valeurs autorisées incluent SV_ADD et SV_NO_ADD.
2	SSCP_PU_SESSION. Envoie les données de la session SSCP-PU sur la connexion configurée pour diagnostics si la session est active. (Les données sont ajoutées au journal des erreurs, qu’elles soient envoyées sur la session ou que SV_STATE_CHECK ou SV_COMM_SUBSYSTEM_NOT_LOADED soient retournées.) Les valeurs autorisées incluent SV_SEND et SV_NO_SEND.
3	LOCAL_LOGGING. Consigne les alertes locales qui sont récupérées à partir du journal des erreurs et transmises à l’hôte. Cette option n’est valide que lorsque data_type SV_NMVT ou data_type SV_ALERT_SUBVECTORS avec l’option SV_SEND est spécifiée. Les valeurs autorisées incluent SV_LOG et SV_NO_LOG.
4 à 7	Réservé

TRANSFER_MS_DATA

Syntaxe

Membres

Codes de retour

Remarques

Ressources supplémentaires