Notes on Using This Function

  1. The Copy String to Field function is affected by the following options:
    • STRLEN/STREOT
    • EOT
    • EAB/NOEAB
    • XLATE/NOXLATE
    • PUTEAB/NOPUTEAB

    Refer to items 1 and 2; 13 and 14; 18; and sparopt.html#sparopt__opt18 and sparopt.html#sparopt__opt19 for more information.

  2. The string to be transferred is specified with the calling data string parameter. The string ends when one of these three conditions is encountered:
    • When an end-of-text (EOT) delimiter is encountered in the string if EOT mode was selected using the Set Session Parameters (9) function. (See Set Session Parameters (9)).
    • When the number specified in the length is reached if not in EOT mode.
    • When an end-of-field is encountered in the field.
    Note: If the field at the end of the host presentation space wraps, wrapping occurs when the end of the presentation space is reached.
  3. The keyboard mnemonics (see Send Key (3) function) cannot be sent using the Copy String to Field function.
  4. The first byte of the data to be transferred is always placed at the beginning of the field that contains the specified PS position.
Note: 5250 emulation supports a presentation space of 24 rows by 80 columns. In some instances, Communication Manager 5250 emulation displays a 25th row. This occurs when either an error message from the host is displayed or when the operator selects the SysReq key. Z and I Emulator for Windows displays 25th row information on row 24, or on the status bar. For information to be displayed on the status bar, the status bar must be configured. Refer to Quick Beginnings for information on configuring the status bar. By the EXTEND_PS option, an EHLLAPI application can use the same interface with Communication Manager EHLLAPI and valid presentation space is extended when this condition occurs.