This chapter provides you with detailed reference information for
all REXX/CICS commands. Return code information for all commands is
returned after command execution in the special REXX variable RC.
You can use all the commands
in this chapter with the command environment name REXXCICS. This is
also the default. However, depending on how you define the command,
you can use a more specific environment name (such as CICS) instead. If you need to
reset the command environment, because another command environment
is in use, enter: ADDRESS REXXCICS before you issue commands
from this chapter.
REXX/CICS supports all EXEC CICS commands, excluding
System Programming (SPI) commands, except: Handle Condition, Handle
Aid, Handle Abend, Ignore Condition, Push, and Pop. The syntax for
CICS commands under REXX/CICS is documented in the CICS Transaction Server for VSE/ESA Application Programming Reference.
Mapping between the existing EXEC CICS command definitions to the
REXX commands follows:
- CICS, rather than EXEC CICS, should be used as the prefix for
CICS commands.
- All data value fields can be specified as a literal character
string or as a REXX variable name.
- All data area fields can be specified as a REXX variable name,
which is either the source or the target for the desired data.
- The same REXX variable should not be used as both the source and
target fields on a CICS command. If this is done, the result of the
command execution will be unpredictable.
- Whenever you do not specify a LENGTH option, the length is automatically
determined from the length of the related REXX variable or character
string.
- When using the CICS ENQ command from REXX/CICS, the LENGTH parameter
should be used or unpredictable results may occur.
- NOHANDLE is automatically specified for all CICS commands. The
EIBRESP value from the execution of each command is returned in the
REXX special variable RC. Also, EIB fields are placed in REXX variables
DFHEIBLK, EIBRESP, EIBRESP2, and EIBRCODE.
- For an explanation of the return code values see the CICS Transaction Server for VSE/ESA Application Programming Reference. For information on return codes with negative
values, see Appendix B. Return Codes.
Example of EXEC CICS to REXX/CICS command mapping:
Non-REXX: EXEC CICS XCTL PROGRAM('PGMA') COMMAREA(COMA) LENGTH(COMAL)
REXX/CICS: "CICS XCTL PROGRAM('PGMA') COMMAREA(COMA)"