Write
The Write function writes a message to a specified queue on an IBM MQ server.
Properties
Section titled “Properties”Host name
Section titled “Host name”The host name or IP address of the IBM MQ server. This is a mandatory field.
The port number the IBM MQ server listens on. The default port is 1414.
Queue manager
Section titled “Queue manager”The name of the IBM MQ queue manager to connect to. This is a mandatory field.
Channel
Section titled “Channel”The server-connection channel used to connect to the queue manager. This is a mandatory field.
Queue name
Section titled “Queue name”The name of the MQ queue to write to. This is a mandatory field.
Security
Section titled “Security”Username
Section titled “Username”The username for authentication. This is a mandatory field.
Password
Section titled “Password”The password for authentication. This is a mandatory field.
Domain
Section titled “Domain”The Windows domain for authentication. Leave blank if not required.
Message
Section titled “Message”The content of the message to write to the queue.
Custom headers
Section titled “Custom headers”A list of custom application headers to include with the message. Each header consists of:
- Name: The header name. Must start with a letter or underscore and contain only letters, digits, underscores, or periods.
- Value: The header value.
Persistence
Section titled “Persistence”Specifies whether the message persists through queue manager restarts.
- NOT_PERSISTENT
The message is not persisted and may be lost if the queue manager restarts. - PERSISTENT
The message is persisted and survives queue manager restarts. - PERSISTENT_AS_QUEUE_DEF (default)
The persistence is determined by the queue’s default configuration.
Character set
Section titled “Character set”The character encoding used to encode the message body.
- IBM037
- ISO_8859_1_Latin1_IBM819 (default)
- IBM850
- Unicode
- UTF
Encoding
Section titled “Encoding”Specifies the numeric encoding of the message. Match these settings to the encoding of the destination system.
Binary encoding
Section titled “Binary encoding”- INTEGER_UNDEFINED
Encoding is unspecified; the queue manager’s default is used. - INTEGER_NORMAL
Big-endian integer encoding, typical of AIX and POWER-based systems. - INTEGER_REVERSED (default)
Little-endian integer encoding, typical of Windows and x86-based systems.
Decimal encoding
Section titled “Decimal encoding”- DECIMAL_UNDEFINED
Encoding is unspecified; the queue manager’s default is used. - DECIMAL_NORMAL
Big-endian packed decimal encoding. - DECIMAL_REVERSED (default)
Little-endian packed decimal encoding.
Floating point encoding
Section titled “Floating point encoding”- FLOAT_UNDEFINED
Encoding is unspecified; the queue manager’s default is used. - IEEE_NORMAL
IEEE 754 big-endian floating point encoding. - IEEE_REVERSED (default)
IEEE 754 little-endian floating point encoding. - S390
IBM System/390 mainframe floating point encoding.
Options
Section titled “Options”Correlation Id
Section titled “Correlation Id”An identifier used to correlate messages. This value is attached to the outgoing message so that consumers can filter for it. Maximum length is 24 characters.
Request Signing (Certificate)
Section titled “Request Signing (Certificate)”Sign with certificate
Section titled “Sign with certificate”Select to enable TLS/SSL certificate authentication when connecting to the IBM MQ server.
When enabled, the following properties are displayed:
Certificate path:
The path to the X.509 client certificate file (.pfx).
Certificate password:
The password for the certificate.
Peer name:
The subject distinguished name (DN) of the server’s certificate, used to verify the server’s identity. The following fields are available:
- Country
- Organization
- Organizational unit
- Common name
- State or province
- Locality
- Email address
- User identifier
Cipher specification:
The cipher specification for the TLS connection. Must match the SSLCIPH value configured on the server-connection channel of the IBM MQ queue manager.
- TLS_RSA_WITH_AES_256_CBC_SHA256 (default)
- ECDHE_RSA_AES_256_GCM_SHA384