Notes sur l'utilisation de cette fonction

  1. 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é après chaque caractère.
  2. La fonction Copy Presentation Space to String est affectée par les options suivantes :
    • ATTRB/NOATTRB/NULLATTRB
    • EAB/NOEAB
    • XLATE/NOXLATE
    • BLANK/NOBLANK
    • DISPLAY/NODISPLAY
    • EXTEND_PS/NOEXTEND_PS
    .

    Si la chaîne de données cible fournie n'est pas suffisamment grande pour contenir le nombre d'octets demandé, la copie se termine avec succès (RC=0, 4 ou 5) lorsque la fin de la chaîne de données cible est atteinte.

    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, de sorte que les couleurs d'attribut ne sont pas celles renvoyées par les fonctions de copie lorsque XLATE et EAB sont activés en même temps.
    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–1Mise en évidence des caractères
    • 00 = Normale
    • 01 = Clignotement
    • 10 = Vidéo inversée
    • 11 = Soulignement
    2–4Couleur 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–7Ré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
    0Image inversée
    • 0 = Image normale
    • 1 = Image inversée
    1Soulignement
    • 0 = Pas de soulignement
    • 1 = Soulignement
    2Clignotement
    • 0 = Aucun clignotement
    • 1 = Clignotement
    3Séparateur de colonnes
    • 0 = Aucun séparateur
    • 1 = Séparateur
    4–7Réservé
    • Les attributs de caractères VT 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-3Réservé
    4Gras
    • 1 = Activé
    • 0 = Désactivé
    5Tiret de soulignement
    • 1 = Activé
    • 1 = Désactivé
    6Clignotement
    • 1 = Activé
    • 0 = Désactivé
    7Inverser
    • 0 = Activé
    • 1 = Désactivé
    • 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–3Couleurs 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–7Couleurs 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.

  3. 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.