| 1 | Receiver variable | Output | Char(*) |
| 2 | Length of receiver variable | Input | Binary(4) |
| 3 | Format name | Input | Char(8) |
| 4 | Message identifier | Input | Char(7) |
| 5 | Qualified message file name | Input | Char(20) |
| 6 | Message data | Input | Char(*) |
| 7 | Length of message data | Input | Binary(4) |
| 8 | Message type | Input | Char(10) |
| 9 | Message wait timeout | Input | Binary(4) |
| 10 | Message key | Input | Char(4) |
| 11 | Writer handle | Input | Char(16) |
| 12 | Coded character set identifier | Input | Binary(4) |
| 13 | Error code | I/O | Char(*) |
The Send Writer Message (QSPSNDWM) API is used by a driver exit program to send either an informational or inquiry message to the writer's message queue.
When an inquiry message is issued, the writer goes into message wait status and waits the specified number of seconds. When the message is answered, or the timeout value has been reached, the API clears the message wait status and returns to its caller. The answer to the inquiry message is returned through the receiver variable parameter.
When an informational message is issued, the API sets the status of the writer to message wait and returns to the caller. The API's caller must then call the API to clear the message wait status.
None.
The receiver variable that receives the information requested. You can specify the size of the area to be smaller than the format requested as long as you specify the length parameter correctly. As a result, the API returns only the data that the area can hold.
The length of the receiver variable provided. The length of receiver variable parameter may be specified up to the size of the receiver variable specified in the user program. If the length of receiver variable parameter specified is larger than the allocated size of the receiver variable specified in the user program, the results are not predictable. The minimum length is 8 bytes.
The format of the writer message data returned.
| SNDM0100 | Contains the information about the message and its reply. |
The message identifier of the message to issue.
The name of the message file in which the message resides. The first 10 characters contain the message file name and the second 10 characters contain the name of the library in which the message file is located. If this field is blank, the system message file (QCPFMSG) is used.
The following special values are supported for the library name:
| *LIBL | The library list of the writer job is used to locate the message file. |
| *CURLIB | The current library for the writer job is used to locate the message file. |
The data to insert in the predefined message's substitution variables
The length of the message data in bytes. Value values are 1 through 512 bytes.
The type of the message.
The Values are:
| *INFO | The message to be sent is an informational message. |
| *INQ | The message to be sent is an inquiry message. |
The number of seconds to wait for a reply to an inquiry message. Any number greater than 0 is valid. This parameter is only used for inquiry messages. It is ignored for informational messages. The following special value is supported for this parameter.
| -1 | The maximum wait time is be used. |
Note: This parameter is only used for inquiry messages. It is ignored for informational messages.
The key of the message whose wait status is cleared. This field is blank when a message is being sent.
The handle to the writer job. This handle is provided to the driver program on a writer call to the driver exit program during initialization.
The coded character set identifier used to convert the message data supplied as replacement text for message fields that correspond to *CCHAR type fields. The data supplied that does not correspond to a *CCHAR field is 65535 and is not converted. For more information about *CCHAR type fields, see the Add Message Description (ADDMSGD) command.
The following values are allowed:
| 0 | The message data is assumed in the CCSID of the job running this API. This is the default value if this parameter is not specified. |
| 65535 | The message data is not be converted. |
| CCSID | Specify a valid CCSID that your replacement data or impromptu
message is in. Valid values are between 1 and 65535. This API validates the
CCSID.
For a list of valid CCSIDs, see the i5/OS globalization topic collection. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
The following table shows the information returned for the SNDM0100 format. For more details about the fields in the following table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Bytes returned |
| 4 | 4 | BINARY(4) | Bytes available |
| 8 | 8 | CHAR(4) | Message key |
| 12 | C | CHAR(16) | Reserved |
| 28 | 1C | BINARY(4) | Offset to message reply text |
| 32 | 20 | BINARY(4) | Length of message reply text returned |
| 36 | 24 | BINARY(4) | Length of message reply text available |
| CHAR(*) | Message reply text | ||
Bytes available. The number of bytes of data available to be returned. All available data is returned if enough space is provided.
Bytes returned. The number of bytes of data returned.
Length of message reply text available. The length of the message reply text that is available. This length is zero (0) for informational messages or when the message wait timeout value was reached.
Length of message reply text returned. The length of the message reply text that is returned in the message reply text. This length is zero (0) for informational messages or when the message wait timeout value was reached.
Message key. The key of the message issued. This can be used with message handler APIs to perform various functions.
Message reply text. The text of the reply received from the inquiry message.
Offset to message reply text. The offset to the message reply text, in bytes.
Reserved. The field is reserved.
| Message ID | Error Message Text |
|---|---|
| CPF24A8 E | Value for wait time not valid. |
| CPF24B3 E | Message type &1 not valid. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF247E E | CCSID &1 is not valid. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3C19 E | Error occurred with receiver variable specified. |
| CPF3C1D E | Length specified in parameter &1 not valid. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C4B E | Value not valid for field &1. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF33CC E | No writer found for specified handle &1. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
[ Back to top | Print APIs | APIs by category ]