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 20 and 21 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.
  5. DBCS Only: Double-byte characters can be included as a part of the string.
    Note: PC400 does not add SO and SI to the string. When you write the strings, including double-byte characters at the DBCS mixed field, generate SO and SI and create the area where double-byte characters are written by using the Send Key (3) function in advance.

    If both single-byte and double-byte characters exist in a string, the data might be truncated because the data length in EBCDIC is longer than in JISCII. In this case, only the first byte or the second byte of the double-byte character is not written.

    If the last character in the original string is the first byte of the double-byte character, the character is not written and not counted in the length.

    A control character is converted from single-byte character to double-byte character, or from double-byte character to single-byte character depending on the field condition. A pair of NULL+Control Character between SO and SI is treated as a double-byte control character. For example, the following strings are copied into the single-byte character field or the double-byte character field:
      String   Meanings Single-byte character field Double-byte character field
    X'000C' (NULL)(FF) X'00'X'0C' (SB NULL)(SB FF) X'00'X'0C' (DB NULL)(DB FF) X'0000'X'000C'
    X'0E000C0F' (SO)(DB FF)(SI) X'0E'X'000C'X'0F' –S error (DB FF) X'000C'
    Note: SB means single-byte characters and DB means double-byte characters.
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. Personal Communications 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.
Parent topic: Copy String to Field (33)