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

rubywmq 0.3.0-i386-mswin32-mq6

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>