Filter
Top Products
DEFCMD
DEFCMD etarget ecmdnm
etarget *
itarget icmdnm
itarget *
==
pgmname
CICS_loadmod
execname
( CLEAR
( CICSLINK
CICSLOAD AUTH
REXX
DEFCMD defines (or redefines) REXX user commands.
Operands
etarget
is the 1 to 8 character name of the external target environment you used in a REXX exec issuing this
command. This is the external environment name that you directed the command string to. This
environment name is looked up in a table and together with the command name determines which
REXX program the command string is directed to for processing.
Note: The external target can match the environment name on the ADDRESS keyword instruction or,
if REXXCICS is the current environment (the default condition), can be specified as the first
token of the command string.
ecmdnm
is the first command name token that you used issuing this command. This is the first word of the
command name as it is known to you. If a special value of asterisk (*) is specified (as part of this
definition), then all commands that you issued with an environment name of etarget and that are not
more explicitly defined elsewhere, are covered by this command definition. Command names may be
up to 16 characters long.
itarget
specifies an internal environment name that this command definition passes to the agent that
processes the command string. This is needed so that the external environment names known to you
can be redefined without breakage of the agents that process these commands. If the internal and
external names are identical, then there is no need for you to specify the internal name. A special
value of “=” indicates that itarget is the same as etarget.
icmdnm
is the first word of the internal command name. This is the first part of the command name that is
passed to the REXX command agent to specify what command is processed. This is specified only if it
is different from ecmdnm. A special value of “=” indicates that icmdnm is the same as ecmdnm.
pgmname
specifies the CICS program that is called by an EXEC CICS LINK to process the command.
CICS_loadmod
specifies the name of the CICS program called because the CICSLOAD option was specified.
Note: The program is only loaded on the first instance of a command and its address is remembered
for subsequent commands.
execname
specifies the exec called as a REXX command server processing this command (or commands). If this
server exec is already running then this command is routed to the executing server. If a REXX server
by this name is not running, then Automatic Server Initiation (ASI) is used to start the server
automatically. The execname can be either a file name (where the file type defaults to EXEC) or it can
be in the form filename.filetype.
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.
Commands
332
CICS TS for VSE/ESA: REXX Guide