CICS READ TSQ

CICS WRITE TSQ CICS DELETE TSQ

Advertisements


Reads data from temporary storage queue.

'

QUEUE(queue-name):

Specifies the QNAME that is to be written.

As specified earlier, the QNAME would be up to 16 characters long.

Temporary Storage Queue can be created with dynamic names to avoid duplicate queues creation.

The name of the Temporary Storage Queue can be created by using the symbolic name provided in application program and the second half would be timestamp of the execution time.

Temporary Storage Queue name would be a combination of symbolic name (Program name most of the cases) and the timestamp (current time portion).

Ex: TEMPPROG11060309

If the QNAME defined in Temporary storage tables and the entry is remote, the request will be transferred to remote system.

If no SYSID is present, then based on the TST definition the Queue will be decided whether it is a local or remote.

If SYSID presents, then system won’t check for TST entries and directly assumes it as a Remote one.

INTO(data-area):

Specifies the data area where the needs to be received from TSQ.

INTO is mandatory in READQ command

SET(Ptr-ref):

Specifies the pointer reference to the data read from TSQ.

In other words, the pointer reference will be valid until the TSQ exists.

Once TSQ deleted, then pointer reference also be deleted.

LENGTH(data-value):

Specifies the length of the data area that is used to read from TSQ.

Length is 2 byte field used to store the length of data area.

ITEM(data-item):

Specifies the item number of the data area that is used to read from TSQ.

Length is 2 byte field used to store the item number of data area.

Item number needs to be passed to read exact data item from the TSQ.

The Maximum item number is 32767.

NEXT:

Specifies the next logical data item that needs to read which is immediately after the last read.

NUMITEMS(data-value):

Specifies the two byte binary field to receive the numbers that indicates how many items pending.

SYSID(sysid-name):

Specifies where the READQ command is to run.

Sysid-name is of 4 characters and used region short name to refer the same.

If no SYSID is present, then based on the TST definition the Queue will be decided whether it is a local or remote.

If SYSID presents, then system won’t check for TST entries and directly assumes it as a Remote one.

Error Conditions:

INVREQ:

Occurs when the queue is locked upon restart.

IOERR:

Occurs when the queue is not available during the I/O operation on file.

.

ITEMERR:

Occurs when the item number specified with READQ is not valid or if queue is read by using READQ TS NEXT for the first time also.

LENGERR:

Occurs when the negative value or zero value specified as LENGTH for READQ.

NOTAUTH:

Occurs when security check is unsuccessful on QUEUE.

QIDERR:

Occurs when the QNAME is not specified by READ TSQ operation.

SYSIDERR:

SYSIDERR occurs in the following conditions.

1. The SYSID provided is down but a valid communications definition entry.

2. The SYSID provided is not valid communications definition entry.

3. The SYSID provided may be a valid communications definitions entry but not configured properly.

4. The SYSID provided may be a valid communications definitions entry but out of service.


If any questions on the above, post your queries on CICS Discussion forum


CICS WRITE TSQ CICS DELETE TSQ

Advertisements