WRITEQ TD
Write data to transient data queue.
Syntax
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.
NOHANDLE, RESP, and
RESP2 are common options that can be added to all EXEC CICS
commands to process error conditions. They are not explicitly included in the command syntax diagram
and option descriptions. For information about these common options and EXEC CICS
command syntax, see EXEC CICS command format and programming considerations.
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
- RESP2 values:
- 101
- A resource security check has failed on QUEUE(name).
- 102
- A surrogate security check has failed. For more information, see Security for submitting a JCL job to the internal reader.
- 6.2 and later 103
- Occurs when a program tries to write to a queue that is restricted to CICS internal use only.
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.