Starting a connection from a CICS application program

We can start a connection by linking the adapter connect program, CSQCQCON, from a CICS application program. Your program, which can be written in C, COBOL, PL/I, or assembler language, must pass a parameter list that specifies the connection values to be used. The parameter list is:

CKQC

4-character transaction ID--must be

'CKQC'.

DISPMODE

1-byte field--must contain a blank.

CONNREQ

10-character field--must contain

'START '.

DELIM1

1-byte delimiter field--must contain a blank.

INITP

1-character field that specifies whether this connection is to use the default parameters set by INITPARM. The possible values are:

Y

Use the default values, that is, substitute default values for any blank arguments.

N

Do not use the default values. If you specify 'N', supply all the new connection values, to override the INITPARM settings, in the CONNSSN, CONNTN, and CONNIQ fields.

' '

Equivalent to 'Y'.

DELIM2

1-byte delimiter field--must contain a blank.

CONNSSN

4-character field used to specify the z/OS subsystem name of the target queue manager.

This must be the name of a queue manager, not a queue-sharing group.

DELIM3

1-byte delimiter field--must contain a blank.

CONNTN

3-character trace number. If supplied, it must be in the range zero through 199.

DELIM4

1-byte delimiter field--must contain a blank.

CONNIQ

48-character field that specifies the name of the default initiation queue.

Figure 12 shows the LINK command that your CICS program must issue.

Figure 12. Linking to the adapter connect program, CSQCQCON, from a CICS program. In this example, the name of the parameter list is CONNPL.

EXEC CICS LINK PROGRAM('CSQCQCON')
          INPUTMSG(CONNPL) INPUTMSGLEN(length of CONNPL)

Output messages from CSQCQCON are displayed on the system console.