Filter
Top Products
Chapter 25. REXX/CICS Commands
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:
v CICS, rather than EXEC CICS, should be used as the prefix for CICS commands.
v All data value fields can be specified as a literal character string or as a REXX variable name.
v All data area fields can be specified as a REXX variable name, which is either the source or the target
for the desired data.
v 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.
v Whenever you do not specify a LENGTH option, the length is automatically determined from the length
of the related REXX variable or character string.
v When using the CICS ENQ command from REXX/CICS, the LENGTH parameter should be used or
unpredictable results may occur.
v 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.
v 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,” on page 387.
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)"
Note: The EXEC CICS READ, WRITE, and DELETE commands are implemented by default as
REXX/CICS authorized commands, to control their use. Refer to “Authorized REXX/CICS
Commands/Authorized Command Options” on page 417 and to Appendix H, “Security,” on page
421.
© Copyright IBM Corp. 1992, 2009 319