Running C Language Consumer

To run this sample, invoke the S73C transaction at a blank 3270 screen.

Use the following syntax:

S73C -server server {-topic topic name | -queue queue name}-user username -password password

CICS translates parameter values to uppercase. The parameters are as follows:
Parameter Description
-server The URL of the TIBCO EMS server (CICS translates this to uppercase, the program reverts it to lowercase)
-topic If specifying a topic destination, the topic name.
-queue If specifying a queue destination, the queue name.
-user The user name to connect to the TIBCO EMS server.
-password The password to connect to the TIBCO EMS server.

The following example invokes a Consumer that connects to a server with the URL emsserverurl:7222 and listens on the topic my.topic.name:

S73C -server emsserverurl:7222 -topic my.topic.name

An error message is displayed if a problem occurs when setting up the Consumer process. An error might be caused by an invalid parameter value; check the parameter values and re-enter.

When the Consumer process starts, the screen is locked, waiting for a message. Messages received by the Consumer are printed to DDNAME CEEOUT. To stop the Consumer process, send the Consumer a TIBCO EMS text message that starts with STOP (uppercase), or stop the Work Thread using the S7MA transaction.