CICS-WebSphere MQ connection, starting, START command, CKQC, CICS command line, starting from, connections, lowercase queue names, operation of, CICS adapter, UCTRAN, on TYPETERM definition, TYPETERM definition" />
Starting a connection from the CICS command line
The example shown in Figure 9 starts a connection, using the default connection values set at system initialization.
Figure 9. Starting a connection from the command lineCKQC STARTThe command shown in Figure 10 starts a connection, using the explicitly defined connection parameter values. The parameters are positional; enter every field to its maximum length if you want to override the default.
Figure 10. Starting a connection from the command line specifying parametersCKQC START Y|N <subsystem ID> <trace number> <initiation queue name>Where:
- Y|N
- Specify either:
Y
- Use the default values, that is, substitute default values for any blank arguments.
N
- Do not use the default values.
- <subsystem ID>
- Name of the queue manager to connect to.
- <trace number>
- The trace number. It must be in the range zero through 199.
- <initiation queue name>
- The name of the default initiation queue.
Specifying lowercase queue names
By default, CICS folds lowercase input, for both keywords and parameters, to uppercase. Therefore, by default, these commands are equivalent:
Figure 11. Specifying lowercase queue namesCKQC START Y CSQ1 199 CICS01.INITQ ckqc start y csq1 199 cics01.initqIf you want to use lowercase queue names, :
- Specify UCTRAN(TRANID) on the TYPETERM definition of terminals that start adapter control functions.
- Specify UCTRAN(NO) on the transaction profile used by all "CKxx" transactions.
Thereafter, the adapter translates all lowercase arguments, except queue names, to uppercase.
For details of TYPETERM and PROFILE definitions, see the CICS Resource Definition Guide.