Filter
Top Products
CICSLOAD
is a keyword indicating that the processing agent is a CICS program that is loaded by an EXEC
CICSLOAD.
REXX
is a keyword indicating that the processing agent for this REXX command is a REXX exec that
operates as a command server.
AUTH
Note: This is an authorized option.
is a keyword indicating that this is an authorized REXX/CICS command. It is a command that can only
be executed by an authorized REXX/CICS user (specified on AUTHUSER command) or from within an
exec loaded from an authorized library.
CLEAR
is a keyword indicating that the purpose of this DEFCMD is to clear any previous definitions for the
specified external target environment and command names.
Return Codes
0 Normal return
1001 Invalid command
1021 Cannot load program
1023 Entry not found
1048 No client available
1099 Internal error
Example
'DEFCMD CICS SEND = = SENDPGM (CICSLINK'
This example defines a command called SEND for this user only. The user can issue this command, under
the default command environment of REXXCICS, by entering:
'CICS SEND arg1 arg2 ... argn'
This example shows program SENDPGM being called by an EXEC CICS LINK command to process this
command.
Notes
1. When the REXX/CICS environment name is REXXCICS (which is the default when all execs or
macros are called), then the first token of the command string is the environment name that could
have been used with an ADDRESS environment REXX instruction. This provides a more integrated
command environment and removes the need for constant environment switching by ADDRESS
instructions.
2. The calling and parameter passing sequences for command programs receiving control by an EXEC
CICS LINK and an Assembler BASSM instruction (the CICSLOAD option) are similar. Refer to
Chapter 21, “REXX/CICS Command Definition,” on page 281 for more information on writing command
programs.
3. You can use DEFCMD to dynamically tailor a user's command set on a user by user, or application by
application basis. DEFCMD commands can be placed in the user's PROFILE EXEC or in application
execs. DEFCMD can also be used to override system command definitions.
4. DEFCMD REXXCICS * is not allowed.
5. User command definitions are searched before system command definitions (except for DEFCMD,
which cannot be overridden).
6. REXX commands can be written in REXX. These REXX commands in turn call other REXX commands
which are written in REXX, in a building block fashion. Since DEFCMD hides the implementation detail
Commands
Chapter 25. REXX/CICS Commands 333