WRITEQ TD
Write data to transient data queue.
Conditions: DISABLED, ERROR, INVREQ, IOERR, ISCINVREQ, LENGERR, LOCKED, NOSPACE, NOTAUTH, NOTOPEN, QIDERR, SYSIDERR
This command is threadsafe when it is used with a queue in a local CICS® region, or function shipped to a remote CICS region over an IPIC connection. It is non-threadsafe when it is function shipped to a remote CICS region over another type of connection.
Description
WRITEQ TD writes transient data to a predefined symbolic destination.
Options
- FROM(data-area)
- Specifies the data that is to be written to the transient data queue.
- LENGTH(data-value)
- Specifies the length (halfword binary value) of the data to be written.
- QUEUE(name)
- Specifies the symbolic name (1 - 4 alphanumeric characters) of the queue to which the data is written. The named queue must have been defined to CICS.
- SYSID(systemname)
- (remote
systems only) Specifies the name (1 - 4 characters) of the system
to which the request is directed.
If SYSID is specified, the queue is assumed to be on a remote system whether or not it is defined as remote. Otherwise the transient data queue definition is used to find out whether the data set is on a local or a remote system.
Conditions
- 84 DISABLED
- Occurs
when the queue has been disabled.
Default action: terminate the task abnormally.
- 1 ERROR
- Occurs for an error that does not raise any other condition.
Default action: terminate the task abnormally.
- 16 INVREQ
- Occurs
if WRITEQ names an extrapartition queue that has been opened for input.
Note: This condition cannot be raised for intrapartition queues.
Default action: terminate the task abnormally.
- 17 IOERR
- Occurs
when an input/output error occurs and the data record in error is
skipped.
Default action: terminate the task abnormally.
- 54 ISCINVREQ
- Occurs
when the remote system indicates a failure that does not correspond
to a known condition.
Default action: terminate the task abnormally.
- 22 LENGERR
- Occurs
in either of the following situations:
- WRITEQ names an extrapartition queue and does not specify a length consistent with the RECORDSIZE and associated formations specified in the TDQUEUE resource definition. The check is made after the XTDOUT exit has been invoked; this exit may change the length of the data to be passed to the access method.
- WRITEQ names an intrapartition queue and does not specify a length consistent with the control interval defined for the intrapartition data set. Again, the check is made after the XTDOUT exit has been invoked.
Default action: terminate the task abnormally.
- 100 LOCKED
- Occurs
when the request cannot be performed because use of the queue has
been restricted owing to a unit of work failing indoubt. This can
happen on any request for a logically-recoverable queue defined with
WAIT(YES) and WAITACTION(REJECT) in the TDQUEUE resource definition.
Specify WAIT(YES) and WAITACTION(QUEUE) in the TDQUEUE resource definition if you want the transaction to wait.
Default action: terminate the task abnormally.
- 18 NOSPACE
- Occurs
if no more space exists on the intrapartition or extrapartition queue,
or the relative byte address (RBA) for an intrapartition queue would
exceed 2 GB. When this happens, no more data should be written to
the queue because it may be lost.
Default action: terminate the task abnormally.
- 70 NOTAUTH
- Occurs
when a resource security check has failed on QUEUE(name).
Default action: terminate the task abnormally.
- 19 NOTOPEN
- Occurs
if the destination is closed. Note: This condition cannot be raised for intrapartition queues.
Default action: terminate the task abnormally.
- 44 QIDERR
- Occurs
if the symbolic destination to be used with a transient data control
command cannot be found.
Default action: terminate the task abnormally.
- 53 SYSIDERR
- Occurs
when the SYSID option specifies a name that is neither the local system
nor a remote system (made known to CICS by
defining a CONNECTION or an IPCONN). SYSIDERR also occurs
when the link to the remote system is closed.
Default action: terminate the task abnormally.