Format de message de demande de transaction pour le modèle de programmation de données utilisateur TCP TRM

2023-07-21

Cette section décrit le format et le contenu du message de demande de transaction (TRM) utilisé par le modèle de programmation de données utilisateur TCP TRM.

Message de requête TRM

Le tableau suivant présente le contenu du message de demande.

TranID	Comma	Client dans les données
4	1	35

TranID
ID de transaction du serveur simultané à démarrer par l’écouteur.

Comma
Une virgule (,) sépare l’ID de transaction du client dans les données.

Client dans les données
35 octets de données utilisés par la sortie de sécurité CICS TCP/IP et transmis au serveur simultané dans le message de lancement de la transaction (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    bReserved[19];  
} 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    bReserved[18];  
} 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 TRM

Le tableau suivant présente le contenu du message de réponse.

Longueur du message de réponse TRM	Longueur du champ mis en forme	Code du champ mis en forme	Données
2	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 TRM
Longueur totale du message de réponse TRM. 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 TRM 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	TRM non valide
0x0B	Erreur	Le serveur a généré une exception
0x0C	Erreur	Les informations d’erreur d’exception se situent dans le bloc d’erreur de métadonnées

Pour plus d’informations sur le format du TRM, consultez le fichier de définition TRM à l’adresse <drive> :\Program Files\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim. Utilisez Visual Studio pour afficher le fichier.

Voir aussi

Format de message de demande de transaction pour le modèle de programmation de liaison TCP TRM

Partager via