RubyGems - rubywmq - Versions diffs - 0.3.0-i386-mswin32-mq6 - Mend

rubywmq 0.3.0-i386-mswin32-mq6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (84) hide show

data/LICENSE +13 -0
data/README +73 -0
data/doc/classes/WMQ.html +6300 -0
data/doc/classes/WMQ/Message.html +376 -0
data/doc/classes/WMQ/Message.src/M000001.html +77 -0
data/doc/classes/WMQ/Message.src/M000002.html +27 -0
data/doc/classes/WMQ/Queue.html +1459 -0
data/doc/classes/WMQ/Queue.src/M000003.html +205 -0
data/doc/classes/WMQ/Queue.src/M000004.html +107 -0
data/doc/classes/WMQ/Queue.src/M000005.html +198 -0
data/doc/classes/WMQ/Queue.src/M000006.html +66 -0
data/doc/classes/WMQ/Queue.src/M000007.html +203 -0
data/doc/classes/WMQ/Queue.src/M000008.html +265 -0
data/doc/classes/WMQ/Queue.src/M000009.html +120 -0
data/doc/classes/WMQ/Queue.src/M000010.html +28 -0
data/doc/classes/WMQ/Queue.src/M000011.html +30 -0
data/doc/classes/WMQ/Queue.src/M000012.html +31 -0
data/doc/classes/WMQ/Queue.src/M000013.html +31 -0
data/doc/classes/WMQ/Queue.src/M000014.html +31 -0
data/doc/classes/WMQ/QueueManager.html +1529 -0
data/doc/classes/WMQ/QueueManager.src/M000015.html +182 -0
data/doc/classes/WMQ/QueueManager.src/M000016.html +194 -0
data/doc/classes/WMQ/QueueManager.src/M000017.html +92 -0
data/doc/classes/WMQ/QueueManager.src/M000018.html +70 -0
data/doc/classes/WMQ/QueueManager.src/M000019.html +49 -0
data/doc/classes/WMQ/QueueManager.src/M000020.html +49 -0
data/doc/classes/WMQ/QueueManager.src/M000021.html +63 -0
data/doc/classes/WMQ/QueueManager.src/M000022.html +61 -0
data/doc/classes/WMQ/QueueManager.src/M000023.html +65 -0
data/doc/classes/WMQ/QueueManager.src/M000024.html +232 -0
data/doc/classes/WMQ/QueueManager.src/M000025.html +30 -0
data/doc/classes/WMQ/QueueManager.src/M000026.html +31 -0
data/doc/classes/WMQ/QueueManager.src/M000027.html +31 -0
data/doc/classes/WMQ/QueueManager.src/M000028.html +38 -0
data/doc/classes/WMQ/QueueManager.src/M000029.html +33 -0
data/doc/classes/WMQ/QueueManager.src/M000030.html +21 -0
data/doc/classes/WMQ/QueueManager.src/M000031.html +284 -0
data/doc/classes/WMQ/QueueManager.src/M000032.html +24 -0
data/doc/classes/WMQ/QueueManager.src/M000033.html +18 -0
data/doc/classes/WMQ/QueueManager.src/M000034.html +46 -0
data/doc/classes/WMQ/QueueManager.src/M000035.html +27 -0
data/doc/classes/WMQ/WMQException.html +111 -0
data/doc/created.rid +1 -0
data/doc/files/ext/lib/wmq_const_admin_rb.html +128 -0
data/doc/files/ext/lib/wmq_const_rb.html +128 -0
data/doc/files/ext/lib/wmq_temp_rb.html +122 -0
data/doc/files/ext/wmq_c.html +101 -0
data/doc/files/ext/wmq_message_c.html +101 -0
data/doc/files/ext/wmq_queue_c.html +101 -0
data/doc/files/ext/wmq_queue_manager_c.html +101 -0
data/doc/fr_class_index.html +31 -0
data/doc/fr_file_index.html +33 -0
data/doc/fr_method_index.html +61 -0
data/doc/index.html +24 -0
data/doc/rdoc-style.css +208 -0
data/examples/each_a.rb +31 -0
data/examples/each_b.rb +40 -0
data/examples/each_header.rb +37 -0
data/examples/files_to_q.cfg +24 -0
data/examples/files_to_q.rb +46 -0
data/examples/get_a.rb +34 -0
data/examples/get_client.rb +50 -0
data/examples/put1_a.rb +24 -0
data/examples/put1_b.rb +32 -0
data/examples/put1_c.rb +31 -0
data/examples/put_a.rb +34 -0
data/examples/put_b.rb +42 -0
data/examples/put_dlh.rb +40 -0
data/examples/put_dynamic_q.rb +37 -0
data/examples/put_rfh.rb +66 -0
data/examples/put_rfh2_a.rb +42 -0
data/examples/put_rfh2_b.rb +42 -0
data/examples/put_xmit_q.rb +32 -0
data/examples/q_to_files.cfg +17 -0
data/examples/q_to_files.rb +47 -0
data/examples/request.rb +59 -0
data/examples/server.rb +96 -0
data/lib/wmq.rb +25 -0
data/lib/wmq/wmq.so +0 -0
data/lib/wmq/wmq_const.rb +745 -0
data/lib/wmq/wmq_const_admin.rb +555 -0
data/lib/wmq/wmq_temp.rb +197 -0
data/tests/test.rb +299 -0
metadata +131 -0

data/doc/classes/WMQ/QueueManager.src/M000015.html ADDED

@@ -0,0 +1,182 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>connect (WMQ::QueueManager)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>/*
+ * call-seq:
+ *   connect(...)
+ *
+ * Connect to the queue manager, then disconnect once the supplied code block completes
+ *
+ * Parameters:
+ * * Since the number of parameters can vary dramatically, all parameters are passed by name in a hash
+ * * Summary of parameters and their WebSphere MQ equivalents:
+ *  WMQ::QueueManager.connect(                             # WebSphere MQ Equivalents:
+ *   :q_mgr_name         =&gt; 'queue_manager name',
+ *   :exception_on_error =&gt; true,                          # n/a
+ *   :connect_options    =&gt; WMQ::MQCNO_FASTBATH_BINDING    # MQCNO.Options
+ *
+ *   :trace_level        =&gt; 0,                             # n/a
+ *
+ *   # Common client connection parameters
+ *   :channel_name       =&gt; 'svrconn channel name',        # MQCD.ChannelName
+ *   :connection_name    =&gt; 'localhost(1414)',             # MQCD.ConnectionName
+ *   :transport_type     =&gt; WMQ::MQXPT_TCP,                # MQCD.TransportType
+ *
+ *   # Advanced client connections parameters
+ *   :max_msg_length     =&gt; 65535,                         # MQCD.MaxMsgLength
+ *   :security_exit      =&gt; 'Name of security exit',       # MQCD.SecurityExit
+ *   :send_exit          =&gt; 'Name of send exit',           # MQCD.SendExit
+ *   :receive_exit       =&gt; 'Name of receive exit',        # MQCD.ReceiveExit
+ *   :security_user_data =&gt; 'Security exit User data',     # MQCD.SecurityUserData
+ *   :send_user_data     =&gt; 'Send exit user data',         # MQCD.SendUserData
+ *   :receive_user_data  =&gt; 'Receive exit user data',      # MQCD.ReceiveUserData
+ *   :heartbeat_interval =&gt;  1,                            # MQCD.HeartbeatInterval
+ *   :remote_security_id =&gt; 'Remote Security id',          # MQCD.RemoteSecurityId
+ *   :ssl_cipher_spec    =&gt; 'SSL Cipher Spec',             # MQCD.SSLCipherSpec
+ *   :keep_alive_interval=&gt; -1,                            # MQCD.KeepAliveInterval
+ *   :mode_name          =&gt; 'LU6.2 Mode Name',             # MQCD.ModeName
+ *   :tp_name            =&gt; 'LU6.2 Transaction pgm name',  # MQCD.TpName
+ *   :user_identifier    =&gt; 'LU 6.2 Userid',               # MQCD.UserIdentifier
+ *   :password           =&gt; 'LU6.2 Password',              # MQCD.Password
+ *   :long_remote_user_id=&gt; 'Long remote user identifier', # MQCD.LongRemoteUserId (Ptr, Length)
+ *   :ssl_peer_name      =&gt; 'SSL Peer name',               # MQCD.SSLPeerName (Ptr, Length)
+ *
+ *   # SSL Options
+ *   :key_repository     =&gt; '/var/mqm/qmgrs/.../key',        # MQSCO.KeyRepository
+ *   :crypto_hardware    =&gt; 'GSK_ACCELERATOR_NCIPHER_NF_ON', # MQSCO.CryptoHardware
+ *   )
+ *
+ * Optional Parameters
+ * * :q_mgr_name =&gt; String
+ *   * Name of the existing WebSphere MQ Queue Manager to connect to
+ *
+ *   * Default:
+ *      - Server connections will connect to the default queue manager
+ *      - Client connections will connect to whatever queue
+ *        manager is found at the host and port number as specified
+ *        by the connection_name
+ *
+ * * :exception_on_error =&gt; true or false
+ *      Determines whether WMQ::WMQExceptions are thrown whenever
+ *      an error occurs during a WebSphere MQ operation (connect, put, get, etc..)
+ *
+ *      Default: true
+ *
+ * * :connect_options =&gt; FixNum
+ *   * One or more of the following values:
+ *       WMQ::MQCNO_STANDARD_BINDING
+ *       WMQ::MQCNO_FASTPATH_BINDING
+ *       WMQ::MQCNO_SHARED_BINDING
+ *       WMQ::MQCNO_ISOLATED_BINDING
+ *       WMQ::MQCNO_ACCOUNTING_MQI_ENABLED
+ *       WMQ::MQCNO_ACCOUNTING_MQI_DISABLED
+ *       WMQ::MQCNO_ACCOUNTING_Q_ENABLED
+ *       WMQ::MQCNO_ACCOUNTING_Q_DISABLED
+ *       WMQ::MQCNO_NONE
+ *
+ *   * Multiple values can be or'd together. E.g.
+ *       :connect_options=&gt;WMQ::MQCNO_FASTPATH_BINDING | WMQ::MQCNO_ACCOUNTING_MQI_ENABLED
+ *
+ *   * Please see the WebSphere MQ MQCNO data type documentation for more details
+ *      Default: WMQ::MQCNO_NONE
+ *
+ * * :trace_level =&gt; FixNum
+ *   * Turns on low-level tracing of the WebSphere MQ API calls to stdout.
+ *     * 0: No tracing
+ *     * 1: MQ API tracing only (MQCONNX, MQOPEN, MQPUT, etc..)
+ *     * 2: Include Ruby WMQ tracing
+ *     * 3: Verbose logging (Recommended for when reporting problems in Ruby WMQ)
+ *      Default: 0
+ *
+ * Common Client Connection Parameters (Client connections only)
+ * * :connection_name =&gt; String (Mandatory for client connections)
+ *   * Connection name, made up of the host name (or ip address) and the port number
+ *   * E.g.
+ *       'mymachine.domain.com(1414)'
+ *       '192.168.0.1(1417)'
+ *
+ * * :channel_name =&gt; String
+ *   * Name of SVRCONN channel defined on the QueueManager for Client Connections
+ *   * Default Value:
+ *       'SYSTEM.DEF.SVRCONN'
+ *
+ * * :transport_type     =&gt; WMQ::MQXPT_TCP,                # MQCD.TransportType
+ *   * Valid Values:
+ *       WMQ::MQXPT_LOCAL
+ *       WMQ::MQXPT_LU62
+ *       WMQ::MQXPT_TCP
+ *       WMQ::MQXPT_NETBIOS
+ *       WMQ::MQXPT_SPX
+ *       WMQ::MQXPT_DECNET
+ *       WMQ::MQXPT_UDP
+ *
+ *   * Default Value:
+ *       WMQ::MQXPT_TCP
+ *
+ * For the Advanced Client Connection parameters, please see the WebSphere MQ documentation
+ *
+ * Note:
+ * * If an exception is not caught in the code block, the current unit of work is
+ *   automatically backed out, before disconnecting from the queue manager.
+ *
+ * Local Server Connection Example:
+ *   require 'wmq/wmq'
+ *
+ *   WMQ::QueueManager.connect(:q_mgr_name=&gt;'REID') do |qmgr|
+ *     qmgr.put(:q_name=&gt;'TEST.QUEUE', :data =&gt; 'Hello World')
+ *   end
+ *
+ * Client Connection Example:
+ *   require 'wmq/wmq_client'
+ *
+ *   WMQ::QueueManager.connect(
+ *               :channel_name    =&gt; 'SYSTEM.DEF.SVRCONN',
+ *               :transport_type  =&gt; WMQ::MQXPT_TCP,
+ *               :connection_name =&gt; 'localhost(1414)' ) do |qmgr|
+ *     qmgr.open_queue(:q_name=&gt;'TEST.QUEUE', :mode=&gt;:input) do |queue|
+ *
+ *       message = WMQ::Message.new
+ *       if queue.get(:message =&gt; message)
+ *         puts &quot;Data Received: #{message.data}&quot;
+ *       else
+ *         puts 'No message available'
+ *       end
+ *     end
+ *   end
+ */
+VALUE QueueManager_singleton_connect(int argc, VALUE *argv, VALUE self)
+{
+    VALUE proc, parameters, queue_manager;
+    /* Extract parameters and code block (Proc) */
+    rb_scan_args(argc, argv, &quot;1&amp;&quot;, &amp;parameters, &amp;proc);
+    queue_manager = rb_funcall(wmq_queue_manager, ID_new, 1, parameters);
+    if(!NIL_P(proc))
+    {
+        if(Qtrue == QueueManager_connect(queue_manager))
+        {
+            struct QueueManager_singleton_connect_arg arg;
+            arg.self = queue_manager;
+            arg.proc = proc;
+            rb_ensure(QueueManager_singleton_connect_body, (VALUE)&amp;arg,
+                      QueueManager_singleton_connect_ensure, queue_manager);
+        }
+        else
+        {
+            return Qfalse;
+        }
+    }
+    return queue_manager;
+}</pre>
+</body>
+</html>

data/doc/classes/WMQ/QueueManager.src/M000016.html ADDED

@@ -0,0 +1,194 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>new (WMQ::QueueManager)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>/*
+ * call-seq:
+ *   new(...)
+ *
+ * Parameters:
+ * * Since the number of parameters can vary dramatically, all parameters are passed by name in a hash
+ * * See QueueManager.new for details on all the parameters
+ *
+ * Note:
+ * * It is not recommended to use this method, rather use QueueManager.connect, since
+ *   it will automatically disconnect from the queue manager. It also deals with backing out
+ *   the current unit of work in the event of an unhandled exception. E.g. Syntax Error
+ * * RuntimeError and ArgumentError exceptions are always thrown regardless of the
+ *   value of :exception_on_error
+ *
+ * Todo:
+ * * Support multiple send and receive exits
+ */
+VALUE QueueManager_initialize(VALUE self, VALUE hash)
+{
+    VALUE          val;
+    VALUE          str;
+    size_t         size;
+    size_t         length;
+    size_t         i;
+    PQUEUE_MANAGER pqm;
+    char*          pChar;
+    Check_Type(hash, T_HASH);
+    Data_Get_Struct(self, QUEUE_MANAGER, pqm);
+    WMQ_HASH2MQLONG(hash,trace_level, pqm-&gt;trace_level)
+    /* @name = options[:q_mgr_name] || ''     # QMGR Name optional with Client Connection */
+    val = rb_hash_aref(hash, ID2SYM(ID_q_mgr_name));
+    if (NIL_P(val))
+    {
+        rb_iv_set(self, &quot;@name&quot;, rb_str_new2(&quot;&quot;));
+        if(pqm-&gt;trace_level &gt; 1) printf(&quot;WMQ::QueueManager#initialize() Queue Manager:[Not specified, use Default QMGR]\n&quot;);
+    }
+    else
+    {
+        rb_iv_set(self, &quot;@name&quot;, val);
+        if(pqm-&gt;trace_level &gt; 1) printf(&quot;WMQ::QueueManager#initialize() Queue Manager:%s\n&quot;, RSTRING(val)-&gt;ptr);
+    }
+    WMQ_HASH2BOOL(hash,exception_on_error, pqm-&gt;exception_on_error)
+    /*
+     * All Client connection parameters are ignored if connection_name is missing
+     */
+#ifdef MQCNO_VERSION_2
+    if(!NIL_P(rb_hash_aref(hash, ID2SYM(ID_connection_name))))
+    {
+        PMQCD pmqcd = &amp;pqm-&gt;client_conn;              /* Process MQCD */
+        pqm-&gt;is_client_conn = 1;                      /* Set to Client connection */
+        WMQ_HASH2MQCHARS(hash,connection_name,             pmqcd-&gt;ConnectionName)
+        WMQ_HASH2MQLONG (hash,transport_type,              pmqcd-&gt;TransportType)
+        WMQ_HASH2MQCHARS(hash,mode_name,                   pmqcd-&gt;ModeName)
+        WMQ_HASH2MQCHARS(hash,tp_name,                     pmqcd-&gt;TpName)
+        WMQ_HASH2MQCHARS(hash,security_exit,               pmqcd-&gt;SecurityExit)
+        WMQ_HASH2MQCHARS(hash,send_exit,                   pmqcd-&gt;SendExit)
+        WMQ_HASH2MQCHARS(hash,receive_exit,                pmqcd-&gt;ReceiveExit)
+        WMQ_HASH2MQLONG (hash,max_msg_length,              pmqcd-&gt;MaxMsgLength)
+        WMQ_HASH2MQCHARS(hash,security_user_data,          pmqcd-&gt;SecurityUserData)
+        WMQ_HASH2MQCHARS(hash,send_user_data,              pmqcd-&gt;SendUserData)
+        WMQ_HASH2MQCHARS(hash,receive_user_data,           pmqcd-&gt;ReceiveUserData)
+        WMQ_HASH2MQCHARS(hash,user_identifier,             pmqcd-&gt;UserIdentifier)
+        WMQ_HASH2MQCHARS(hash,password,                    pmqcd-&gt;Password)
+        /* Default channel name to system default */
+        val = rb_hash_aref(hash, ID2SYM(ID_channel_name));
+        if (NIL_P(val))
+        {
+            strncpy(pmqcd-&gt;ChannelName, &quot;SYSTEM.DEF.SVRCONN&quot;, sizeof(pmqcd-&gt;ChannelName));
+        }
+        else
+        {
+            WMQ_HASH2MQCHARS(hash,channel_name,            pmqcd-&gt;ChannelName)
+        }
+    #ifdef MQCD_VERSION_4
+        WMQ_HASH2MQLONG(hash,heartbeat_interval,          pmqcd-&gt;HeartbeatInterval)
+        /* TODO:
+        WMQ_HASH2MQLONG(hash,exit_name_length,            pmqcd-&gt;ExitNameLength)
+        WMQ_HASH2MQLONG(hash,exit_data_length,            pmqcd-&gt;ExitDataLength)
+        WMQ_HASH2MQLONG(hash,send_exits_defined,          pmqcd-&gt;SendExitsDefined)
+        WMQ_HASH2MQLONG(hash,receive_exits_defined,       pmqcd-&gt;ReceiveExitsDefined)
+        TO_PTR (send_exit_ptr,               pmqcd-&gt;SendExitPtr)
+        TO_PTR (send_user_data_ptr,          pmqcd-&gt;SendUserDataPtr)
+        TO_PTR (receive_exit_ptr,            pmqcd-&gt;ReceiveExitPtr)
+        TO_PTR (receive_user_data_ptr,       pmqcd-&gt;ReceiveUserDataPtr)
+        */
+    #endif
+    #ifdef MQCD_VERSION_6
+        val = rb_hash_aref(hash, ID2SYM(ID_long_remote_user_id));
+        if (!NIL_P(val))
+        {
+            str = StringValue(val);
+            length = RSTRING(str)-&gt;len;
+            if (length &gt; 0)
+            {
+                MQPTR pBuffer;
+                if(pqm-&gt;trace_level &gt; 1)
+                    printf(&quot;WMQ::QueueManager#initialize() Setting long_remote_user_id:%s\n&quot;,
+                        RSTRING(str)-&gt;ptr);
+                /* Include null at end of string */
+                pBuffer = ALLOC_N(char, length+1);
+                memcpy(pBuffer, RSTRING(str)-&gt;ptr, length+1);
+                pmqcd-&gt;LongRemoteUserIdLength = length;
+                pmqcd-&gt;LongRemoteUserIdPtr    = pBuffer;
+                pqm-&gt;long_remote_user_id_ptr  = pBuffer;
+            }
+        }
+        WMQ_HASH2MQBYTES(hash,remote_security_id,          pmqcd-&gt;RemoteSecurityId)
+        WMQ_HASH2MQCHARS(hash,ssl_cipher_spec,             pmqcd-&gt;SSLCipherSpec)
+    #endif
+    #ifdef MQCD_VERSION_7
+        val = rb_hash_aref(hash, ID2SYM(ID_ssl_peer_name));
+        if (!NIL_P(val))
+        {
+            str = StringValue(val);
+            length = RSTRING(str)-&gt;len;
+            if (length &gt; 0)
+            {
+                MQPTR pBuffer;
+                if(pqm-&gt;trace_level &gt; 1)
+                    printf(&quot;WMQ::QueueManager#initialize() Setting ssl_peer_name:%s\n&quot;,
+                        RSTRING(str)-&gt;ptr);
+                /* Include null at end of string */
+                pBuffer = ALLOC_N(char, length+1);
+                memcpy(pBuffer, RSTRING(str)-&gt;ptr, length+1);
+                pmqcd-&gt;SSLPeerNameLength = length;
+                pmqcd-&gt;SSLPeerNamePtr    = pBuffer;
+                pqm-&gt;ssl_peer_name_ptr   = pBuffer;
+            }
+        }
+        WMQ_HASH2MQLONG(hash,keep_alive_interval,         pmqcd-&gt;KeepAliveInterval)
+        /* Only set if SSL options are supplied, otherwise
+        * environment variables are ignored: MQSSLKEYR and MQSSLCRYP
+        * Any SSL info in the client channel definition tables is also ignored
+        */
+        if (!NIL_P(rb_hash_aref(hash, ID2SYM(ID_key_repository))) ||
+            !NIL_P(rb_hash_aref(hash, ID2SYM(ID_crypto_hardware))))
+        {
+            /* Process MQSCO */
+            WMQ_HASH2MQCHARS(hash,key_repository,              pqm-&gt;ssl_config_opts.KeyRepository)
+            WMQ_HASH2MQCHARS(hash,crypto_hardware,             pqm-&gt;ssl_config_opts.CryptoHardware)
+            pqm-&gt;connect_options.SSLConfigPtr = &amp;pqm-&gt;ssl_config_opts;
+        }
+    #endif
+    }
+    else
+    {
+        pqm-&gt;is_client_conn = 0;                       /* Set to Server connection */
+    }
+#endif
+#ifdef MQCNO_VERSION_4
+    /* Process MQCNO */
+    WMQ_HASH2MQLONG(hash,connect_options,             pqm-&gt;connect_options.Options)
+#endif
+  /* --------------------------------------------------
+   * TODO:   MQAIR Structure - LDAP Security
+   * --------------------------------------------------*/
+    return Qnil;
+}</pre>
+</body>
+</html>

data/doc/classes/WMQ/QueueManager.src/M000017.html ADDED

@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>connect (WMQ::QueueManager)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>/*
+ * Before working with any queues, it is necessary to connect
+ * to the queue manager.
+ *
+ * Returns:
+ * * true : On Success
+ * * false: On Failure
+ *
+ *   comp_code and reason_code are also updated.
+ *   reason will return a text description of the reason_code
+ *
+ * Throws:
+ * * WMQ::WMQException if comp_code != MQCC_OK
+ * * Except if :exception_on_error =&gt; false was supplied as a parameter
+ *   to QueueManager.new
+ */
+VALUE QueueManager_connect(VALUE self)
+{
+    VALUE    name;
+    VALUE    str;
+    VALUE    val;
+    VALUE    hash;
+    PQUEUE_MANAGER pqm;
+    Data_Get_Struct(self, QUEUE_MANAGER, pqm);
+    pqm-&gt;already_connected = 0;
+    Queue_manager_mq_load(pqm);                       /* Load MQ Library */
+    name = rb_iv_get(self,&quot;@name&quot;);
+    name = StringValue(name);
+    if(pqm-&gt;trace_level)
+        printf(&quot;WMQ::QueueManager#connect() Connect to Queue Manager:%s\n&quot;, RSTRING(name)-&gt;ptr);
+    if (pqm-&gt;hcon)                                    /* Disconnect from qmgr if already connected, ignore errors */
+    {
+        if(pqm-&gt;trace_level)
+            printf(&quot;WMQ::QueueManager#connect() Already connected to Queue Manager:%s, Disconnecting first!\n&quot;, RSTRING(name)-&gt;ptr);
+        pqm-&gt;MQDISC(&amp;pqm-&gt;hcon, &amp;pqm-&gt;comp_code, &amp;pqm-&gt;reason_code);
+    }
+    pqm-&gt;MQCONNX(
+            RSTRING(name)-&gt;ptr,      /* queue manager                  */
+            &amp;pqm-&gt;connect_options,   /* Connection Options             */
+            &amp;pqm-&gt;hcon,              /* connection handle              */
+            &amp;pqm-&gt;comp_code,         /* completion code                */
+            &amp;pqm-&gt;reason_code);      /* connect reason code            */
+    if(pqm-&gt;trace_level)
+        printf(&quot;WMQ::QueueManager#connect() MQCONNX completed with reason:%s, Handle:%d\n&quot;,
+               wmq_reason(pqm-&gt;reason_code),
+               pqm-&gt;hcon);
+    if (pqm-&gt;comp_code == MQCC_FAILED)
+    {
+        pqm-&gt;hcon = 0;
+        if (pqm-&gt;exception_on_error)
+        {
+            rb_raise(wmq_exception,
+                     &quot;WMQ::QueueManager#connect(). Error connecting to Queue Manager:%s, reason:%s&quot;,
+                     RSTRING(name)-&gt;ptr,
+                     wmq_reason(pqm-&gt;reason_code));
+        }
+        return Qfalse;
+    }
+    if (pqm-&gt;reason_code == MQRC_ALREADY_CONNECTED)
+    {
+        if(pqm-&gt;trace_level) printf(&quot;WMQ::QueueManager#connect() Already connected\n&quot;);
+        pqm-&gt;already_connected = 1;
+    }
+    return Qtrue;
+}</pre>
+</body>
+</html>