Use the sample programs for z/OS

The sample procedural applications that are delivered with IBM MQ for z/OS demonstrate typical uses of the Message Queue Interface (MQI).

About this task

IBM MQ for z/OS also provides sample data-conversion exits, described in Writing data-conversion exits.

All the sample applications are supplied in source form; several are also supplied in executable form. The source modules include pseudocode that describes the program logic.

Note: Although some of the sample applications have basic panel-driven interfaces, they do not aim to demonstrate how to design the look and feel of the applications. For more information about how to design panel-driven interfaces for non-programmable terminals, see the SAA Common User Access: Basic Interface Design Guide (SC26-4583) and its addendum (GG22-9508). These provide guidelines to help you to design applications that are consistent both within the application and across other applications.

• Features demonstrated in the sample applications for z/OS
  This section summarizes the MQI features demonstrated in each of the sample applications, shows the programming languages in which each sample is written, and the environment in which each sample runs.
• Configure a queue manager to accept client connections on z/OS
  Before we can run the sample applications, we must first create a queue manager. We can then configure the queue manager to securely accept incoming connection requests from applications that are running in client mode.
• Preparing and running sample applications for the batch environment on z/OS
  To prepare a sample application that runs in the batch environment, perform the same steps that you would when building any batch IBM MQ for z/OS application.
• Preparing sample applications for the TSO environment on z/OS
  To prepare a sample application that runs in the TSO environment, perform the same steps that you would when building any batch IBM MQ for z/OS application.
• Preparing the sample applications for the CICS environment on z/OS
  Before you run the CICS sample programs, log on to CICS using a LOGMODE of 32702. This is because the sample programs have been written to use a 3270 mode 2 screen.
• Preparing the sample application for the IMS environment on z/OS
  Part of the Credit Check sample application can run in the IMS environment.
• The Put samples on z/OS
  The Put sample programs put messages on a queue using the MQPUT call.
• The Get samples on z/OS
  The Get sample programs get messages from a queue using the MQGET call.
• The Browse sample on z/OS
  The Browse sample is a batch application that demonstrates how to browse messages on a queue using the MQGET call.
• The Print Message sample on z/OS
  The Print Message sample is a batch application that demonstrates how to remove all the messages from a queue using the MQGET call.
• The Queue Attributes sample on z/OS
  The Queue Attributes sample is a conversational-mode CICS application that demonstrates the use of the MQINQ and MQSET calls.
• The Mail Manager sample on z/OS
  The Mail Manager sample application is a suite of programs that demonstrates sending and receiving messages, both within a single environment and across different environments. The application is a simple electronic mailing system that allows users to exchange messages, even if they use different queue managers.
• The Credit Check sample on z/OS
  The Credit Check sample application is a suite of programs that demonstrates how to use many of the features provided by IBM MQ for z/OS. It shows how the many component programs of an application can pass messages to each other using message queuing techniques.
• The Message Handler sample on z/OS
  The Message Handler sample TSO application allows you to browse, forward, and delete messages on a queue. The sample is available in C and COBOL.
• The Asynchronous Put sample on z/OS
  The Asynchronous Put sample program puts messages on a queue using the asynchronous MQPUT call. The sample also retrieves status information using the MQSTAT call.
• The Batch Asynchronous Consumption sample on z/OS
  The CSQ4BCS1 sample program is delivered in C, it demonstrates the use of MQCB and MQCTL to consume messages from multiple queues asynchronously.
• The CICS Asynchronous Consumption and Publish/Subscribe sample on z/OS
  The Asynchronous Consumption and Publish/Subscribe sample programs demonstrate the use of asynchronous consumption, and publish and subscribe features within CICS.
• The Publish/Subscribe sample on z/OS
  The Publish/Subscribe sample programs demonstrate the use of the publish and subscribe features in IBM MQ.
• The Set and Inquire message property sample on z/OS
  The message property sample programs demonstrate the addition of user-defined properties to a message handle, and the inquisition of the properties associated with that message.

Parent topic: Use the IBM MQ sample procedural programs

Related tasks

• Use the sample programs on Multiplatforms