The Send Data Queue Entry (SNDDTAQXCL) command sends an entry to the specified data queue. The data queue can be either local or remote.

This function is also available with command SNDDTAQE in library VC2XCL. Any use of this alternative command name should be library qualified in case the i operating system were to use this command name in a future release.

Restrictions:

• You must have *EXECUTE authority to the library where the data queue is located.
• You must have *OBJOPR and *ADD authority to the data queue.

Parameters

Data queue (DTAQ)

Specifies the qualified name of the data queue to be used.

This is a required parameter.

Qualifier 1: Data queue

*LIBL

The library list for the job is used.

*CURLIB

The current library for the job is used. If no current library entry exists in the library list, QGPL is used.

name

Specify the name of the library.

Data (DTA)

Specifies data to be sent to the data queue.

character-value

Specify the data queue entry to be sent.

Data length (DTALEN)

Specifies the length of the data queue entry being sent.

*DTA

The length of the data queue entry is the blank trimmed length of the DTA parameter.

decimal-number

Specify the number of bytes to be sent. If this value is less than the blank trimmed length of the DTA parameter then only this number of bytes will be sent. If this value is greater than the blank trimmed length of the DTA parameter then an *INFO message will be logged and only the blank trimmed value of DTA will be sent.

Key data (KEY)

Specifies the data queue key to be associated with the data queue entry. If the provided key value length is less in size than the key length defined for the data queue then blank padding will be added to the key value. If the provided key value length is greater than the key length defined for the data queue then the key value will be truncated to the required length of the data queue key.

This parameter is only used if the data queue was created as a keyed queue.

character-value

Specify the key of the data queue entry.

Examples for SNDDTAQXCL

Example 1: Sending a Non-Keyed Entry

SndDtaQXCL DtaQ(QTEMP/TEST) Dta(&MyData)

This command sends the contents of CL variable &MyData to data queue TEST in library QTEMP.

Example 2: Sending a Keyed Entry

SndDtaQXCL DtaQ(QTEMP/TEST) Dta(&MyData) Key(&MyKey)

This command sends the contents of CL variable &MyData to the keyed data queue TEST in library QTEMP. The value of CL variable &MyKey is used as the key for the entry. This key is later used to receive the data queue entry.

Error messages for SNDDTAQXCL

*ESCAPE Messages

XCL9002

Function did not complete. See previously listed messages related to possible user errors.

XCL9003

Function did not complete. See previously listed messages for possible cause.

XCL9004

Function did not complete. See previously listed messages for possible cause.

XCL9005

Function did not complete. Contact your service provider.