WRITEQ TS

This command is used to write transient data to a predefined symbolic destination. The destination (queue) is identified in the QUEUE option.

WRITEQ TS

[ QUEUE(qname) | QNAME(qname) ]
FROM(area)
[ LENGTH(len) ]
[ ITEM(itemno) ]
[ REWRITE ]
[ MAIN | AUXILIARY ]
[ SYSID(systemname) ]

Options

FROM (area)

specifies the data to be written to temporary storage.

ITEM (itemno)

specifies, as a halfword binary value, the item number of the logical record to be replaced in the queue (REWRITE option also specified).

LENGTH (len)

specifies the length (halfword binary) of the data area specified in the FROM option.

QUEUE(qname) | QNAME(qname)

specifies the symbolic name (1-8 alphanumeric characters) of the queue to be deleted. The name must be unique within the XCICS system.

REWRITE

specifies that the existing record in the queue is to be overwritten with the data provided. If the REWRITE option is specified, the ITEM option must also be specified. If the specified queue does not exist, the QIDERR condition occurs. If the correct item within an existing queue cannot be found, the ITEMERR condition occurs and the data is not stored.

SYSID(systemname)

(remote systems only) specifies the name (1-4 characters) of the system the request is directed.

AUXILIARY

specifies that the temporary storage queue is on a direct access storage device in auxiliary storage (accepted but not supported)

MAIN

specifies that the temporary storage queue is in main storage (accepted but not supported).