Current channel example, with XCTL commands

This example shows how a program passes the current channel and its containers to another program using the EXEC CICS XCTL command.

Figure 1 shows four interactive programs. A1 is a top-level program started by, for example, a terminal user. It is not started by a program and does not have a current channel. B1, B2, and B3 are all second-level programs.

B1's current channel is X , passed by the CHANNEL option on the EXEC CICS LINK command issued by A1.

B2 has no current channel, because B1 does not pass it one.

B3's current channel is Y , passed by the CHANNEL option on the EXEC CICS XCTL command issued by B2.

When B3 returns, channel Y and its containers are deleted by CICS.

Figure 1. Current channels—example, with XCTL commands
The picture shows the scenario described in the text.

The following table lists the name of the current channel (if any) of each of the four programs shown in Figure 1.

Table 1. The current channels of interactive programs—example
Program Current channel Issues command
A1 None
.
EXEC CICS LINK PROGRAM(B1) CHANNEL(X)
.
B1 X
.
EXEC CICS XCTL PROGRAM(B2)
.
B2 None
.
EXEC CICS XCTL PROGRAM(B3) CHANNEL(Y)
.
B3 Y
.
EXEC CICS RETURN
.


dfhp3_ch_curxctl.html | Timestamp icon Last updated: Monday, 5 June 2017