Notes sur l'utilisation de cette fonction

  1. Les informations sur la position et la longueur du champ peuvent être trouvées à l'aide des fonctions Find Field Position (31) et Find Field Length (32). La fonction Copy Field to String peut être utilisée avec des champs protégés ou non, mais uniquement dans un espace de présentation hôte formaté par champ.
  2. La copie est terminée lorsque l'une des conditions suivantes est remplie :
    • Lorsque la fin du champ est atteinte
    • Lorsque la longueur de la chaîne cible est dépassée
  3. 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.
  4. La fonction Copy Field to String est affectée par les options de session ATTRB/NOATTRB/NULLATTRB, EAB/NOEAB, XLATE/NOXLATE, DISPLAY/NODISPLAY, DISPLAY/NODISPLAY. Voir les éléments 5, 13, 14 et 17 pour plus d'informations.
    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.

    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–6Attributs de police
    • 00 = Valeur par défaut
    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é
    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.

  5. 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 25e ligne sur la barre d'état. Par 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.