Format de message d’écouteur amélioré pour le modèle de programmation de liaison ELM
Cette section décrit le format et le contenu du message d’écouteur amélioré (ELM) utilisé par le modèle de programmation TCP ELM Link.
Message de requête ELM
Le tableau suivant présente le contenu du message de demande.
| Client dans les données |
|---|
| 35 |
Client dans les données
35 octets de données utilisés par la sortie de sécurité TCP/IP CICS et transmis au serveur simultané dans le fichier de métadonnées d’intégrateur de transactions (TIM).
Client dans les données pour le format de sortie de sécurité Microsoft
Le bloc de code suivant décrit le format du client dans les données de la sortie de sécurité Microsoft.
struct CLIENT_IN_DATA {
BYTE bUserID[8];
BYTE bPassword[8];
BYTE bLinkToName[8];
USHORT usCommareaLen;
BYTE bReserved[9];
} UNALIGNED;
Client dans les données pour le format de sortie de sécurité IBM
Le bloc de code suivant décrit le format du client dans les données de la sortie de sécurité IBM.
struct CLIENT_IN_DATA2 {
BYTE bSecFlag;
BYTE bPassword[8];
BYTE bUserID[8];
BYTE bLinkToName[8];
USHORT usCommareaLen;
BYTE bReserved[8];
} UNALIGNED;
Client dans les données pour COBOL
Le bloc de code suivant décrit le format du client dans COBOL
01 CLIENT-IN-DATA PIC X(35).
01 FILLER REDEFINES CLIENT-IN-DATA.
05 CID-USERID PIC X(8).
05 CID-PASSWORD PIC X(8).
05 CID-LINK-TO-PROG PIC X(8).
05 CID-COMMAREA-LEN PIC S9(4) COMP.
05 CID-DATA-LEN PIC S9(8) COMP.
05 CID-VERSION PIC X.
05 CID-FLAG-1 PIC X.
05 CID-FLAG-2 PIC X.
05 CID-RESERVED PIC X.
05 CID-FORMAT PIC X.
Client dans les constantes de données pour COBOL
Le bloc de code suivant décrit les constantes du client dans les données dans COBOL.
01 CLIENT-IN-DATA-CONSTANTS.
05 CID-C-VERSION.
10 CID-VERSION-1 PIC X VALUE X'00'.
10 CID-VERSION-2 PIC X VALUE X'01'.
05 CID-C-FLAG-1.
10 CID-USE-TICS-WORK-AREA PIC X VALUE X'01'.
05 CID-C-FLAG-2.
10 CID-PC-NONE PIC X VALUE X'01'.
10 CID-PC-OPEN PIC X VALUE X'02'.
10 CID-PC-USE PIC X VALUE X'04'.
10 CID-PC-CLOSE PIC X VALUE X'08'.
10 CID-NO-OBJ-PERSIST PIC X VALUE X'10'.
05 CID-C-FORMAT.
10 CID-FORMAT-NOTSET PIC X VALUE X'00'.
10 CID-FORMAT-MS PIC X VALUE X'01'.
10 CID-FORMAT-IBM PIC X VALUE X'02'.
Message de réponse ELM
Le tableau suivant présente le contenu du message de réponse.
| Longueur du message de réponse ELM | Longueur du champ mis en forme | Code du champ mis en forme | Données |
|---|---|---|---|
| 4 | 4 | 1 | 0-n |
Notes
La longueur du champ mis en forme, le code du champ mis en forme et les données peuvent être répétés plusieurs fois dans un même message.
Longueur du message de réponse ELM
Longueur totale du message de réponse ELM. Cette longueur est la somme de toutes les longueurs des champs mis en forme qui suivent dans le message, et elle n’inclut pas la longueur du champ de longueur du message de réponse ELM lui-même.
Longueur du champ mis en forme
Longueur du fichier mis en forme.
La longueur du champ mis en forme est la somme de la combinaison de la longueur du code du champ mis en forme et de la longueur des données.
Code du champ mis en forme
Code à 1 octet qui décrit les informations transmises du serveur simultané au client.
Vous ne pouvez pas modifier le code de champ mis en forme.
Les codes de champ sont spécifiques à la gestion de la communication entre les transports TCP WIP et HIP et les programmes du serveur simultané MSCMTICS, MSHIPLNK et TCP.
Données
Informations à 0 ou plusieurs octets, associées à un champ mis en forme spécifique.
Vous pouvez modifier les informations stockées dans Données. Si vous modifiez les données, veillez à modifier également la réponse TRM et la longueur du champ mis en forme avec les nouvelles valeurs.
La longueur des données est égale à la longueur du champ mis en forme moins la taille du code du champ mis en forme.
Codes normaux
Le tableau suivant indique la signification des codes normaux.
| Code | Type | Signification |
|---|---|---|
| 0x01 | Informations | ID de version du serveur simultané Microsoft® Transaction Integrator |
| 0x02 | Informations | Données utilisateur |
| 0x07 | Informations | Exécution OK |
Codes d’erreur
Le tableau suivant indique la signification des codes d’erreur.
| Code | Type | Signification |
|---|---|---|
| 0x03 | Erreur | ProgID non valide |
| 0x04 | Erreur | TranID non valide |
| 0x05 | Erreur | Échec de la demande |
| 0x06 | Erreur | État de la demande |
| 0x08 | Erreur | Abandon du programme |
| 0x09 | Erreur | Échec de ’exécution |
| 0x0A | Erreur | ELM non valide |
Pour plus d’informations sur le format du TRM, consultez le fichier de définition TRM à l’adresse <drive> :\Program Files\ Microsoft Host Integration Server\System\TIM\MicrosoftTRMDefs.tim. Utilisez Visual Studio pour afficher le fichier.
Voir aussi
Format de message d’écouteur amélioré pour le modèle de programmation de données utilisateur ELM