Notes sur l'utilisation de cette fonction

Un EAB peut être renvoyé lorsque l’option EAB de la fonction Set Session Parameters (9) est utilisée. EAB est lié à chaque caractère de l'espace de présentation et est renvoyé avant chaque caractère.
La fonction Copy Presentation Space est affectée par les options de session suivantes :
- ATTRB/NOATTRB/NULLATTRB
- EAB/NOEAB
- XLATE/NOXLATE
- BLANK/NOBLANK
- DISPLAY/NODISPLAY
- EXTEND_PS/NOEXTEND_PS

Voir les éléments 5, 13, 14, 15 et 17 pour plus d'informations.

Si la chaîne de données cible fournie n'est pas suffisamment longue pour contenir les données demandées, des résultats imprévisibles peuvent se produire.

Comme indiqué précédemment, le retour des attributs par les différentes fonctions de copie (5, 8 et 34) est affecté par la fonction Set Session Parameters (9). Les paramètres de session définis impliqués ont l'effet suivant :

Définir le paramètre de session: Effet sur la fonction de copie
NOEAB et NOEAD: Les attributs ne sont pas renvoyés. Seul le texte est copié de l'espace de présentation vers le tampon utilisateur.
EAB et NOXLATE: Les attributs sont renvoyés tels que définis dans les tableaux suivants.
EAB et XLATE: Les couleurs utilisées pour l'affichage de l'espace de présentation sont renvoyées. Les couleurs peuvent être remappées ; les couleurs des attributs ne sont donc pas celles renvoyées par les fonctions Copy lorsque XLATE et EAB sont activés en même temps.
NOSO/SPACESO/SO: Lorsque NOSO est spécifié, il fonctionne comme SPACESO. La taille de l'espace de présentation n'est pas modifiée.

Les attributs de caractères renvoyés sont définis dans les tableaux suivants. Les positions des bits d'attribut sont au format IBM®, le bit 0 étant le bit le plus à gauche de l'octet.

Les attributs de caractères 3270 sont renvoyés de l'hôte à l'émulateur. Le tableau suivant s'applique lorsque EAB et NOXLATE sont définis.


Position des bits	Signification
0–1	Mise en évidence des caractères 00 = Normale 01 = Clignotement 10 = Vidéo inversée 11 = Soulignement
2–4	Couleur des caractères (le remappage des couleurs peut remplacer cette définition de couleur.) 000 = Par défaut 001 = Bleu 010 = Rouge 011 = Rose 100 = Vert 101 = Turquoise 110 = Jaune 111 = Blanc
5–6	Attribut de caractère 00 = Valeur par défaut
7	Réservé

Les attributs de caractères 5250 sont renvoyés de l'hôte à l'émulateur. Le tableau suivant s'applique lorsque EAB et NOXLATE sont définis.


Position des bits	Signification
0	Image inversée 0 = Image normale 1 = Image inversée
1	Soulignement 0 = Pas de soulignement 1 = Soulignement
2	Clignotement 0 = Aucun clignotement 1 = Clignotement
3	Séparateur de colonnes 0 = Aucun séparateur 1 = Séparateur
4–7	Réservé

Le tableau suivant montre les attributs de couleur des caractères Z and I Emulator for Windows. Le tableau suivant s'applique lorsque EAB et XLATE sont définis.


Position des bits	Signification
0–3	Couleurs des caractères d’arrière-plan 0000 = Noir 0001 = Bleu 0010 = Vert 0011 = Cyan 0100 = Rouge 0101 = Magenta 0110 = Marron (3270), Jaune (5250) 0111 = Blanc
4–7	Couleurs des caractères de premier plan 0000 = Noir 0001 = Bleu 0010 = Vert 0011 = Cyan 0100 = Rouge 0101 = Magenta 0110 = Marron (3270), Jaune (5250) 0111 = Blanc 1000 = Gris 1001 = Bleu clair 1010 = Vert clair 1011 = Cyan clair 1100 = Rouge clair 1101 = Magenta clair 1110 = Jaune 1111 = Blanc (haute intensité)

Pour un écran monochrome PS/2®, les caractères de la session d'application (poste de travail) apparaissent sous différentes nuances de gris. Ceci est nécessaire pour donner aux utilisateurs leurs couleurs remappées dans la session d'application EHLLAPI afin qu'ils puissent obtenir ce qu'ils voient dans leurs espaces de présentation d'application hôte.

Si vous souhaitez copier uniquement une partie de l'espace de présentation hôte, utilisez la fonction Copy Presentation Space to String (8).

Pour utiliser cette fonction, préallouez de la mémoire pour recevoir le paramètre de chaîne de données renvoyé. Les instructions requises pour préallouer cette mémoire varient en fonction du langage dans lequel votre application est écrite. Consultez Allocation de mémoire pour plus d'informations.

Note : L'émulation 5250 prend en charge un espace de présentation de 24 lignes sur 80 colonnes. Dans certains cas, l'émulation Communication Manager 5250 affiche une 25ème ligne. Cela se produit lorsqu'un message d'erreur de l'hôte s'affiche ou lorsque l'opérateur sélectionne la clé SysReq. Z and I Emulator for Windows affiche les informations de la ligne 25 sur la ligne 24 ou sur la barre d'état. Pour que les informations soient affichées sur la barre d'état, la barre d'état doit être configurée. Consultez Guide d'initiation pour plus d'informations sur la configuration de la barre d'état. Avec l'option EXTEND_PS, une application EHLLAPI peut utiliser la même interface avec Communication ManagerEHLLAPI et l'espace de présentation valide est étendu lorsque cette condition se produit.