CEBR - temporary storage browse

Use the CEBR transaction to browse temporary storage queues and to delete them. You can also use CEBR to transfer a transient data queue to temporary storage in order to look at its contents and to re-create the transient data queue when you have finished.

The CEBR commands that perform these transfers allow you to create and delete transient data queues as well. Remember that:

Browsing temporary storage queues retrieves the next record, following whichever record has most recently been retrieved by any active task.
If you are working with the same temporary storage queue at the same time as another task, you might not retrieve the next record.
Transient data queue reads are destructive. If you read a transient data queue that is being used on an active system by applications, it is likely to cause problems.

You start the CEBR transaction by entering the transaction identifier and then the name of the queue you want to browse. For example, to display the temporary storage queue named CEBRS209, you enter CEBR CEBRS209. If the queue name includes lowercase characters, ensure that uppercase translation is suppressed for the terminal you are using and then enter the correct combination of upper and lowercase characters.

CICS responds with a display of the queue, a sample of which is shown in Figure 1.

If you want to use CEBR to display data from a temporary storage queue that has one or more embedded blanks in the queue name, you must enter the queue name in the TS QUEUE field from the CEBR screen, Figure 1. If you type such a queue name immediately after entering CEBR, unpredictable results will occur.

Figure 1. Typical CEBR screen displaying temporary storage queue contents








CEBR  TS QUEUE CEBRS209 SYSID C142 RECORD     1 OF     3    COL     1 OF    22
ENTER COMMAND ===>
     **************************  TOP OF QUEUE  ************************
00001 000055001234000001S209
00002 000056003456000002S209
00003 000102000564000001S209
     *************************  BOTTOM OF QUEUE  **********************












PF1 : HELP              PF2 : SWITCH HEX/CHAR     PF3 : TERMINATE BROWSE
PF4 : VIEW TOP          PF5 : VIEW BOTTOM         PF6 : REPEAT LAST FIND
PF7 : SCROLL BACK HALF  PF8 : SCROLL FORWARD HALF PF9 : UNDEFINED
PF10: SCROLL BACK FULL  PF11: SCROLL FORWARD FULL PF12: UNDEFINED

Alternatively, you can start the CEBR transaction from CEDF. Press PF5 from the initial CEDF screen (see Figure 1) which takes you to the working-storage screen, and then you press PF2 from that screen to browse temporary storage (that is, you invoke CEBR). CEBR responds by displaying the temporary storage queue whose name consists of the four letters ‘CEBR' followed by the four letters of your terminal identifier. CICS uses this same default queue name if you invoke CEBR directly and do not supply a queue name. The result of running CEBR without a queue name or from an EDF session at terminal S21A is shown in Figure 2.

If you enter CEBR from CEDF, you return to the CEDF panel when you press PF3 from the CEBR screen.

Figure 2. Typical CEBR display of default temporary storage queue

CEBR  TS QUEUE CEBRS209 SYSID C142 RECORD     1 OF     0    COL     1 OF  1 0
ENTER COMMAND ===>                                                       2 
**************************  TOP OF QUEUE  *******************************
*************************  BOTTOM OF QUEUE  *****************************




                                                                         3 







TEMPORARY STORAGE QUEUE CEBRS21A            IS EMPTY                     4 
PF1 : HELP              PF2 : SWITCH HEX/CHAR     PF3 : TERMINATE BROWSE 5 
PF4 : VIEW TOP          PF5 : VIEW BOTTOM         PF6 : REPEAT LAST FIND
PF7 : SCROLL BACK HALF  PF8 : SCROLL FORWARD HALF PF9 : UNDEFINED
PF10: SCROLL BACK FULL  PF11: SCROLL FORWARD FULL PF12: UNDEFINED

Header
Command line
Body
Message line
Menu of options

For information about the CEBR temporary storage browse transaction and guidance on using it, see Temporary storage browse (CEBR) .