Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le verbe SLI_BID informe l’application SLI (Session Level Interface) qu’un message attend la lecture à l’aide de SLI_RECEIVE. SLI_BID fournit également l’état actuel de la session à l’application d’unité logique Windows (LUA).
La structure suivante décrit le membre LUA_COMMON du bloc de contrôle verbe (VCB) utilisé par SLI_BID.
La deuxième union de syntaxe décrit le membre LUA_SPECIFIC du VCB utilisé par SLI_BID. D’autres membres de l’union sont omis pour plus 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 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 à 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 de verbe) pour que le verbe soit émis, 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 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_BID 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_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 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. Ses sous-paramètres sont les suivants :
lua_th.flags_fid
Format de type d’identification 2, quatre bits.
lua_th.flags_mpf
Champ de mappage segmenté, deux bits. Définit le type de segment de données. Les valeurs suivantes sont valides :
segment intermédiaire 0x00 segment0x04 Dernier segment0x08 premier segment0x0C uniquement
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. Ses sous-paramètres sont les suivants :
lua_rh.rri
Indicateur de demande-réponse, un bit.
lua_rh.ruc
Catégorie d’unité de requête/réponse (RU), deux bits. Les valeurs suivantes sont valides :
LUA_RH_FMD (0x00) contrôle de flux de données FMLUA_RH_NC (0x20) Contrôle réseauLUA_RH_DFC (0x40) Contrôle de flux de donnéesLUA_RH_SC (0x60) Contrôle de session
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. Ses sous-paramètres sont les suivants :
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é 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 peu.
lua_flag1.lu_norm
Flux normal lu, un peu.
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 de l’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ée s’il est défini sur 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
Réservé et doit être défini sur zéro.
lua_encr_decr_option
Non utilisé par SLI_BID et doit être défini sur zéro.
lua_peek_data
Membre de l’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 ; le verbe exécuté avec succès.
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 é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, windows LUA VCB ne contient pas de handle d’événements valide.
LUA_VERB_LENGTH_INVALID
Code de retour secondaire ; un verbe LUA a été émis avec la valeur de lua_verb_length inattendue par LUA.
LUA_STATE_CHECK
Code de retour principal ; le verbe n’a pas exécuté, car il a été émis dans un état non valide.
LUA_NO_SLI_SESSION
Code de retour secondaire ; une session n’a pas été ouverte ou a été arrêtée en raison d’un échec de SLI_CLOSE ou 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. Une seule SLI_BID peut être active à 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 principale (PLU) a envoyé une commande UNBIND SNA à 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 trouvé 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 l’état actuel. La demande envoyée au composant de 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 requête d’exception.
LUA_RECEIVER_IN_TRANSMIT_MODE
Code de retour secondaire ; les ressources nécessaires pour gérer les données de flux normales n’étaient pas disponibles ou l’état de la contention demi-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 requête d’exception.
LUA_LU_COMPONENT_DISCONNECTED
Code de retour secondaire ; un composant LU n’est pas disponible, car il n’est pas connecté correctement. Assurez-vous que la puissance 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 de 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 d’indicateur de chaîne est en erreur. Un en-tête de requête ou une unité de requête non valide pour les récepteurs du contrôle de session actuel ou de l’état de contrôle de flux de données a été trouvé. La remise au composant de demi-session a été empêchée.
LUA_BRACKET
Code de retour secondaire ; l’expéditeur n’a pas appliqué les règles de crochet de session. Notez que les conditions de contention et de concurrence sont exemptées de cette erreur. Un en-tête de requête ou une unité de requête non valide pour les récepteurs du contrôle de session actuel ou de l’état de contrôle de flux de données a été trouvé. La remise au composant de demi-session a été empêchée.
LUA_DIRECTION
Code de retour secondaire ; alors que l’état de flip-flop demi-duplex était NOT_RECEIVE, une demande de flux normal a été reçue. Un en-tête de requête ou une unité de requête non valide pour les récepteurs du contrôle de session actuel ou de l’état de contrôle de flux de données a été trouvé. La remise au composant de 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 gestion des fonctions (FMD) a été reçue à partir d’une demi-session qui a envoyé une commande SHUTC ou une commande QC, et la demande DFC ou FMD n’a pas répondu à une commande RELQ. Un en-tête de requête ou une unité de requête non valide pour les récepteurs du contrôle de session actuel ou de l’état de contrôle de flux de données a été trouvé. La remise au composant de demi-session a été empêchée.
LUA_NO_BEGIN_BRACKET
Code de retour secondaire ; le récepteur 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 demande ou une unité de requête non valide pour le contrôle de session actuel reçu ou l’état de contrôle de flux de données a été trouvé. La remise au composant de 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édiat. Une demande d’en-tête ou unité de requête non valide pour le contrôle de session actuel reçu ou l’état de contrôle de flux de données a été trouvé. La remise au composant de 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 unité de requête non valide pour le contrôle de session actuel reçu ou l’état de contrôle de flux de données a été trouvé. La remise au composant de demi-session a été empêchée.
LUA_ERP_SYNC_EVENT_ERROR
Code de retour secondaire ; une violation du protocole d’événement synchrone ERP s’est produite. Une demande d’en-tête ou unité de requête non valide pour le contrôle de session actuel reçu ou l’état de contrôle de flux de données a été trouvé. La remise au composant de 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 a été reçue qui ne correspond pas à une demande envoyée précédemment.
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 moitié de session principale.
LUA_BB_NOT_ALLOWED
Code de retour secondaire ; l’indicateur de crochet de début 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_EB_NOT AUTORISÉ
Code de retour secondaire ; l’indicateur de crochet de fin 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_EXCEPTION_RSP_NOT_ALLOWED
Code de retour secondaire ; lorsqu’une réponse d’exception n’a pas été 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_DEFINITE_RSP_NOT_ALLOWED
Code de retour secondaire ; lorsqu’une réponse définitive n’a pas été 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_CD_NOT_ALLOWED
Code de retour secondaire ; l’indicateur de direction de modification 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 étaient violées par les valeurs de paramètre d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_CHAINING_NOT_SUPPORTED
Code de retour secondaire ; les indicateurs de chaînage 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_CD_NOT_SUPPORTED
Code de retour secondaire ; l’indicateur de direction des changements 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_INCORRECT_REQUEST_CODE
Code de retour secondaire ; le code 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_INCORRECT_SPEC_OF_SDI_RTI
Code de retour secondaire ; l’indicateur SDI (sense-data-included) 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 d’exception (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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_INCORRECT_USE_OF_EDI
Code de retour secondaire ; l’indicateur de données chiffré (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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_INCORRECT_USE_OF_PDI
Code de retour secondaire ; l’indicateur de données rembourré (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 des paramètres d’en-tête de requête. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent avoir provoqué les erreurs.
LUA_UNSUCCESSFUL
Code de retour principal ; l’enregistrement de verbe fourni était valide, mais le verbe n’a pas réussi.
LUA_VERB_RECORD_SPANS_SEGMENTS
Code de retour secondaire ; le paramètre de longueur LUA VCB plus le décalage de segment est 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 possè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 requêtes LUA jusqu’à ce qu’une unité logique d’activation (ACTLU) soit reçue de l’hôte.
LUA_RECEIVE_CORRELATION_TABLE_FULL
Code de retour secondaire ; la table de corrélation de réception de 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 de 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_DATA_TRAFFIC_RESET
Code de retour secondaire ; une demi-session d’une session active, mais avec le trafic de données inactif a reçu une demande DFC ou FMD de flux normal. Un en-tête de requête ou une unité de requête non valide pour les récepteurs du contrôle de session actuel ou de l’état de contrôle de flux de données a été trouvé. La remise au composant de 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 demande ou une unité de requête non valide pour le contrôle de session actuel reçu ou l’état de contrôle de flux de données a été trouvé. La remise au composant de demi-session a été empêchée.
LUA_SC_PROTOCOL_VIOLATION
Code de retour secondaire ; une violation du protocole SC (Session Control) s’est produite. Une demande (autorisée uniquement après une demande SC et une réponse positive à cette demande ont été correctement échangées) avant l’échange requis. L’octet 4 des données de sens contient le code de requête. Aucune donnée utilisateur n’existe pour ce code de sens. Une demande d’en-tête ou unité de requête non valide pour le contrôle de session actuel reçu ou l’état de contrôle de flux de données a été trouvé. La remise au composant de 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 de réception ou la demi-session de fonction de limite. Les options BIND choisies précédemment ou les règles architecturales ont été violées par lua_rh valeurs. La remise au composant de demi-session a été empêchée. Les erreurs ne dépendent pas de l’état de session actuel. Les expéditeurs qui n’ont pas appliqué les règles de session peuvent 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 se produire pour l’une des raisons suivantes :
Erreur d’unité d’informations de chemin d’accès
Panne de chemin d’accès
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’existe plus de chemin d’accès valide au partenaire de session.
LUA_CANCELED
Code de retour principal ; le code de retour secondaire donne 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 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 des informations d’état SLI pour l’application.
LUA_READY
Code de retour secondaire ; à la suite d’un état NOT_READY, cet état est émis 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’une nouvelle liaison est à venir.
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 flux BIND, CRV et STSN facultatifs et SDT soient reçus. Ces routines sont réinscrire parce qu’elles doivent être appelées à nouveau. La session reprend après que le SLI traite la commande SDT.
Si le type UNBIND 0x02 est reçu pendant que SLI_OPEN est toujours en cours de traitement, le code de retour principal est un échec de session, et non l’état. Ou bien, la réception d’un 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 que SLI_OPEN a été traitée. Les applications LUA qui émettent des SLI_OPEN avec le paramètre lua_open_type_prim_sscp reçoivent cet état 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 conditions suivantes :
Le nœud utilisé par cette conversation a rencontré un ABEND.
La connexion entre le programme de transaction (TP) et le nœud d’unité physique (PU) 2.1 a été interrompue (erreur LAN).
Le SnaBase sur l’ordinateur TPS a rencontré un ABEND.
LUA_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. Ainsi, la communication n’a pas pu avoir lieu. Contactez l’administrateur système pour obtenir une action corrective.
LUA_INVALID_VERB_SEGMENT
Code de retour principal ; le VCB s’étend au-delà de la fin du segment de données.
LUA_UNEXPECTED_DOS_ERROR
Code de retour principal ; après avoir émis 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 ; la taille de la pile de l’application est trop petite pour exécuter le verbe. Augmentez la taille de la pile de votre application.
LUA_INVALID_VERB
Code de retour principal ; le code détaillé ou le code d’opération, ou les deux, n’est pas valide. Le verbe n’a pas exécuté.
Remarques
SLI_BID effectue les opérations suivantes :
Avertit une application Windows LUA qu’un message attend d’être lu.
Fournit l’état actuel de la session.
Fournit un aperçu du message suivant qui sera lu par SLI_RECEIVE.
Cette préversion contient un maximum de 12 octets d’informations (aperçu des données) qui permet à l’application Windows LUA de définir sa stratégie de traitement pour les données.
Pour utiliser SLI_BID au sein d’une application Windows LUA, émettez SLI_BID. Une fois le verbe terminé, il peut être réactivé de deux façons :
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écemment 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 émet 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 normale
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 être pour un flux différent de celui pour lequel vous recevez réellement des données via SLI_RECEIVE. Cette situation se produit lorsque les données de priorité supérieure arrivent de l’hôte après SLI_BID a terminé le traitement, mais avant que SLI_RECEIVE ne soit émis.
Pour vous assurer que SLI_RECEIVE lit les données, la SLI_BID retournée spécifie le flux qui correspond lua_flag2 retourné 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’état 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 SNA UNBIND avec un type UNBIND 0x02 (UNBIND avec BIND à venir). Selon ce qui a provoqué la suspension, la session peut être réactivée comme suit :
Lorsque la suspension est due à un SNA CLEAR, la réception d’un SNA SDT réactive la session.
Lorsqu’une liaison de type UNBIND SNA entraîne une suspension de la session et que la SLI_OPEN qui a ouvert la session est terminée, la session est suspendue jusqu’à ce que le SLI reçoive une commande BIND et SDT. La session peut également recevoir une commande STSN. Par conséquent, les routines fournies par l’utilisateur émises avec le SLI_OPEN initial doivent être réinitialisé, car elles seront rappelées.
L’application peut envoyer des données SSCP après qu’un type CLEAR ou UNBIND BIND arrive et avant que l’état NOT READY soit lu. L’application peut envoyer et recevoir des données SSCP après avoir lu un NOT READY.
Lorsqu’un type UNBIND SNA arrive avant l’achèvement de la SLI_OPEN qui a ouvert la session, LUA_SESSION_FAILURE (pas 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 SLI_CLOSE pour fermer la session quand c’est pratique.
LUA_INIT_COMPLETE est retourné uniquement lorsque lua_init_type pour SLI_OPEN est LUA_INIT_TYPE_PRIM_SSCP. L’état signifie que SLI_OPEN a été traité suffisamment pour permettre aux données SSCP d’être envoyées ou reçues.
Demandes d’exception
Si une unité de demande d’application hôte est convertie en EXR, les données de sens sont retournées. Lorsqu’un SLI_BID se termine avec le jeu de paramètres de verbe retourné comme indiqué, une conversion EXR se produit.
| Membre | Se mettre à |
|---|---|
| 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 des données de sens) |
Parmi 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 d’octets de 0 à 3.
| Détecter les données | Valeur d’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 qui a provoqué l’erreur.