External Functions Provided in REXX/CICS

Additional external functions provided in the REXX/CICS environment are discussed in this section.

STORAGE

Note:
This is an authorized function.
Read syntax diagramSkip visual syntax diagram>>-STORAGE(address--+--------------------------+--)------------><
                    '-,--+--------+--+-------+-'
                         '-length-'  '-,data-'
 

returns length bytes from the user's memory starting at address. The length is in decimal; the default is 1 byte. The address is a hexadecimal number. The high-order bit of address is ignored.

If you specify data, after the old value has been retrieved storage starting at address is overwritten with data (the length argument has no effect on this).

Note:
The STORAGE function can operate on storage above the 16MB line.

Warning: The STORAGE function, which allows a REXX user to display and/or modify the virtual storage of the CICS region, can only be successfully invoked from an authorized exec or by an authorized user.

Examples:

/* Note that the following results vary from system to system.  */
STORAGE(200000,32)
/* This returns 32 bytes of storage at hex address 200000 as a result. */

SYSSBA

Read syntax diagramSkip visual syntax diagram>>-SYSSBA--(--row--,--col--)-----------------------------------><
 

SYSSBA converts screen row,col to a set buffer address (SBA).

Operands:
row
specifies the row number counting from the top of the screen.
col
specifies the column number (counting from the left of the screen).
Example:
x = SYSSBA(10,20)

This example returns a three byte set buffer address for screen row 10, column 20 into REXX variable x.

Note:
The SYSSBA function queries the terminal model on each invocation and uses this to adjust the SBA calculation to terminal type.