| 1 | Message type | Input | Char(10) |
| 2 | Delivery mode | Input | Char(10) |
| 3 | Message text | Input | Char(*) |
| 4 | Length of message text | Input | Binary(4) |
| 5 | List of user profile or display station names | Input | Array of Char(10) |
| 6 | Number of user profile or display station names | Input | Binary(4) |
| 7 | Message sent indicator | Output | Binary(4) |
| 8 | Function requested | Output | Binary(4) |
| 9 | Error code | I/O | Char(*) |
| 10 | Show Send a Message display | Input | Char(1) |
| 11 | Qualified message queue name | Input | Char(20) |
| 12 | Name type indicator | Input | Char(4) |
| 13 | Coded character set identifier | Input | Binary(4) |
The Send Message (QEZSNDMG) API sends a message to one or more users or display stations and optionally shows the Operational Assistant Send a Message display before sending the message. Parameters can be specified, providing the ability to display initial values (defaults) to the user. Parameters determine:
This API combines the functions of the Send Message (SNDMSG) and Send Break Message (SNDBRKMSG) commands. In addition, it provides the ability to:
This API can be called with or without parameters. If parameters are specified, at least nine parameters are required. If this API is called in a batch job, parameter 10, Show Send a Message display, must be specified with a value of N. This will cause the message to be sent without using the Send a Message display.
Refer to Network Management APIs for information on alert messages. Refer to Message Handling APIs for information on the message handling APIs.
The type of message to send. The value you specify determines the default for the Message needs reply prompt on the Send a Message display (N for *INFO and Y for *INQ). You must specify one of these values:
| *INFO | Informational. The message does not need a reply. |
| *INQ | Inquiry. The message needs a reply. If the message queue and library name parameter was specified, the reply is placed on that message queue; otherwise, the reply is placed on the message queue specified in the user profile of the sender. |
| The user profile name of the person sending the reply is added to the beginning of the message text, allowing the person receiving the reply to determine which user it is from. |
The delivery mode of the message. The value you specify determines the default for the Interrupt user prompt on the Send a Message display (Y for *BREAK and N for *NORMAL). If the user is not authorized to send a break message, *NORMAL is used regardless of the value you specify. You must specify one of these values:
| *BREAK | Break message. If the user is signed on, the message goes to the work station message queues that the user is signed on to and temporarily interrupts the work that the user is doing. If the user is not signed on, the message goes to the user profile message queue and the sender is notified. If display station names are specified, the message goes to the message queues for the specified display stations. |
| *NORMAL | The message goes to the user profile or display station message queue. If the message queue is in notify mode for that user, the message waiting light is turned on. If the message queue is in break mode, the message temporarily interrupts the work that the receiver is doing. If the message queue is in hold mode, the receiver is not notified. |
The complete text of the message. The text you specify is displayed as the default on the Send a Message display. This must not be blank if used in a batch job or if the Show Send a Message display parameter is N.
The length of the message text, in bytes. Valid values are 0 through 494. This must be greater than 0 if the API is used in a batch job or if the Send a Message display is not to be shown.
A list of 0 through 299 user profile or display station names to which the message is being sent. The list you specify is shown as the default on the Send a Message display.
The name type indicator parameter indicates whether the names in the list are user profile names or display station names; the default is user profile names. At least one name must be specified if the API is used in a batch job or if the Send a Message display is not to be used.
The message is sent to the user profile or display station message queue. To specify other user message queues, use one of the following special values:
| *ALL | The message queues of all users. When you use this value, it must be the only item in the list. This value cannot be used if *DSP is specified for the name type indicator parameter. |
| *ALLACT | The message queues of all active users or display stations. This value can be used in combination with specific user profile names or display station names and with *SYSOPR. |
| *SYSOPR | The system operator's message queue, QSYSOPR. This value can be used in combination with specific user profile names and with *ALLACT. It cannot be used if *DSP is specified for the name type indicator parameter. |
If the list specifies display station names, the library list will be used to find the work station message queues.
Note: *JOBCTL special authority is required to use the *ALL or *ALLACT value in this parameter.
The number of user profile or display station names specified. Valid values are 0 through 299. When you use the special value *ALL for the list of user profile or display station names parameter, specify 1. This must be greater than 0 if the API is used in a batch job or if the Send a Message display is not to be used.
Whether the user pressed F10 (Send message) to send one or more messages from the Send a Message display. One of the following values is returned:
| 0 | No messages were sent. |
| 1 | One or more messages were sent. If the Show Send a Message display parameter is N and the program completes without error, this will always be 1. |
| 2 | One or more messages were sent, but one or more of the names specified were not valid. If the Show Send a Message display parameter is Y or not specified, the user names will be displayed and validated before the message is sent; therefore, this value will not be used. |
The function that the user requested when exiting the Send a Message display. One of the following values is returned:
| -4 | User pressed the Exit key (F3). |
| -8 | User pressed the Cancel key (F12). |
| 0 | Send a Message display was not used. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
Whether or not to show the Send a Message display before sending the message. If this parameter is used, one of the following values must be specified;
| Y | Use the Send a Message display. This is the default. |
| N | Do not use the Send a Message display. This value must be specified if the program is running in a batch job. |
The name of the message queue that is to receive the reply for inquiry-type messages. The first 10 characters contain the message queue name, and the second 10 characters contain the library name. If this parameter is blank or not specified, the reply will be sent to the message queue specified in the user profile of the sender. This parameter is ignored if the message type parameter is not *INQ. If this parameter is used, you can use these special values for the library name:
| *LIBL | The library list |
| *CURLIB | The job's current library |
The type of names in the list. If this parameter is used, one of the following values must be specified:
| *USR | The list of names contains only user profile names. *USR is the default. |
| *DSP | The list of names contains only display station names. This value may not be specified if the Show Send a Message display parameter is Y. |
The coded character set identifier (CCSID) that the immediate message text is in. The following values are allowed:
| 0 | The immediate message text is assumed in the CCSID of the job running this API. This is the default value if this parameter is not specified. |
| 65535 | The immediate message text will not be converted. |
| CCSID | Specify a valid CCSID that your immediate message
is in. Valid values are between 1 and 65535. This API will validate the CCSID.
For a list of valid CCSIDs, see the i5/OS globalization topic collection. |
| Message ID | Error Message Text |
|---|---|
| CPF1EA0 E | Not authorized to send message to *ALL or *ALLACT. |
| CPF1EBA E | Parameters passed on CALL do not match those required. |
| CPF1EBB E | Value &1 not valid for list of display station names. |
| CPF1EBC E | At least one user or display station must be specified. |
| CPF1EBD E | Message text cannot be blank. |
| CPF1EBE E | Display station names cannot be used with the Send a Message display. |
| CPF1EBF E | Value for Use Send a Message display not valid |
| CPF1EB2 E | Delivery mode must be *BREAK or *NORMAL. |
| CPF1EB3 E | Value for length of message text must be 0 through 494. |
| CPF1EB4 E | Number of user profile names not valid. |
| CPF1EB5 E | Value for number of user profile names must be 0 through 299. |
| CPF1EB6 E | Program &1 cannot be run as a batch job. |
| CPF1EB7 E | *ALL not allowed with other user profile names. |
| CPF1EB8 E | Value &1 for name type indicator not valid. |
| CPF1EB9 E | Value &1 not valid for list of user profile names. |
| CPF1E99 E | Unexpected error occurred. |
| CPF24B3 E | Message type &1 not valid. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF2403 E | Message queue &1 in &2 not found. |
| CPF2408 E | Not authorized to message queue &1. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF9871 E | Error occurred while processing. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
[ Back to top | Operational Assistant APIs | APIs by category ]