swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Syntax     Other Library Functions  
function  

mq-connect

 
 

Library: MQSeries access (OMMQI) legacy
Include: ommqi.xin
Return type: mq-queue-manager

Returns: A configured mq-connection object wrapping a connection to the queue manager.


Declaration

define external mq-connection function mq-connect
    to                   value       stream                queue-manager-name

Argument definitions

queue-manager-name
is the name of the queue manager to be accessed.


Purpose

Use mq-connect to create a connection to a queue manager.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "ommqi.xin"

Usage Notes

This function corresponds to the MQCONN function in the MQSeries API.

The CompCode and Reason parameters of MQCONN are integrated into the OMMQI error handling.

Example

Connect to queue manager "QM_desthost".

  include "ommqi.xin"
  
  process
     local mq-connection a-connection
  
     ; Connect to queue manager QM_desthost
     set a-connection to mq-connect to "QM_desthost"

    Related Syntax
   mq-connectx
   mq-disconnect
 
  Other Library Functions
   mq-backout
   mq-close
   mq-commit
   mq-connect
   mq-connection
   mq-connectx
   mq-disconnect
   mq-get
   mq-get-entire-return-status
   mq-get-function-status
   mq-get-logging-level
   mq-get-throw-on-warnings
   mq-inquire
   mq-inquire-names
   mq-object
   mq-open
   mq-put
   mq-put1message
   mq-set
   mq-set-logging-level
   mq-set-throw-on-warnings
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.