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.

Table 1. IBM MQ on UNIX and Linux sample programs demonstrating use of the MQI (C and COBOL)

Technique
C (source) ( 1 ) COBOL (source) ( 2 ) Server (C executable) Client (C executable) ( 3 )
Use the publish/subscribe interface amqspuba amqssuba amqssbxa no sample amqspub amqssub amqssbx no sample
Putting messages using the MQPUT call amqsput0 amq0put0 amqsput amqsputc
Putting a single message using the MQPUT1 call amqsinqa amqsecha amqminqx amqmechx amqiinqx amqiechx amqsinq amqsech amqsechc
Putting messages to a distribution list ( 4 ) amqsptl0 amq0ptl0.cbl amqsptl amqsptlc
Replying to a request message amqsinqa amqminqx amqiinqx amqsinq no sample
Get messages using browse (no wait) amqsgbr0 amq0gbr0 amqsgbr no sample
Get messages (wait with a time limit) amqsget0 amq0get0 amqsget amqsgetc
Get messages (unlimited wait) amqstrg0 no sample amqstrg amqstrgc
Get messages (with data conversion) amqsecha no sample amqsech no sample
Putting Reference Messages to a queue ( 4 ) amqsprma no sample amqsprm amqsprmc
Get Reference Messages from a queue ( 4 ) amqsgrma no sample amqsgrm amqsgrmc
Reference Message channel exit ( 4 ) 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 ( 5 ) 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 ( 6 ) amqscic0.ccs no sample amqscic0 no sample
Encina transaction ( 4 ) amqsxae0 no sample amqsxae0 no sample
TUXEDO transaction to put messages ( 7 ) amqstxpx no sample no sample no sample
TUXEDO transaction to get messages ( 7 ) amqstxgx no sample no sample no sample
Server for TUXEDO ( 7 ) amqstxsx no sample no sample no sample
Dead-letter queue handler Directory ./tools/c/Samples/dlq ( 8 ) 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
Connecting 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
Putting 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
Specifying TLS connection information on MQCONNX amqssslc no sample not applicable amqssslc
Notes:
  1. The executable version of the IBM MQ MQI client samples share the same source as the samples that run in a server environment.
  2. Compile programs beginning 'amqm' with the Micro Focus COBOL compiler, those beginning 'amqi' with the IBM COBOL compiler, and those beginning 'amq0' with either.
  3. The executable versions of the IBM MQ MQI client samples are not available on IBM MQ for HP-UX.
  4. Supported on IBM MQ for AIX , IBM MQ for HP-UX, and IBM MQ for Solaris only.
  5. On IBM MQ for AIX, IBM MQ for HP-UX, and IBM MQ for Solaris this program is called amqsvfc0.c
  6. CICS is supported by IBM MQ for AIX and IBM MQ for HP-UX only.
  7. TUXEDO is not supported by IBM MQ for Linux on System p.
  8. 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.