SLI_BIND_ROUTINE

Article
07/21/2023

Le verbe SLI_BIND_ROUTINE avertit l’application d’application d’unité logique Microsoft® Windows® (LUA) qu’une requête BIND provient de l’hôte et permet à la routine fournie par l’utilisateur d’examiner la demande et de formuler une réponse.

La structure suivante décrit le membre LUA_COMMON du bloc de contrôle verbe (VCB) utilisé par SLI_BIND_ROUTINE.

Syntaxe

  
struct LUA_COMMON {  
    unsigned short    lua_verb;  
    unsigned short    lua_verb_length;  
    unsigned short    lua_prim_rc;  
    unsigned long     lua_sec_rc;  
    unsigned short    lua_opcode;  
    unsigned long     lua_correlator;  
    unsigned char     lua_luname[8];  
    unsigned short    lua_extension_list_offset;  
    unsigned short    lua_cobol_offset;  
    unsigned long     lua_sid;  
    unsigned short    lua_max_length;  
    unsigned short    lua_data_length;  
    char FAR *        lua_data_ptr;  
    unsigned long     lua_post_handle;  
    struct LUA_TH     lua_th;  
    struct LUA_RH     lua_rh;  
    struct LUA_FLAG1  lua_flag1;  
    unsigned char     lua_message_type;  
    struct LUA_FLAG2  lua_flag2;   
    unsigned char     lua_resv56[7];  
    unsigned char     lua_encr_decr_option;  
};

Membres

lua_verb
Paramètre fourni. Contient le code verbe, LUA_VERB_SLI pour les verbes SLI (Session Level Interface).

lua_verb_length
Paramètre fourni. Spécifie la longueur en octets du VCB LUA. Il doit contenir la longueur de l’enregistrement de verbe émis.

lua_prim_rc
Code de retour principal défini par LUA à la fin du verbe. Les codes de retour valides varient en fonction du verbe LUA émis.

lua_sec_rc
Code de retour secondaire défini par LUA à la fin du verbe. Les codes de retour valides varient en fonction du verbe LUA émis.

lua_opcode
Paramètre fourni. Contient le code de commande LUA (code d’opération de verbe) pour le verbe à émettre, LUA_OPCODE_SLI_BIND_ROUTINE.

lua_correlator
Paramètre fourni. Contient une valeur fournie par l’utilisateur qui lie le verbe à d’autres informations fournies par l’utilisateur. LUA n’utilise pas ou ne modifie pas ces informations. Ce paramètre est facultatif.

lua_luname
Paramètre fourni. Spécifie le nom ASCII de la lu locale utilisée par la session Windows LUA.

SLI_BIND_ROUTINE requiert ce paramètre uniquement si lua_sid est égal à zéro.

Ce paramètre est de huit octets, rempli à droite avec des espaces (0x20) si le nom est inférieur à huit caractères.

lua_extension_list_offset
Non utilisé par SLI_BIND_ROUTINE et doit être défini sur zéro.

lua_cobol_offset
Non utilisé par LUA dans Microsoft® Host Integration Server ou SNA Server et doit être égal à zéro.

lua_sid
Paramètre fourni. Spécifie l’identificateur de session et est retourné par SLI_OPEN et RUI_INIT. D’autres verbes utilisent ce paramètre pour identifier la session utilisée pour la commande . Si d’autres verbes utilisent le paramètre lua_luname pour identifier les sessions, définissez le paramètre lua_sid sur zéro.

lua_max_length
Non utilisé par SLI_BIND_ROUTINE et doit être défini sur zéro.

lua_data_length
Paramètre retourné. Spécifie la longueur des données d’unité de requête/réponse (RU) BIND retournées dans la mémoire tampon de données.

lua_data_ptr
Pour le SLI_BIND_ROUTINE ce paramètre contient l’adresse de la RU BIND.

lua_post_handle
Paramètre fourni. Utilisé sous Microsoft Windows Server si la notification asynchrone doit être effectuée par des événements. Cette variable contient le handle de l’événement à signaler ou un handle de fenêtre.

lua_th
Paramètre fourni. Contient l’en-tête de transmission SNA (TH) du message reçu. Différents sous-paramètres sont retournés pour les fonctions de lecture et d’enchère.

lua_rh
Paramètre fourni. Contient l’en-tête de requête/réponse SNA (RH) du message envoyé ou reçu.

lua_flag1
Paramètre fourni. Contient une structure de données contenant des indicateurs pour les messages fournis par l’application.

lua_message_type
Paramètre fourni. Spécifie le type de données SNA ou de commande envoyée à l’hôte.

lua_flag2
Paramètre retourné. Contient des indicateurs pour les messages retournés par LUA.

lua_flag2.async

Indique que le verbe d’interface LUA s’est terminé de manière asynchrone s’il est défini sur 1.

lua_flag2.sscp_exp

Indique le flux accéléré SSCP s’il est défini sur 1.

lua_flag2.sscp_norm

Indique le flux normal SSCP s’il est défini sur 1.

lua_flag2.lu_exp

Indique le flux accéléré de lu si la valeur est 1.

lua_flag2.lu_norm

Indique le flux normal de l’unité logique s’il est défini sur 1.

lua_resv56
Réservé et doivent être définis sur zéro.

lua_encr_decr_option
Non utilisé par SLI_BIND_ROUTINE et doit être défini sur zéro.

Codes de retour

LUA_OK
Code de retour principal ; indique que le verbe s’est exécuté correctement.

LUA_SEC_OK

Code de retour secondaire ; Aucune information supplémentaire n’existe pour LUA_OK.

LUA_NEGATIVE_RSP
Code de retour principal ; L’unité LUA a envoyé une réponse négative à un message reçu de l’unité logique primaire (PLU) car une erreur a été trouvée dans le message, ou l’application a répondu négativement à une chaîne pour laquelle la fin de la chaîne est arrivée.

Remarques

SLI_BIND_ROUTINE fournit un mécanisme permettant à l’application Windows LUA d’examiner les requêtes BIND reçues de l’hôte. Windows LUA utilise une bibliothèque de liens dynamiques (DLL) fournie par l’utilisateur pour informer l’application Windows LUA qu’une demande BIND a été reçue. La routine DLL fournie par l’utilisateur examine ensuite le contenu de bind et formule une réponse pour la demande.

Le nom de LA DLL de la routine est fourni en tant qu’extensions du SLI_OPEN verbes VCB. Le paramètre lua_extension_list_offset fournit le décalage entre le début du VCB et le prénom dans la liste d’extensions.

L’interface Windows LUA affecte de l’espace de stockage où le VCB est structuré. Le VCB de SLI_BIND_ROUTINE contient lua_th et lua_rh. L’adresse de la REQUÊTE BIND est spécifiée dans lua_data_ptr et la longueur de la RU est spécifiée dans lua_data_length.

Lorsque SLI_BIND_ROUTINE retourne à Windows LUA, le traitement de SLI_BIND_ROUTINE est terminé. La réponse BIND doit remplacer l’unité de requête BIND. Lorsque bind est accepté, le code de retour principal doit être défini sur LUA_OK. Si bind est rejeté, le code de retour principal doit être défini sur LUA_NEGATIVE_RSP et la mémoire tampon BIND contient le code de sens négatif. Le paramètre lua_data_ptr ne doit pas être modifié.

Si une réponse négative est retournée par SLI_BIND_ROUTINE, SLI_OPEN est annulée. La lua_prim_rc du SLI_OPEN est définie sur LUA_SESSION_FAILURE et la lua_sec_rc est définie sur LUA_NEG_RSP_FROM_BIND_ROUTINE.

Voir aussi

RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND