- DDNAME(ddname1)
- Specifies that the commands are to be read from a named input data set.
If this keyword is omitted, the default DDname, CSQUCMD, is used.
ddname1 specifies the DDname that identifies the input data set
from which commands are to be read.
- MAKEDEF(ddname2), MAKEDEL(ddname2), MAKEREP(ddname2), MAKEALT(ddname2)
- Specify that commands are to be generated from any DISPLAY object commands
in the input data set.
The commands that are generated are:
- MAKEDEF
- DEFINE NOREPLACE, with all the attributes and values returned by the
DISPLAY commands. For the queue manager object, an ALTER command is generated
with all the attributes and values.
- MAKEDEL
- DELETE. For local queues, NOPURGE is used.
- MAKEREP
- DEFINE REPLACE, with any keywords and values from the data set specified
by the DATA keyword.
- MAKEALT
- ALTER, with any keywords and values from the data set specified
by the DATA keyword.
Only one of these keywords may be specified. If these keywords are
omitted, no commands are generated.
ddname2 specifies
the DDname that identifies the output data set in which the DEFINE, DELETE or ALTER commands are to be stored. The data set should be RECFM=FB,
LRECL=80. This data set can then be used as input for a later invocation of
the COMMAND function or it can be incorporated into the initialization data
sets CSQINP1 and CSQINP2.
DATA(ddname4)
ddname4 specifes a data set from which command keywords and values are to
be read, and appended to each command generated for MAKEREP or MAKEALT.
- TGTQMGR(qmgrname)
- Specifies the name of the queue manager where you want the commands
to be performed. You can specify a target queue manager that is not the one
you connect to. In this case, you would normally specify the name of a remote
queue manager object that provides a queue manager alias definition (the name
is used as the ObjectQMgrName when opening the command
input queue). To do this, you must have suitable queues and channels set up
to access the remote queue manager.
The default is that commands are performed
on the queue manager to which you are connected, as specified in the PARM
field of the EXEC statement.
- RESPTIME(nnn)
- Specifies the time in seconds to wait for a response to each command,
in the range 5 through 999.
The default is 30 seconds.
- MAKECLNT(ddname3)
- Specifies that a client channel definition file is generated from any
DISPLAY CHANNEL commands in the input data set that return information about
client-connection channels, and any DISPLAY AUTHINFO commands that return
information about authentication information objects for which the LDAPUSER
and LDAPPWD attributes are not set.
If this keyword is omitted, no file
is generated.
ddname3 specifies the DDname
that identifies the output data set in which the generated file is to be stored;
the data set should be RECFM=U, LRECL=6144. The file can then be downloaded
as binary data to the client machine by a suitable file transfer program.
- CCSID(ccsid)
- Specifies the coded character set identifier (CCSID) that is to be used
for the data in a client channel definition file. The value must be in the
range 1 through 65535; the default is 437. You can only specify CCSID if you
also specify MAKECLNT.
Note:
WebSphere MQ assumes that the data is to be
in ASCII, and that the encoding for numeric data is to be MQENC_INTEGER_REVERSED.
- FAILURE
- Specifies what action to take if an WebSphere MQ command that is issued fails
to execute successfully. Values are:
- IGNORE
- Ignore the failure; continue reading and issuing commands, and treat
the COMMAND function as being successful. This is the default.
- CONTINUE
- Read and issue any remaining commands in the input data set, but treat
the COMMAND function as being unsuccessful.
- STOP
- Do not read or issue any more commands, and treat the COMMAND function
as being unsuccessful.