SLI_STSN_ROUTINE

Le verbe SLI_STSN_ROUTINE informe l’application LUA (Microsoft® Windows® Logical Unit Application) qu’une commande STSN provient de l’hôte et permet à 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_STSN_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 à l’achèvement 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 à l’achèvement 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 verbe) pour que le verbe soit émis, LUA_OPCODE_SLI_STSN_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 l’unité logique locale utilisée par la session Windows LUA.

SLI_STSN_ROUTINE nécessite uniquement ce paramètre si lua_sid est égal à zéro.

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

lua_extension_list_offset
Non utilisé par SLI_STSN_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_STSN_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) STSN retournées dans la mémoire tampon de données.

lua_data_ptr
Pour le SLI_STSN_ROUTINE ce paramètre contient l’adresse de l’unité de requête STSN.

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

Pour tous les autres environnements, ce paramètre est réservé et doit être défini sur zéro.

lua_th
Paramètre retourné. 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’offre.

lua_rh
Paramètre retourné. Contient l’en-tête de demande/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 de l’interface LUA s’est terminé de façon asynchrone s’il est défini sur 1.

lua_flag2.sscp_exp

Indique le flux accéléré du point de contrôle des services système (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é lu s’il est défini sur 1.

lua_flag2.lu_norm

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

lua_resv56
Réservé et doit être défini sur zéro.

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

Codes de retour

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

LUA_SEC_OK

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

LUA_NEGATIVE_RSP
Code de retour principal ; soit 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, soit l’application a répondu négativement à une chaîne pour laquelle la fin de la chaîne est arrivée.

Remarques

SLI_STSN_ROUTINE fournit un mécanisme permettant à l’application Windows LUA d’examiner et de répondre aux commandes STSN. Windows LUA informe l’application Windows LUA qu’une commande STSN a été reçue de l’hôte. Cela s’effectue via une bibliothèque de liens dynamiques fournie par l’utilisateur (DLL). La DLL des utilisateurs examine la requête STSN et formule une réponse à la demande.

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

L’interface Windows LUA affecte de l’espace de stockage où le VCB est structuré. Le VCB du SLI_STSN_ROUTINE contient lua_th et lua_rh. L’adresse de l’unité de requête STSN est spécifiée dans lua_data_ptr et la longueur de l’unité de requête est spécifiée dans lua_data_length.

Lorsque SLI_STSN_ROUTINE retourne à l’UUA Windows, le traitement de l’SLI_STSN_ROUTINE est terminé. La réponse STSN doit remplacer l’unité de requête STSN. Lorsque le STSN est accepté, le code de retour principal doit être défini sur LUA_OK. Si le STSN est rejeté, le code de retour principal doit être défini sur LUA_NEGATIVE_RSP et la mémoire tampon STSN 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_STSN_ROUTINE, SLI_OPEN est annulée. La lua_prim_rc de la SLI_OPEN est définie sur LUA_SESSION_FAILURE et la lua_sec_rc est définie sur LUA_NEG_RSP_FROM_STSN_ROUTINE.

Voir aussi

RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND