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 with the REXX commands is as 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 intended 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 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)"
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 and authorized command
options and to Security.