Write data to transient data queue.
WRITEQ TD
>>-WRITEQ TD--QUEUE(name)--FROM(data-area)---------------------->
>--+--------------------+--+-------------------+---------------><
'-LENGTH(data-value)-' '-SYSID(systemname)-'
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.