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)
);