From CICS application programs

You can use the EXEC CICS(R) LINK command to invoke most adapter control functions from CICS application programs. The syntax of the EXEC CICS LINK commands you need, and examples, are given for each task described later in this chapter.

Command syntax in application programs

Some commands issued in this way must be padded with trailing spaces to make the length of the command 10 characters. When an argument follows the command, an extra space character must be added as a separator (see Figure 6). The commands affected by this restriction and the number of trailing spaces required for each command are as follows:

Command Number of trailing spaces (not including the separator)
START 5
MODIFY 4
STARTCKTI 1
STOPCKTI 2

With all other commands the padding is optional.

Figure 6. Padding adapter commands. The MODIFY command must be padded with 4 trailing spaces plus another space as a separator. Starting at the 'M' in MODIFY, the argument 'Y' is the twelfth character.
 EXEC CICS LINK PROGRAM('CSQCRST ')
           INPUTMSG('CKQC MODIFY     Y')
                          ^          ^
                          ............
                          1          12
Note:
This restriction applies only to commands issued from an application program; it does not apply to commands issued from the command line.

Passing parameters from a CICS transaction

Use the following rules to determine how to pass the parameters:

EXEC CICS LINK interface messages

If you invoke the adapter operation functions START and STOP from an application program using EXEC CICS LINK, the resultant messages are written to both the system console and a transient data queue (TDQ) named CKQQ. When the application program returns from the LINK, it can read back the messages by repeating EXEC CICS READQ TD QUEUE(CKQQ) until the queue is empty. The following restrictions apply: