LUA_COMMON

La structure suivante répertorie les paramètres de structure de données courants utilisés par tous les verbes de l’application d’unité logique (LUA).

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

Remarques

Membres

lua_verb
Paramètre fourni. Contient le code verbe, LUA_VERB_RUI pour les verbes RUI (Request Unit Interface) ou LUA_VERB_SLI pour les verbes SLI (Session Level Interface). Pour ces deux macros, la valeur est 0x5200.

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 du verbe) à émettre, par exemple, LUA_OPCODE_RUI_BID pour le verbe RUI_BID .

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_OPEN et RUI_INIT nécessitent ce paramètre. Les autres verbes Windows LUA nécessitent 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
Spécifie le décalage entre le début du VCB et la liste d’extensions des bibliothèques de liens dynamiques fournies par l’utilisateur (DLL). Non utilisé par RUI dans Host Integration Server et doit être défini sur zéro.

lua_cobol_offset
Décalage de l’extension COBOL. Non utilisé par LUA dans Host Integration Server et doit être égal à zéro.

lua_sid
Paramètre fourni et retourné. 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
Spécifie la longueur de la mémoire tampon reçue pour RUI_READet SLI_RECEIVE. Pour les autres verbes RUI et SLI, il n’est pas utilisé et doit être défini sur zéro.

lua_data_length
Paramètre retourné. Spécifie la longueur des données retournées dans lua_peek_data pour le verbe RUI_BID .

lua_data_ptr
Pointeur vers la mémoire tampon fournie par l’application qui contient les données à envoyer pour SLI_SEND et RUI_WRITE ou qui recevra des données pour SLI_RECEIVE et RUI_READ. Pour les autres verbes RUI et SLI, ce paramètre n’est pas utilisé et doit être défini sur zéro.

lua_post_handle
Paramètre fourni. Utilisé sous Windows 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.

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

lua_th.flags_fid

Format de type d’identification 2, quatre bits.

lua_th.flags_mpf

Champ de mappage segmenté, deux bits.

lua_th.flags_odai

Indicateur d’assigneur de champ d’adresse d’origine -champ de destination (OAF-DAF), un bit.

lua_th.flags_efi

Indicateur de flux accéléré, un bit.

lua_th.daf

Champ d’adresse de destination (DAF), un caractère non signé.

lua_th.oaf

Champ d’adresse d’origine (OAF), un caractère non signé.

lua_th.snf

Champ numéro de séquence, char non signé[2].

lua_rh
Paramètre retourné. Contient l’en-tête de demande/réponse SNA (RH) du message envoyé ou reçu. Elle est définie pour la fonction d’écriture et retournée par les fonctions de lecture et d’offre.

lua_rh.rri

Indicateur de demande-réponse, un bit.

lua_rh.ruc

Catégorie ru, deux bits.

lua_rh.fi

Indicateur de format, un bit.

lua_rh.sdi

Indicateurs de données de sens inclus, un peu.

lua_rh.bci

Indicateur de chaîne de début, un peu.

lua_rh.eci

Indicateur de chaîne de fin, un peu.

lua_rh.dr1i

Indicateur 1 réponse définitive, un peu.

lua_rh.dr2i

Indicateur 2 réponse définitive, un peu.

lua_rh.ri

Indicateur de réponse d’exception (pour une demande) ou indicateur de type de réponse (pour une réponse), un bit.

lua_rh.qri

Indicateur de réponse mis en file d’attente, un bit.

lua_rh.pi

Indicateur de pacing, un peu.

lua_rh.bbi

Indicateur de crochet de début, un bit.

lua_rh.ebi

Indicateur de crochet de fin, un bit.

lua_rh.idc

Changer l’indicateur de direction, un peu.

lua_rh.csi

Indicateur de sélection de code, un bit.

lua_rh.edi

Indicateur de données chiffré, un bit.

lua_rh.pdi

Indicateur de données rembourré, un peu.

lua_flag1
Paramètre fourni. Contient une structure de données contenant des indicateurs pour les messages fournis par l’application. Ce paramètre est utilisé par RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE et SLI_SEND. Pour les autres verbes LUA, ce paramètre n’est pas utilisé et doit être défini sur zéro.

lua_flag1.bid_enable

Indicateur d’activation de l’offre, un peu.

lua_flag1.close_abend

Fermez l’indicateur immédiat, un peu.

lua_flag1.nowait

Pas d’attente pour l’indicateur de données, un bit.

lua_flag1.sscp_exp

Flux accéléré SSCP, un bit.

lua_flag1.sscp_norm

Flux normal SSCP, un bit.

lua_flag1.lu_exp

Flux accéléré lu, un peu.

lua_flag1.lu_norm

Flux normal lu, un peu.

lua_message_type
Spécifie le type des commandes et données SNA entrantes ou sortantes. Il s’agit d’un paramètre retourné pour RUI_INIT et SLI_OPEN et un paramètre fourni pour SLI_SEND. Pour les autres verbes LUA, cette variable n’est pas utilisée et doit être définie sur zéro.

Les valeurs possibles sont les suivantes :

LUA_MESSAGE_TYPE_LU_DATA

LUA_MESSAGE_TYPE_SSCP_DATA

LUA_MESSAGE_TYPE_BID

LUA_MESSAGE_TYPE_BIND

LUA_MESSAGE_TYPE_BIS

LUA_MESSAGE_TYPE_CANCEL

LUA_MESSAGE_TYPE_CHASE

LUA_MESSAGE_TYPE_CLEAR

LUA_MESSAGE_TYPE_CRV

LUA_MESSAGE_TYPE_LUSTAT_LU

LUA_MESSAGE_TYPE_LUSTAT_SSCP

LUA_MESSAGE_TYPE_QC

LUA_MESSAGE_TYPE_QEC

LUA_MESSAGE_TYPE_RELQ

LUA_MESSAGE_TYPE_RQR

LUA_MESSAGE_TYPE_RTR

LUA_MESSAGE_TYPE_SBI

LUA_MESSAGE_TYPE_SHUTD

LUA_MESSAGE_TYPE_SIGNAL

LUA_MESSAGE_TYPE_SDT

LUA_MESSAGE_TYPE_STSN

LUA_MESSAGE_TYPE_UNBIND

Le SLI reçoit et répond aux requêtes BIND, CRV et STSN via les routines d’extension d’interface LUA.

LU_DATA, LUSTAT_LU, LUSTAT_SSCP et SSCP_DATA ne sont pas des commandes SNA.

lua_flag2
Paramètre retourné. Contient des indicateurs pour les messages retournés par LUA. Ce paramètre est retourné par RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE et SLI_SEND. Pour les autres verbes LUA, ce paramètre n’est pas utilisé et doit être défini sur zéro.

lua_flag2.bid_enable

Indique que RUI_BID a été correctement réactivée si la valeur est 1.

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é 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
Paramètre fourni. Champ réservé utilisé par SLI_OPEN et RUI_INIT. Pour tous les autres verbes LUA, ce paramètre est réservé et doit être défini sur zéro.

lua_encr_decr_option
Champ pour les options de chiffrement. Sur RUI_INIT, seuls les éléments suivants sont pris en charge :

lua_encr_decr_option = 0
lua_encr_decr_option = 128

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

Last updated on 2025-06-05

Partager via

LUA_COMMON

Remarques

Membres

Ressources supplémentaires