MEM4 gate, SEND_MESSAGE function

The SEND_MESSAGE function of the MEM4 gate is used to send a message that uses data in 64-bit storage to one or more destinations.

Input Parameters

MESSAGE_NUMBER
The numeric message identifier.
COMPONENT_ID
Optional Parameter
The component identifier for the message.
IGNORE_EXCEPTIONS
Optional Parameter
Specifies whether the caller requests that a failure sending a message to a transient data destination is to be ignored.
INSERTn
Optional Parameter
A user-supplied 64-bit insert, if required by the message definition.
MSGTABLE
Optional Parameter
Indicates that the feature message table is to be used.
NETNAME
Optional Parameter
A new network name that overrides the network name that the message domain obtains.
NOREROUTE
Optional Parameter
Indicates that the message cannot be rerouted.
PRODUCT
Optional Parameter
An optional product identifier.
RESTART_CICS
Optional Parameter
Specifies whether the caller requests CICS to be restarted. The parameter can take the following values:
  • NO
  • YES
SYSTEM_DUMPCODE
Optional Parameter
The dump code to use when the message domain requests a dump on behalf of its caller.
TDQUEUES
Optional Parameter
A 64-bit block that contains the names of the message destinations.
TERMID
Optional Parameter
A new terminal identifier that overrides the terminal identifier that the message domain obtains.
TERMINATE_CICS
Optional Parameter
Specifies whether the caller requests CICS to be terminated. Values for the parameter are:
  • NO
  • YES
TRANID
Optional Parameter
A new transaction identifier that overrides the transaction identifier that the message domain obtains.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • EYU_TABLE_MISSING
  • INSUFFICIENT_STORAGE
  • INVALID_MODULE_PTR
  • INVALID_TEMPLATE
  • NO_STORAGE_FOR_WTO
The following values are returned when RESPONSE is INVALID:
  • INVALID_COMPONENT_TYPE
  • INVALID_DBCS_FORMAT
  • INVALID_DESTINATION
  • INVALID_FUNCTION
  • INVALID_INSERT
  • INVALID_MEFO_RESPONSE
  • MESSAGE_NOT_FOUND
  • MESSAGE_SET_NOT_FOUND
  • MISSING_INSERT
  • OPT_INSERT_NOT_FOUND
  • RETRY_MSG_LOCATE
The following values are returned when RESPONSE is PURGED:
  • TDQ_PURGED
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
RESP2
Optional Parameter
Second response code.
SEVERITY
Optional Parameter
The message severity.


dfhs3_MEM4send_message.html | Timestamp icon Last updated: Monday, 5 June 2017