Samples for UNIX and Linux systems
The techniques demonstrated by the sample programs for IBM MQ on UNIX and Linux systems.
See Preparing and running sample programs on UNIX and Linux to find out where the sample programs for IBM MQ on UNIX and Linux systems are stored.
Table 1 The table lists which C and COBOL source files are provided, and whether a server or client executable is included.|
Technique |
C (source) (1) | COBOL (source) (2) | Server (C executable) | Client (C executable) |
|---|---|---|---|---|
| Use the publish/subscribe interface | amqspuba amqssuba amqssbxa | no sample | amqspub amqssub amqssbx | no sample |
| Put messages using the MQPUT call | amqsput0 | amq0put0 | amqsput | amqsputc |
| Put a single message using the MQPUT1 call | amqsinqa amqsecha | amqminqx amqmechx amqiinqx amqiechx | amqsinq amqsech | amqsechc |
| Put messages to a distribution list (3) | amqsptl0 | amq0ptl0.cbl | amqsptl | amqsptlc |
| Replying to a request message | amqsinqa | amqminqx amqiinqx | amqsinq | no sample |
| Getting messages using browse (no wait) | amqsgbr0 | amq0gbr0 | amqsgbr | no sample |
| Getting messages (wait with a time limit) | amqsget0 | amq0get0 | amqsget | amqsgetc |
| Getting messages (unlimited wait) | amqstrg0 | no sample | amqstrg | amqstrgc |
| Getting messages (with data conversion) | amqsecha | no sample | amqsech | no sample |
| Put Reference Messages to a queue (3) | amqsprma | no sample | amqsprm | amqsprmc |
| Getting Reference Messages from a queue (3) | amqsgrma | no sample | amqsgrm | amqsgrmc |
| Reference Message channel exit (3) | amqsqrma amqsxrma | no sample | amqsxrm | no sample |
| Browsing first 20 characters of a message | amqsgbr0 | amq0gbr0 | amqsgbr | amqsgbrc |
| Browsing complete messages | amqsbcg0 | no sample | amqsbcg | amqsbcgc |
| Use a shared input queue | amqsinqa | amqminqx amqiinqx | amqsinq | amqsinqc |
| Use an exclusive input queue | amqstrg0 | amq0req0 | amqstrg | amqstrgc |
| Use the MQINQ call | amqsinqa | amqminqx amqiinqx | amqsinq | no sample |
| Use the MQSET call | amqsseta | amqmsetx amqisetx | amqsset | amqssetc |
| Use a reply-to queue | amqsreq0 | amq0req0 | amqsreq | amqsreqc |
| Requesting message exceptions | amqsreq0 | amq0req0 | amqsreq | no sample |
| Accepting a truncated message | amqsgbr0 | amq0gbr0 | amqsgbr | no sample |
| Use a resolved queue name | amqsgbr0 | amq0gbr0 | amqsgbr | no sample |
| Triggering a process | amqstrg0 | no sample | amqstrg | amqstrgc |
| Use data conversion | ( 4 ) | no sample | no sample | no sample |
| IBM MQ (coordinating XA-compliant database managers) accessing a single database using SQL | amqsxas0.sqc Db2 amqsxas0.ec Informix | amq0xas0.sqb | no sample | no sample |
| IBM MQ (coordinating XA-compliant database managers) accessing two databases using SQL |
amqsxag0.c amqsxab0.sqc amqsxaf0.sqc |
amq0xag0.cbl amq0xab0.sqb amq0xaf0.sqb |
no sample | no sample |
| CICS transaction (5) | amqscic0.ccs | no sample | amqscic0 | no sample |
| Encina transaction (3) | amqsxae0 | no sample | amqsxae0 | no sample |
| TUXEDO transaction to put messages 6) | amqstxpx | no sample | no sample | no sample |
| TUXEDO transaction to get messages ( 6) | amqstxgx | no sample | no sample | no sample |
| Server for TUXEDO (6) | amqstxsx | no sample | no sample | no sample |
| Dead-letter queue handler | Directory ./tools/c/Samples/dlq (7) | no sample | amqsdlq | no sample |
| From an MQI client, putting a message | no sample | no sample | no sample | amqsputc |
| From an MQI client, getting a message | no sample | no sample | no sample | amqsgetc |
| Connect to the queue manager using MQCONNX | amqscnxc | no sample | no sample | amqscnxc |
| Use API exits | amqsaxe0 | no sample | amqsaxe | no sample |
| Cluster workload balancing exit | amqswlm0 | no sample | amqswlm | no sample |
| Put messages asynchronously and getting status using the MQSTAT call | amqsapt0 | no sample | amqsapt | amqsaptc |
| Reconnectable clients |
amqsphac amqsghac amqsmhac |
no sample | not applicable |
amqsphac amqsghac amqsmhac |
| Use message consumers to asynchronously consume messages from multiple queues | amqscbf0 | no sample | amqscbf | amqscbfc |
| Specify TLS connection information on MQCONNX | amqssslc | no sample | not applicable | amqssslc |
- The executable version of the IBM MQ MQI client samples share the same source as the samples that run in a server environment.
- Compile programs beginning 'amqm' with the Micro Focus COBOL compiler, those beginning 'amqi' with the IBM COBOL compiler, and those beginning 'amq0' with either.
- Supported on IBM MQ for AIX only.
- On IBM MQ for AIX this program is called amqsvfc0.c
- CICS is supported by IBM MQ for AIX only.
- TUXEDO is not supported by IBM MQ for Linux on System p.
- The source for the dead-letter queue handler consists of several files and is provided in a separate directory.
For detailed information about support for UNIX and Linux systems, see System Requirements for IBM MQ.
Parent topic: Features demonstrated in the sample programs on Multiplatforms