CICS WRITE TSQ

CICS Temporary Storage Queue CICS READ TSQ

Advertisements


Writes the data to a 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.

FROM(data-area):

Specifies the data area layout from where it needs to be written to TSQ

LENGTH(data-value)

Specifies the length of the data area that is used to write in to TSQ

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

ITEM(data-number)

Specifies the item number of the data area that is used to write in to TSQ

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

Item number can be incremented based on the order of the data area written to TSQ

If REWRITE is specified, the data with item number replaces with the data area specified in WRITE.

The Maximum item number is 32767.

REWRITE

If REWRITE is specified, the data with item number replaces with the data area specified in WRITE.

SYSID(sysid-name):

Specifies where the WRITEQ 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.

AUXILIARY:

Specifies the queue is written on the direct access storage in auxiliary memory.

MAIN:

Specifies the queue is written on the main storage.

NOSUSPEND

Specifies that application program is not to suspend the TSQ when NOSPACE error occurred.

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 REWRITE is not actually available in TSQ.

LENGERR:

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

NOSPACE:

Occurs when no space is available to write the data to the TSQ.

NOTAUTH:

Occurs when security check is unsuccessful on QUEUE.

QIDERR:

Occurs when the QNAME is not specified by WRITE TSQ or for the REWRITE opertions.

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 Temporary Storage Queue CICS READ TSQ

Advertisements