Notes on Using This Function

  1. An EAB can be returned when the Set Session Parameters (9) function EAB option is used. EAB is related to each character in the presentation space and is returned following each character.
  2. DBCS Only: The Set Session Parameters (9) function EAD option is used with this function to return a 2-byte EAD. If the EAD option is specified instead of the EAB option, EAD is returned preceding each character. If both the EAB and EAD options are specified, EAD is returned following the EAB. If the start position of the copy is at the second byte in the double-byte character, or the end position is at the first byte in the double-byte character, the bytes are translated into blanks. If the EAD option is set to on, three bytes are returned for each character. If both the EAB and EAD options are set to on, four bytes are returned for each character.
  3. The Copy Presentation Space to Clipboard function is affected by the following options:
    • ATTRB/NOATTRB/NULLATTRB
    • EAB/NOEAB
    • XLATE/NOXLATE
    • BLANK/NOBLANK
    • DISPLAY/NODISPLAY
    • PUTEAB/NOPUTEAB
    • EAD/NOEAD (for DBCS only)
    • NOSO/SPACESO/SO (for DBCS only)
    • EXTEND_PS/NOEXTEND_PS
  4. The data string buffer is used in processing the data retrieved from presentation space and copy to clipboard. If the data string buffer provided is not large enough to hold the requested number of bytes, the copy ends successfully (RC=0, 4, or 5) when the end of the data string buffer is reached. As previously stated, the return of attributes by the various Copy (5, 8, and 34) functions is affected by the Set Session Parameters (9) function. The involved set session parameters have the following effect:

    Set Session Parameter

    Effect on the Copy Function

    NOEAB and NOEAD

    Attributes are not returned. Only text is copied from the presentation space to the clipboard.

    EAB and NOXLATE

    Attributes are returned as defined in the following tables.

    EAB and XLATE

    The colors used for the presentation space display are returned. Colors can be remapped, so the attribute colors are not the ones returned by the Copy functions when XLATE and EAB are on at the same time.

    EAD

    Double-byte character set attributes are returned as shown in the following tables. The returned character attributes are defined in the following tables. The attribute bit positions are in IBM format with bit 0 the left most bit in the byte. v 3270 character attributes are returned from the host to the emulator. The following table applies when EAB and NOXLATE are set.