READ TS/TD

Syntax

ibmCics.readQ(new ReadQOptions()
  .queue(<Queuename>)
  .into(<Into>)
  [.readQtd(true)]
  [.set(<Set>)]
  [.length(<Length>)]
  [.numItems(<NumItems>)]
  [.next(true)]
  [.item(<Item>)]
  [.sysId(<SysID>)]
  [.noHandle(true)]
);

Parameters

<Queuename>
The queue where the data will be read from.
<Into>
Variable to hold the data read from the queue.
readQtd
Optional Boolean. Set to true to write a transient data queue (TD) instead of a temporary storage (TS) queue. Default is false.
<Set>
Pointer variable containing the address of the record to retrieve.
<Length>
Optional length of the data to be read.
<NumItems>
Optional number of items to be read.
next
Optional Boolean. If set to true, the record to be retrieved is the next sequential record following the last read command.
<Item>
Optional item number of the record to be retrieved from the queue.
<SysID>
Optional system identifier.
noHandle
Optional Boolean. If set to true, exceptions created by this command will be ignored.

Examples

EXEC CICS
    READ TS
        QUEUE(WS-TSQUEUE)
        INTO(WS-TSDATA)
        LENGTH(WS-TSQUEUE-LENGTH)
        ITEM(WS-TSQUEUE-ITEM)
END-EXEC.

ibmCics.readQ(new ReadQOptions()
  .queue(locDef.ws_Tsqueue)
  .into(locDef.ws_Tsdata)
  .length(locDef.ws_Tsqueue_Length)
  .item(locDef.ws_Tsqueue_Item)
);

EXEC CICS
    READ TD
        QUEUE(WS-TDQUEUE)
        INTO(WS-TDDATA)
END-EXEC.

ibmCics.readQ(new ReadQOptions()
  .queue(locDef.ws_Tdqueue)
  .readQtd(true)
  .into(locDef.ws_Tddata)
);