Notes on Using This Function

  1. The Copy String to Presentation Space function is affected by the following options:
    • STRLEN/STREOT
    • EOT
    • EAB/NOEAB
    • XLATE/NOXLATE
    • PUTEAB/NOPUTEAB
    • EAD/NOEAD (for DBCS only)
    • NOSO/SPACESO/SO (for DBCS only)
    • EXTEND_PS/NOEXTEND_PS
    Refer to items 1 and 2; 13 and 14; 18; and 20 and 21 for more information.
  2. The keyboard mnemonics (see Send Key (3) function) cannot be sent using the Copy String to Presentation Space function.
  3. The string ends 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)).
  4. Although the Send Key (3) function accomplishes the same purpose, this function responds with the prompt and enters a command more quickly. Because the Send Key (3) function emulates the terminal operator typing the data from the keyboard, its process speed is slow for an application operating with a lot of data. This function provides a faster input path to the host.
  5. The original data (the copied string) cannot exceed the size of the presentation space.
  6. 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. If only the first byte or the second byte of the double-byte character must be written into the string, a blank is 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.

    If the character to be written into the last character of the target presentation space is SO/SI or the first byte of the double-byte character, the character is not written and truncated, 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 always displays the same information on the 24th row. 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.
  7. This function call may cause a cursor movement to an unexpected position with some host applications. A SendKey function may be a better choice for filling a field than this function.
    Note: This only occurs with VT sessions or connections to an ASCII host.
Parent topic: Copy String to Presentation Space (15)