CBL_GET_SCR_GRAPHICS

Returns operating system independent codes for graphics characters.

Syntax:
call "CBL_GET_SCR_GRAPHICS" using     graphics-params
                            returning status-code
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
graphics-params Group predefined as cblt-get-scr-graphics-buffer containing: Group containing:
  cblte-gsgb-flag   cblt-x1-compx   pic x comp-x.
  cblte-gsgb-buf-size   cblt-x2-compx   pic x(2) comp-x.
  cblte-gsgb-buf   Group containing:   Group containing:
    cblte-gsgb-up-arrow     Group containing:     Group containing:
      cblte-gsgb-up-arrow-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-up-arrow       cblt-x1-compx       pic x.
    cblte-gsgb-down-arrow     Group containing:     Group containing:
      cblte-gsgb-down-arrow-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-down-arrow       cblt-x1-compx       pic x.
    cblte-gsgb-right-arrow     Group containing:     Group containing:
      cblte-gsgb-right-arrow-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-right-arrow       cblt-x1-compx       pic x.
    cblte-gsgb-left-arrow     Group containing:     Group containing:
      cblte-gsgb-left-arrow-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-left-arrow       cblt-x1-compx       pic x.
    cblte-gsgb-maximize     Group containing:     Group containing:
      cblte-gsgb-maximize-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-maximize-char       cblt-x1-compx       pic x.
    cblte-gsgb-minimize     Group containing:     Group containing:
      cblte-gsgb-minimize-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-minimize-char       cblt-x1-compx       pic x.
    cblte-gsgb-check     Group containing:     Group containing:
      cblte-gsgb-check-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-check-char       cblt-x1-compx       pic x.
    cblte-gsgb-restore     Group containing:     Group containing:
      cblte-gsgb-restore-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-restore-char       cblt-x1-compx       pic x.
    cblte-gsgb-radio     Group containing:     Group containing:
      cblte-gsgb-radio-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-radio-char       cblt-x1-compx       pic x.
    cblte-gsgb-scroll     Group containing:     Group containing:
      cblte-gsgb-scroll-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-scroll-char       cblt-x1-compx       pic x.
    cblte-gsgb-rubber-band     Group containing:     Group containing:
      cblte-gsgb-rubber-band-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-rubber-band-char       cblt-x1-compx       pic x.
    cblte-gsgb-sysmenu     Group containing:     Group containing:
      cblte-gsgb-sysmenu-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-sysmenu-char       cblt-x1-compx       pic x.
    cblte-gsgb-editor-char     Group containing:     Group containing:
      cblte-gsgb-editor-char-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-editor-char       cblt-x1-compx       pic x.
    cblte-gsgb-hyhelp-tab     Group containing:     Group containing:
      cblte-gsgb-hyhelp-tab-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-hyhelp-tab       cblt-x1-compx       pic x.
    cblte-gsgb-hyhelp-btab     Group containing:     Group containing:
      cblte-gsgb-hyhelp-btab-dbflg       cblt-x1-compx       pic x comp-x.
      cblte-gsgb-hyhelp-btab       cblt-x1-compx       pic x.
status-code See Library Routines - Key
On Entry:
cblte-gsgb-flag Type of character code to return:
0 Either single-byte or double-byte character set as appropriate for the host environment
1 Only single-byte character set (SBCS)
2 Only double-byte character set (DBCS)
cblte-gsgb-buf-size Length of cblte-gsgb-buf in bytes. The normal value of cblte-gsgb-buf-size is 30, although by specifying a smaller value you can request only the graphics values you require.

You must not set cblte-gsgb-buf-size to be greater than the length of cblte-gsgb-buf. If cblte-gsgb-buf-size exceeds the length of cblte-gsgb-buf, the run-time system continues to write to memory past the buffer, which could corrupt other data.

On Exit:
cblte-gsgb-buf-size Number of bytes filled.
cblte-gsgb-buf Character codes for each entry that is completely contained in the cblte-gsgb-buf-size byte count. The contents of any character code which is only partially in the byte count is undefined. Any character codes wholly outside the byte count are ignored.

The byte count should include the whole of any DBCS character-part, even if DBCS is not requested or expected.

For the cblte-gsgb-*-dbflg data items, zero indicates single-byte character codes have been returned; a nonzero value is the first byte of the double-byte character returned.

status-code Return status:
0 Success
1 Not all requested codes were available; cblte-gsgb-buf-size contains the number of bytes that were returned.
2 cblte-gsgb-buf could not be filled with the character codes specified (either SBCS or DBCS). In this case, the characters that were not available were filled as though cblte-gsgb-flag was set to 0.
3 Both the errors signaled by status-code = 1 and 2 occurred.
See Also: