Displaying the contents of channels and containers
You can display the contents of CICS® channels
by using the DESCRIBE CHANNEL command and the contents
of a container by using the LIST CONTAINER command.
The section "Enhanced inter-program data transfer: channels as modern-day COMMAREAs" in the CICS Application Programming Guide describes the benefits of containers and channels and how to use them in your programs.
To display a list of containers in the current channel, enter the
command DESCRIBE CHANNEL. To display a list of containers
in another channel, enter the command DESCRIBE CHANNEL channel_name,
where channel_name is the name of a specific
channel. In either case, z/OS® Debugger displays
a list similar to the following list:
COBOL LOCATION: ZCONPRGA :> 274
Command ===> Scroll ===> PAGE
MONITOR -+----1----+----2----+----3----+----4----+----5----+----6- LINE: 1 OF 2
******************************* TOP OF MONITOR ********************************
----+----1----+----2----+----3----+----4----
0001 1 ********** AUTOMONITOR **********
0002 01 DFHC0160 'PrgA-ChanB-ContC'
****************************** BOTTOM OF MONITOR ******************************
SOURCE: ZCONPRGA -1----+----2----+----3----+----4----+----5--- LINE: 272 OF 307
272 * FLENGTH(LENGTH OF PrgA-ChanB-XXXXX) .
273 * END-EXEC .
274 Move 'PrgA-ChanB-ContC' to dfhc0160 .
275 Move 'PrgA-CHANB' to dfhc0161 .
276 Call 'DFHEI1' using by content x'341670000720000002000000 .
277 - '00f0f0f0f5f3404040' by content x'0000' by reference .
278 PrgA-ChanB-XXXXX by reference dfhc0160 by content LENGTH .
279 PrgA-ChanB-XXXXX by content x'0000' by content x'0000' by .
280 content x'0000' by content x'0000' by content x'0000' by .
281 content x'0000' by content x'0000' by content x'0000' by .
282 content x'0000' by content x'0000' by content x'0000' by .
283 content x'0000' by content x'0000' by content x'0000' by .
LOG 0----+----1----+----2----+----3----+----4----+----5----+-- LINE: 147 OF 289
0147 DESCRIBE CHANNEL * ;
0148 CHANNEL PrgA-ChanB
0149 CONTAINER NAME SIZE
0150 ------------------------------------
0151 PrgA-ChanB-ContC 21
0152 PrgA-ChanB-ContB 21
0153 PrgA-ChanB-ContA 21
0154 CHANNEL PRGA-CHANA
0155 CONTAINER NAME SIZE
0156 ------------------------------------
0157 PRGA-CHANA-CONTC 21
PF 1:? 2:STEP 3:QUIT 4:LIST 5:FIND 6:AT/CLEAR
PF 7:UP 8:DOWN 9:GO 10:ZOOM 11:ZOOM LOG 12:RETRIEVETo display the contents of a container in the current channel,
enter the command LIST CONTAINER container_name,
where container_name is the name of a particular
channel. To display the contents of a container in another channel,
enter the command LIST CONTAINER channel_name container_name,
where channel_name is the name of another
channel. In either case, z/OS Debugger displays
the contents of the container in a format similar to the following
diagram:
COBOL LOCATION: ZCONPRGA :> 211.1
Command ===> Scroll ===> PAGE
MONITOR -+----1----+----2----+----3----+----4----+----5----+----6- LINE: 1 OF 2
******************************* TOP OF MONITOR ********************************
----+----1----+----2----+----3----+----4----
0001 1 ********** AUTOMONITOR **********
0002 01 DFHC0160 'PRGA-CHANA-CONTC'
****************************** BOTTOM OF MONITOR ******************************
SOURCE: ZCONPRGA -1----+----2----+----3----+----4----+----5--- LINE: 209 OF 307
209 * FLENGTH(LENGTH OF PrgA-ChanB-ContA) .
210 * END-EXEC .
211 Move 'PrgA-ChanB-ContA' to dfhc0160 .
212 Move 'PrgA-ChanB' to dfhc0161 .
213 Call 'DFHEI1' using by content x'341670000720000002000000 .
214 - '00f0f0f0f3f5404040' by content x'0000' by reference .
215 PrgA-ChanB-ContA by reference dfhc0160 by content LENGTH .
216 PrgA-ChanB-ContA by content x'0000' by content x'0000' by .
217 content x'0000' by content x'0000' by content x'0000' by .
218 content x'0000' by content x'0000' by content x'0000' by .
219 content x'0000' by content x'0000' by content x'0000' by .
220 content x'0000' by content x'0000' by content x'0000' by .
LOG 0----+----1----+----2----+----3----+----4----+----5----+---- LINE: 15 OF 25
0015 STEP ;
0016 DESCRIBE CHANNEL * ;
0017 CHANNEL PRGA-CHANA
0018 CONTAINER NAME SIZE
0019 ------------------------------------
0020 PRGA-CHANA-CONTC 21
0021 PRGA-CHANA-CONTB 21
0022 PRGA-CHANA-CONTA 21
0023 LIST CONTAINER PRGA-CHANA PRGA-CHANA-CONTC ;
0024 000C7F78 D7D9C7C1 60C3C8C1 D5C160C3 D6D5E3C3 *PRGA-CHANA-CONTC*
0025 000C7F88 60C4C1E3 C1 *-DATA *
PF 1:? 2:STEP 3:QUIT 4:LIST 5:FIND 6:AT/CLEAR
PF 7:UP 8:DOWN 9:GO 10:ZOOM 11:ZOOM LOG 12:RETRIEVERefer to the following topics for more information related to the material discussed in this topic.
- Related references
- DESCRIBE CHANNEL command in IBM® z/OS Debugger Reference and Messages
- LIST CONTAINER command in IBM z/OS Debugger Reference and Messages