Return Codes; Example; Notes - IBM SC34-5764-01 Manual

Commands
CICSLINK
is a keyword indicating that the processing agent for the defined REXX command is a standard CICS
program that is called by an EXEC CICS LINK.
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
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 DEFSCMD is to clear any previous definitions for the
specified external target environment and command names.

Return Codes

0 Normal return
1101 Invalid command
1121 Cannot load program
1123 Entry not found
1148 No client available
1199 Internal error

Example

'DEFSCMD 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. If the first two operands of DEFSCMD are all asterisks (* *) then this is a catch-all definition that
specifies a command processing agent issued for REXX commands that are not under the scope (do
not match) of any more specific command definitions.
4. User command definitions are searched before system command definitions (except for DEFSCMD,
which cannot be overridden).
336
CICS TS for VSE/ESA: REXX Guide