Notes sur l'utilisation de cette fonction
- Le code retour 35 sera renvoyé lorsque la fonction Read Structured Fields ou Write Structured Fields est demandée pour la première fois après l'annulation d'une transmission sortante de l'hôte. Les mesures correctives relèvent de la responsabilité de l'application.
- Le code retour 36 nécessite que l'application se déconnecte du programme d'émulation, puis se reconnecte pour rétablir la communication avec l'hôte. Les mesures correctives relèvent de la responsabilité de l'application.
- Le code retour 37 sera renvoyé si l'hôte est désactivé pour les appels entrants. La fonction Read Structured Fields a été demandée avec succès.
- Le EHLLAPI permet qu'un maximum de 20 requêtes asynchrones par application soient en attente. Un code retour pour les ressources indisponibles (RC=11) est renvoyé si plus de 20 requêtes asynchrones sont tentées.
Les données de champ structuré contiennent les champs structurés d'application reçus de l'hôte. Les en-têtes de champs structurés sont supprimés par le EHLLAPI avant que les données de champ structurées n'atteignent l'application.
Le format des données de champ structuré est le suivant :
| Décalage | Longueur | Contenus |
|---|---|---|
| 0 | 1 mot | X'0000'. |
| 2 | 1 mot | m (longueur du message : le nombre d'octets de données dans le message, le nombre n'inclut pas le préfixe d'en-tête du tampon, qui contient 8 octets). Cette valeur est renvoyée par EHLLAPI. |
| 4 | 1 mot | n (taille du tampon : la longueur fournie du tampon de données qui inclut l'en-tête du message de 8 octets). Cette valeur doit être définie par l'application. |
| 6 | 1 mot | X'C000'. |
| 8 | 8 octets | Longueur du premier (ou du seul) message de champ structuré. |
| 10 | 1 octet | Premier octet hors longueur du message de champ structuré. |
| ⋮ | ||
| m+7 | 1 octet | Dernier octet du message de champ structuré. |
Les octets 0 à 7 sont l'en-tête du tampon. Ces 8 premiers octets sont utilisés par le programme d'émulation. La section utilisateur du tampon commence par le décalage 8. Les octets 8 et 9 contiennent le nombre d'octets dans le premier champ structuré (un message à champ structuré peut contenir plusieurs champs structurés), dont 2 octets pour les octets 8 et 9. Octets 8 à m+7 sont utilisés pour le message de champ structuré reçu de l'hôte (qui peut contenir plusieurs champs structurés).
L'application utilisatrice doit fournir le tampon complet avec le mot au décalage 0 mis à zéro. La longueur du tampon doit être dans le mot au décalage 4. Le mot au décalage 6 doit être X'C000'. Le programme d'émulation placera le message de données commençant au décalage 8 et placera la longueur du message dans le mot au décalage 2. La longueur du tampon n'est pas perturbée par EHLLAPI.