SLI_BID
Le verbe SLI_BID avertit l’application SLI (Session Level Interface) qu’un message attend d’être lu à l’aide de SLI_RECEIVE. SLI_BID fournit également la status actuelle de la session à l’application d’unité logique Windows (LUA).
La structure suivante décrit le membre LUA_COMMON du bloc de contrôle de verbe (VCB) utilisé par SLI_BID.
La deuxième union de syntaxe décrit le membre LUA_SPECIFIC du VCB utilisé par SLI_BID. Les autres membres du syndicat sont omis pour des motifs de clarté.
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;
};
union LUA_SPECIFIC {
unsigned char lua_peek_data[12];
};
Membres
lua_verb
Paramètre fourni. Contient le code du verbe, LUA_VERB_SLI pour les verbes SLI.
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_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 ni ne modifie 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_BID nécessite ce paramètre uniquement si lua_sid est égal à zéro.
Ce paramètre a une longueur de huit octets, rembourré à droite avec des espaces (0x20) si le nom est inférieur à huit caractères.
lua_extension_list_offset
Non utilisé par SLI_BID et doit être défini sur zéro.
lua_cobol_offset
Non utilisé par LUA dans Microsoft® Host Integration 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_BID 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.
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. Non utilisé par d’autres verbes RUI et SLI et doit être défini sur zéro.
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.
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’enchère. Ses sous-paramètres sont les suivants :
lua_th.flags_fid
Format d’identification type 2, quatre bits.
lua_th.flags_mpf
Champ de mappage de segmentage, deux bits. Définit le type de segment de données. Les valeurs suivantes sont valides :
0x00 Segment moyen0x04 Dernier segment0x08 Premier segment0x0C segment Uniquement
lua_th.flags_odai
Indicateur de l’assigneur champ d’adresse d’origine-champ d’adresse 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), char non signé.
lua_th.snf
Champ de numéro de séquence, un caractère non signé[2].
lua_rh
Paramètre retourné. Contient l’en-tête de requête/réponse SNA (RH) du message envoyé ou reçu. Ses sous-paramètres sont les suivants :
lua_rh.rri
Indicateur de requête-réponse, un bit.
lua_rh.ruc
Catégorie d’unité de demande/réponse (RU), deux bits. Les valeurs suivantes sont valides :
LUA_RH_FMD (0x00) segment de données FMLUA_RH_NC (0x20) Contrôle réseauLUA_RH_DFC (0x40) Contrôlede flux de données LUA_RH_SC (0x60) Contrôle de session
lua_rh.fi
Indicateur de format, un bit.
lua_rh.sdi
Détecter l’indicateur de données incluses, un bit.
lua_rh.bci
Indicateur de chaîne de début, un bit.
lua_rh.eci
Indicateur de chaîne de fin, un bit.
lua_rh.dr1i
Réponse définie 1 indicateur, un bit.
lua_rh.dr2i
Indicateur de réponse défini 2, un bit.
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 rythme, un bit.
lua_rh.bbi
Début de l’indicateur de crochet, un bit.
lua_rh.ebi
Indicateur de crochet de fin, un bit.
lua_rh.cdi
Changer l’indicateur de direction, un bit.
lua_rh.csi
Indicateur de sélection de code, un bit.
lua_rh.edi
Indicateur de données chiffrés, un bit.
lua_rh.pdi
Indicateur de données remplies, un bit.
lua_flag1
Paramètre fourni. Contient une structure de données contenant des indicateurs pour les messages fournis par l’application. Ses sous-paramètres sont les suivants :
lua_flag1.bid_enable
Indicateur d’activation de l’enchère, un bit.
lua_flag1.close_abend
Fermez l’indicateur immédiat, un bit.
lua_flag1.nowait
Pas d’attente pour l’indicateur de données, un bit.
lua_flag1.sscp_exp
Flux accéléré du point de contrôle des services système (SSCP), un bit.
lua_flag1.sscp_norm
Flux normal SSCP, un bit.
lua_flag1.lu_exp
Flux accéléré lu, un bit.
lua_flag1.lu_norm
Flux normal de l’unité logique, un bit.
lua_message_type
Paramètre retourné. Spécifie le type de message SNA indiqué à SLI_BID. Les valeurs possibles sont les suivantes :
LUA_MESSAGE_TYPE_LU_DATA
LUA_MESSAGE_TYPE_SSCP_DATA
LUA_MESSAGE_TYPE_RSP
LUA_MESSAGE_TYPE_BID
LUA_MESSAGE_TYPE_BIND
LUA_MESSAGE_TYPE_BIS
LUA_MESSAGE_TYPE_CANCEL
LUA_MESSAGE_TYPE_CHASE
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_RTR
LUA_MESSAGE_TYPE_SBI
LUA_MESSAGE_TYPE_SIGNAL
LUA_MESSAGE_TYPE_STSN
Le SLI reçoit et répond aux requêtes BIND 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. Ses sous-paramètres sont les suivants :
lua_flag2.bid_enable
Indique que SLI_BID a été correctement réactivé si la valeur est définie sur 1.
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_BID et doit être défini sur zéro.
lua_peek_data
Membre union de LUA_SPECIFIC utilisé par les verbes RUI_BIDet SLI_BID . Paramètre retourné. Contient jusqu’à 12 octets des données en attente de lecture.
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_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas été exécuté en raison d’une erreur de paramètre.
LUA_INVALID_LUNAME
Code de retour secondaire ; un nom de lua_luname non valide a été spécifié.
LUA_BAD_SESSION_ID
Code de retour secondaire ; une valeur non valide pour lua_sid a été spécifiée dans le VCB.
LUA_RESERVED_FIELD_NOT_ZERO
Code de retour secondaire ; Un paramètre réservé pour le verbe qui vient d’être émis n’est pas défini sur zéro.
LUA_INVALID_POST_HANDLE
Code de retour secondaire ; Pour un système d’exploitation Windows utilisant des événements comme méthode de publication asynchrone, le VCB Windows LUA ne contient pas de handle d’événement valide.
LUA_VERB_LENGTH_INVALID
Code de retour secondaire ; un verbe LUA a été émis avec la valeur de lua_verb_length inattendu par LUA.
LUA_STATE_CHECK
Code de retour principal ; le verbe n’a pas été exécuté, car il a été émis dans un état non valide.
LUA_NO_SLI_SESSION
Code de retour secondaire ; une session n’était pas ouverte ou était arrêtée en raison d’un SLI_CLOSE ou d’un échec de session lors de l’émission d’une commande.
LUA_SLI_BID_PENDING
Code de retour secondaire ; un verbe SLI était toujours actif lorsqu’un autre SLI_BID a été émis. Un seul SLI_BID peut être actif à la fois.
LUA_SESSION_FAILURE
Code de retour principal ; une condition d’erreur, spécifiée dans le code de retour secondaire, a provoqué l’échec de la session.
LUA_RECEIVED_UNBIND
Code de retour secondaire ; l’unité logique primaire (PLU) a envoyé une commande SNA UNBIND à l’interface LUA lorsqu’une session était active. Par conséquent, la session a été arrêtée.
LUA_SLI_LOGIC_ERROR
Code de retour secondaire ; L’interface LUA a détecté une erreur interne dans la logique.
LUA_NO_RUI_SESSION
Code de retour secondaire ; aucune session n’a été initialisée pour le verbe LUA émis, ou un verbe autre que SLI_OPEN a été émis avant l’initialisation de la session.
LUA_MODE_INCONSISTENCY
Code de retour secondaire ; l’exécution de cette fonction n’est pas autorisée par le status actuel. La demande envoyée au composant demi-session n’a pas été exécutée même si elle a été comprise et prise en charge. Ce code de sens SNA est également un code de sens de demande d’exception.
LUA_RECEIVER_IN_TRANSMIT_MODE
Code de retour secondaire ; les ressources nécessaires pour gérer les données de flux normaux n’étaient pas disponibles ou l’état de la contention semi-duplex n’a pas été reçu lorsqu’une demande de flux normal a été reçue. Le résultat est une condition de course. Ce code de sens SNA est également un code de sens de demande d’exception.
LUA_LU_COMPONENT_DISCONNECTED
Code de retour secondaire ; un composant LU n’est pas disponible, car il n’est pas correctement connecté. Assurez-vous que l’alimentation est activée.
LUA_FUNCTION_NOT_SUPPORTED
Code de retour secondaire ; LUA ne prend pas en charge la fonction demandée. Un caractère de contrôle, un paramètre RU ou un code de requête mis en forme peut avoir spécifié la fonction. Les informations de code de sens spécifique sont en octets 2 et 3.
LUA_CHAINING_ERROR
Code de retour secondaire ; la séquence des paramètres de l’indicateur de chaîne est en erreur. Un en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données des récepteurs a été trouvé. La remise au composant demi-session a été empêchée.
LUA_BRACKET
Code de retour secondaire ; l’expéditeur n’a pas pu appliquer les règles de crochet de session. Notez que les conditions de contention et de race sont exemptées de cette erreur. Un en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données des récepteurs a été trouvé. La remise au composant demi-session a été empêchée.
LUA_DIRECTION
Code de retour secondaire ; alors que l’état de retournement demi-duplex était NOT_RECEIVE, une demande de flux normal a été reçue. Un en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données des récepteurs a été trouvé. La remise au composant demi-session a été empêchée.
LUA_DATA_TRAFFIC_QUIESCED
Code de retour secondaire ; une demande de contrôle de flux de données (DFC) ou de données de gestion des fonctions (FMD) a été reçue d’une demi-session qui a envoyé une commande SHUTC ou QC, et la demande DFC ou FMD n’a pas répondu à une commande RELQ. Un en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données des récepteurs a été trouvé. La remise au composant demi-session a été empêchée.
LUA_NO_BEGIN_BRACKET
Code de retour secondaire ; le destinataire a déjà envoyé une réponse positive à une commande BIS lorsqu’une demande BID ou fmD spécifiant BBI=BB a été reçue. Un en-tête de requête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données reçu a été trouvé. La remise au composant demi-session a été empêchée.
LUA_IMMEDIATE_REQUEST_MODE_ERROR
Code de retour secondaire ; la requête a violé le protocole de mode de requête immédiate. Une demande d’en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données reçu a été trouvée. La remise au composant demi-session a été empêchée.
LUA_QUEUED_RESPONSE_ERROR
Code de retour secondaire ; la requête a violé le protocole de réponse mis en file d’attente. Une demande d’en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données reçu a été trouvée. La remise au composant demi-session a été empêchée.
LUA_ERP_SYNC_EVENT_ERROR
Code de retour secondaire ; une violation du protocole d’événements synchrones ERP s’est produite. Une demande d’en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données reçu a été trouvée. La remise au composant demi-session a été empêchée.
LUA_RSP_CORRELATION_ERROR
Code de retour secondaire ; une réponse a été envoyée qui ne correspond pas à une demande reçue précédemment ou une réponse qui ne correspond pas à une demande précédemment envoyée.
LUA_RSP_PROTOCOL_ERROR
Code de retour secondaire ; une violation du protocole de réponse a été trouvée dans la réponse reçue de la demi-session principale.
LUA_BB_NOT_ALLOWED
Code de retour secondaire ; l’indicateur de crochet de début n’a pas été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_EB_NOT AUTORISÉ
Code de retour secondaire ; l’indicateur de crochet de fin n’a pas été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_EXCEPTION_RSP_NOT_ALLOWED
Code de retour secondaire ; lorsqu’une réponse d’exception n’était pas autorisée, une réponse a été demandée. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_DEFINITE_RSP_NOT_ALLOWED
Code de retour secondaire ; lorsqu’une réponse définitive n’était pas autorisée, on en demandait une. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_CD_NOT_ALLOWED
Code de retour secondaire ; l’indicateur de direction des modifications n’a pas été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_NO_RESPONSE_NOT_ALLOWED
Code de retour secondaire ; une requête autre qu’un EXR contenait une « NO RESPONSE » Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de requête. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_CHAINING_NOT_SUPPORTED
Code de retour secondaire ; les indicateurs de chaînage n’ont pas été spécifiés de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_BRACKETS_NOT_SUPPORTED
Code de retour secondaire ; les indicateurs de crochet ont été spécifiés de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_CD_NOT_SUPPORTED
Code de retour secondaire ; L’indicateur de direction du changement a été défini, mais LUA ne prend pas en charge la direction du changement pour cette situation. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_USE_OF_FI
Code de retour secondaire ; l’indicateur de format a été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_ALTERNATE_CODE_NOT_SUPPORTED
Code de retour secondaire ; L’indicateur de sélection de code a été défini, mais LUA ne prend pas en charge la sélection de code pour cette session. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_RU_CATEGORY
Code de retour secondaire ; l’indicateur de catégorie d’unité de requête a été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_REQUEST_CODE
Code de retour secondaire ; le code de la demande a été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_SPEC_OF_SDI_RTI
Code de retour secondaire ; L’indicateur sense-data-included (SDI) et l’indicateur de type réponse (RTI) n’ont pas été spécifiés correctement sur une réponse. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_DR1I_DR2I_ERI
Code de retour secondaire ; l’indicateur de réponse définie 1 (DR1I), l’indicateur de réponse définie 2 (DR2I) et l’indicateur de réponse aux exceptions (ERI) ont été spécifiés de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_USE_OF_QRI
Code de retour secondaire ; L’indicateur de réponse en file d’attente (QRI) a été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_USE_OF_EDI
Code de retour secondaire ; l’indicateur de données chiffrés (EDI) a été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_INCORRECT_USE_OF_PDI
Code de retour secondaire ; L’indicateur de données rembourrées (PDI) a été spécifié de manière incorrecte. Les options BIND choisies précédemment ou les règles architecturales ont été violées par les valeurs de paramètre d’en-tête de la demande. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état actuel de la session. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_UNSUCCESSFUL
Code de retour principal ; l’enregistrement de verbe fourni était valide, mais le verbe ne s’est pas terminé correctement.
LUA_VERB_RECORD_SPANS_SEGMENTS
Code de retour secondaire ; Le paramètre de longueur VCB LUA et le décalage du segment sont au-delà de la fin du segment.
LUA_NOT_ACTIVE
Code de retour secondaire ; LUA n’était pas actif dans Microsoft Host Integration Server lorsqu’un verbe LUA a été émis.
LUA_INVALID_PROCESS
Code de retour secondaire ; la session pour laquelle un verbe LUA a été émis n’est pas disponible, car un autre processus est propriétaire de la session.
LUA_LU_INOPERATIVE
Code de retour secondaire ; une erreur grave s’est produite lors de la tentative d’arrêt de la session. Cette lu n’est pas disponible pour toutes les demandes LUA tant qu’une unité logique d’activation (ACTLU) n’est pas reçue de l’hôte.
LUA_RECEIVE_CORRELATION_TABLE_FULL
Code de retour secondaire ; la table de corrélation de réception de la session pour le flux demandé a atteint sa capacité.
LUA_NEGATIVE_RESPONSE
Code de retour principal ; 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.
LUA_FUNCTION_NOT_SUPPORTED
Code de retour secondaire ; LUA ne prend pas en charge la fonction demandée. Un caractère de contrôle, un paramètre RU ou un code de demande mis en forme peut avoir spécifié la fonction. Les informations de code de sens spécifique sont en octets 2 et 3.
LUA_DATA_TRAFFIC_RESET
Code de retour secondaire ; une demi-session d’une session active mais avec un trafic de données inactif a reçu une requête DFC ou FMD de flux normal. Un en-tête de requête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle de flux de données des récepteurs a été trouvé. La remise au composant demi-session a été empêchée.
LUA_DATA_TRAFFIC_NOT_RESET
Code de retour secondaire ; alors que l’état du trafic de données n’a pas été réinitialisé, la demande de contrôle de session a été reçue. Un en-tête de requête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données reçu a été trouvé. La remise au composant demi-session a été empêchée.
LUA_SC_PROTOCOL_VIOLATION
Code de retour secondaire ; une violation du protocole de contrôle de session (SC) s’est produite. Une demande (qui n’est autorisée qu’une fois qu’une demande SC et une réponse positive à cette demande ont été correctement échangées) a été reçue avant l’échange requis. L’octet 4 des données sense contient le code de requête. Il n’existe aucune donnée utilisateur pour ce code de sens. Une demande d’en-tête ou une unité de requête non valide pour le contrôle de session actuel ou l’état de contrôle du flux de données reçu a été trouvée. La remise au composant demi-session a été empêchée.
LUA_INVALID_SC_OR_NC_RH
Code de retour secondaire ; le RH d’une requête SC ou NC n’était pas valide.
LUA_PACING_NOT_SUPPORTED
Code de retour secondaire ; la demande contenait un indicateur de rythme lorsque la prise en charge du rythme pour cette session n’existe pas pour la demi-session ou la demi-session de la fonction de limite de réception. Les options BIND choisies précédemment ou les règles architecturales ont été violées par lua_rh valeurs. La remise au composant demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. L’échec de l’application des règles de session par les expéditeurs peut avoir provoqué les erreurs.
LUA_NAU_INOPERATIVE
Code de retour secondaire ; l’unité adressable réseau (NAU) n’est pas en mesure de traiter les réponses ou les demandes. La remise au destinataire n’a pas pu avoir lieu pour l’une des raisons suivantes :
Erreur d’unité d’informations de chemin d’accès
Une panne de chemin
Séquence non valide de demandes d’activation
Si une erreur de chemin d’accès est reçue pendant une session active, cela signifie généralement qu’il n’y a plus de chemin d’accès valide au partenaire de session.
LUA_CANCELED
Code de retour principal ; le code de retour secondaire indique la raison de l’annulation de la commande.
LUA_TERMINATED
Code de retour secondaire ; la session a été arrêtée lorsqu’un verbe était en attente. Le processus de verbe a été annulé.
LUA_IN_PROGRESS
Code de retour principal ; une commande asynchrone a été reçue, mais n’est pas terminée.
LUA_STATUS
Code de retour principal ; le code de retour secondaire contient SLI status informations pour l’application.
LUA_READY
Code de retour secondaire ; à la suite d’une NOT_READY status, cette status est émise pour vous informer que le SLI est prêt à traiter les commandes.
LUA_NOT_READY
Code de retour secondaire ; un type UNBIND SNA 0x02 commande a été reçu, ce qui signifie qu’un nouveau BIND arrive.
Si le type UNBIND 0x02 est reçu une fois la SLI_OPEN de début terminée, la session est suspendue jusqu’à ce qu’un bind, un CRV et un STSN facultatifs soient reçus, et que des flux SDT soient reçus. Ces routines sont de nouveau réinscrites parce qu’elles doivent être appelées à nouveau. La session reprend une fois que le SLI a traité la commande SDT.
Si le type UNBIND 0x02 est reçu alors que SLI_OPEN est en cours de traitement, le code de retour principal est un échec de session et non status. Ou bien, la réception d’une SNA CLEAR a provoqué la suspension. La réception d’un SNA SDT entraîne la reprise de la session.
LUA_INIT_COMPLETE
Code de retour secondaire ; l’interface LUA a initialisé la session pendant le traitement de SLI_OPEN . Les applications LUA qui émettent des SLI_OPEN avec le paramètre lua_open_type_prim_sscp reçoivent ce status sur SLI_RECEIVE ou SLI_BID.
LUA_SESSION_END_REQUESTED
Code de retour secondaire ; L’interface LUA a reçu une commande d’arrêt SNA (SHUTD) de l’hôte, ce qui signifie que l’hôte est prêt à arrêter la session.
LUA_COMM_SUBSYSTEM_ABENDED
Code de retour principal ; indique l’une des situations suivantes :
Le nœud utilisé par cette conversation a rencontré un abandon (ABEND).
La connexion entre le programme de transaction (TP) et le nœud d’unité physique (PU) 2.1 a été rompue (erreur LAN).
Le SnaBase sur l’ordinateur des fournisseurs de services a rencontré un ABEND.
LUA_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; indique qu’il n’a pas été possible de charger un composant requis ou d’y mettre fin lors du traitement du verbe. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour mettre en place une action corrective.
LUA_INVALID_VERB_SEGMENT
Code de retour principal ; indique que le bloc de contrôle de verbe s’étend au-delà de la fin du segment de données.
LUA_UNEXPECTED_DOS_ERROR
Code de retour principal ; après l’émission d’un appel de système d’exploitation, un code de retour inattendu du système d’exploitation a été reçu et est spécifié dans le code de retour secondaire.
LUA_STACK_TOO_SMALL
Code de retour principal ; indique que la taille de la pile de l’application est trop petite pour exécuter le verbe. Augmentez la taille de pile de votre application.
LUA_INVALID_VERB
Code de retour principal ; le code du verbe ou le code d’opération, ou les deux, n’est pas valide. Le verbe n’a pas été exécuté.
Remarques
SLI_BID effectue les opérations suivantes :
Avertit une application Windows LUA qu’un message attend d’être lu.
Fournit la status de session actuelle.
Fournit un aperçu du message suivant qui sera lu par SLI_RECEIVE.
Cette préversion contient un maximum de 12 octets d’informations (données d’aperçu) qui permettent à l’application Windows LUA de définir sa stratégie de traitement des données.
Pour utiliser SLI_BID dans une application Windows LUA, SLI_BID de problème. Une fois le verbe terminé, il peut être réactivé de deux manières :
Réédition SLI_BID.
Problème SLI_RECEIVE avec lua_flag1_bid_enable défini sur 1. Cela émet un SLI_BID qui utilise l’adresse la plus récente acceptée pour le VCB et établit l’offre active.
Chaque session ne peut avoir qu’une seule SLI_BID à la fois.
Si plusieurs messages sont disponibles lorsqu’une application Windows LUA rencontre des problèmes SLI_BID, le flux de données avec la priorité la plus élevée est retourné. L’ordre dans lequel les données peuvent être retournées est le suivant :
SSCP accéléré
LU accélérée
SSCP normal
LU normal
Si SLI_RECEIVE a des indicateurs définis pour lire plusieurs types de flux de messages, les données retournées par SLI_BID peuvent concerner un flux différent de celui pour lequel vous recevez réellement des données via SLI_RECEIVE. Cette situation se produit lorsque des données de priorité supérieure arrivent de l’hôte après SLI_BID fin du traitement, mais avant l’émission de SLI_RECEIVE .
Pour vous assurer que SLI_RECEIVE lit les données, le SLI_BID retourné spécifie le flux qui correspond aux lua_flag2 retournés par le SLI_BID terminé.
Valeurs de retour d’état de session
Si LUA_STATUS est le code de retour principal, le code de retour secondaire peut être LUA_READY, LUA_NOT_READY, LUA_SESSION_END_REQUESTED ou LUA_INIT_COMPLETE. En outre, si LUA_STATUS est le code de retour principal, les paramètres suivants sont utilisés :
lua_sec_rc
lua_sid
LUA_READY est retourné après LUA_NOT_READY status et indique que le SLI est à nouveau prêt à exécuter toutes les commandes.
LUA_NOT_READY indique que la session SLI est suspendue, car le SLI a reçu une commande SNA CLEAR ou une commande UNBIND SNA avec un 0x02 type UNBIND (UNBIND avec bind à venir). Selon la cause de la suspension, la session peut être réactivée comme suit :
Lorsque la suspension est provoquée par un SNA CLEAR, la réception d’un SNA SDT réactive la session.
Lorsqu’une liaison de type UNBIND SNA entraîne la suspension de la session et que le SLI_OPEN qui a ouvert la session est terminé, la session est suspendue jusqu’à ce que le SLI reçoive une commande BIND et SDT. La session peut également recevoir éventuellement une commande STSN. Par conséquent, les routines fournies par l’utilisateur émises avec le SLI_OPEN initial doivent être entrées de nouveau, car elles seront rappelées.
L’application peut envoyer des données SSCP après l’arrivée d’un bind de type CLEAR ou UNBIND et avant la lecture de l’status NOT READY. L’application peut envoyer et recevoir des données SSCP après la lecture d’un NOT READY.
Lorsqu’un bind de type UNBIND SNA arrive avant l’achèvement de la SLI_OPEN qui a ouvert la session, LUA_SESSION_FAILURE (et non LUA_STATUS) est le code de retour principal.
LUA_SESSION_END_REQUESTED indique que l’application a reçu un SNA SHUTD de l’hôte. L’application Windows LUA doit émettre des SLI_CLOSE pour fermer la session lorsque cela est pratique.
LUA_INIT_COMPLETE est retourné uniquement lorsque lua_init_type pour SLI_OPEN est LUA_INIT_TYPE_PRIM_SSCP. La status signifie que SLI_OPEN a été suffisamment traité pour permettre l’envoi ou la réception de données SSCP.
Demandes d’exception
Si une unité de requête d’application hôte est convertie en exr, les données de sens sont retournées. Lorsqu’une SLI_BID se termine avec les paramètres de verbe retournés définis comme indiqué, une conversion EXR se produit.
| Membre | Définir sur |
|---|---|
| lua_prim_rc | OK (0x0000) |
| lua_sec_rc | OK (0x00000000) |
| lua_rh.rri | bit off (unité de requête) |
| lua_rh.sdi | bit on (inclut les données de sens) |
Sur les sept octets de données dans lua_peek_data, les octets 0 à 3 définissent l’erreur détectée. Le tableau suivant indique les données de sens possibles et les valeurs des octets 0 à 3.
| Détecter les données | Valeur des octets 0 à 3 |
|---|---|
| LUA_MODE_INCONSISTENCY | 0x08090000 |
| LUA_BRACKET_RACE_ERROR | 0x080B0000 |
| LUA_BB_REJECT_NO_RTR | 0x08130000 |
| LUA_RECEIVER_IN_TRANSMIT_MODE | 0x081B0000 |
| LUA_CRYPTOGRAPHY_FUNCTION_INOP | 0x08480000 |
| LUA_SYNC_EVENT_RESPONSE | 0x10010000 |
| LUA_RU_DATA_ERROR | 0x10020000 |
| LUA_RU_LENGTH_ERROR | 0x10020000 |
| LUA_INCORRECT_SEQUENCE_NUMBER | 0x20010000 |
Les informations retournées aux octets 3 à 6 dans lua_peek_data sont déterminées par les 3 premiers octets de l’unité de requête initiale à l’origine de l’erreur.