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.
- 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
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>disconnect (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* Disconnect from this QueueManager instance
|
|
15
|
+
*
|
|
16
|
+
* Returns:
|
|
17
|
+
* * true : On Success
|
|
18
|
+
* * false: On Failure
|
|
19
|
+
*
|
|
20
|
+
* comp_code and reason_code are also updated.
|
|
21
|
+
* reason will return a text description of the reason_code
|
|
22
|
+
*
|
|
23
|
+
* Throws:
|
|
24
|
+
* * WMQ::WMQException if comp_code != MQCC_OK
|
|
25
|
+
* * Except if :exception_on_error => false was supplied as a parameter
|
|
26
|
+
* to QueueManager.new
|
|
27
|
+
*/
|
|
28
|
+
VALUE QueueManager_disconnect(VALUE self)
|
|
29
|
+
{
|
|
30
|
+
PQUEUE_MANAGER pqm;
|
|
31
|
+
Data_Get_Struct(self, QUEUE_MANAGER, pqm);
|
|
32
|
+
|
|
33
|
+
if(pqm->trace_level) printf ("WMQ::QueueManager#disconnect() Queue Manager Handle:%ld\n", pqm->hcon);
|
|
34
|
+
|
|
35
|
+
if (!pqm->already_connected)
|
|
36
|
+
{
|
|
37
|
+
pqm->MQDISC(&pqm->hcon, &pqm->comp_code, &pqm->reason_code);
|
|
38
|
+
|
|
39
|
+
if(pqm->trace_level) printf("WMQ::QueueManager#disconnect() MQDISC completed with reason:%s\n", wmq_reason(pqm->reason_code));
|
|
40
|
+
|
|
41
|
+
if (pqm->comp_code != MQCC_OK)
|
|
42
|
+
{
|
|
43
|
+
if (pqm->exception_on_error)
|
|
44
|
+
{
|
|
45
|
+
VALUE name = rb_iv_get(self,"@name");
|
|
46
|
+
name = StringValue(name);
|
|
47
|
+
|
|
48
|
+
rb_raise(wmq_exception,
|
|
49
|
+
"WMQ::QueueManager#disconnect(). Error disconnecting from Queue Manager:%s, reason:%s",
|
|
50
|
+
RSTRING(name)->ptr,
|
|
51
|
+
wmq_reason(pqm->reason_code));
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
return Qfalse;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
else
|
|
58
|
+
{
|
|
59
|
+
pqm->comp_code = 0;
|
|
60
|
+
pqm->reason_code = 0;
|
|
61
|
+
|
|
62
|
+
if(pqm->trace_level) printf ("WMQ::QueueManager#disconnect() Not calling MQDISC, since already connected on connect\n");
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
pqm->hcon = 0;
|
|
66
|
+
|
|
67
|
+
return Qtrue;
|
|
68
|
+
}</pre>
|
|
69
|
+
</body>
|
|
70
|
+
</html>
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>open_queue (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* call-seq:
|
|
15
|
+
* open_queue(...)
|
|
16
|
+
* access_queue(...)
|
|
17
|
+
*
|
|
18
|
+
* Open the specified queue, then close it once the
|
|
19
|
+
* supplied code block has completed
|
|
20
|
+
*
|
|
21
|
+
* Parameters:
|
|
22
|
+
* * Since the number of parameters can vary dramatically, all parameters are passed by name in a hash
|
|
23
|
+
* * See Queue.open for the complete list of parameters, except that :queue_manager is *not* required
|
|
24
|
+
* since it is supplied automatically by this method
|
|
25
|
+
*
|
|
26
|
+
* Example:
|
|
27
|
+
* require 'wmq/wmq_client'
|
|
28
|
+
*
|
|
29
|
+
* WMQ::QueueManager.connect(:q_mgr_name=>'REID', :connection_name=>'localhost(1414)') do |qmgr|
|
|
30
|
+
* qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
|
|
31
|
+
* queue.put(:data => 'Hello World')
|
|
32
|
+
* end
|
|
33
|
+
* end
|
|
34
|
+
*/
|
|
35
|
+
VALUE QueueManager_open_queue(int argc, VALUE *argv, VALUE self)
|
|
36
|
+
{
|
|
37
|
+
VALUE parameters;
|
|
38
|
+
VALUE proc;
|
|
39
|
+
|
|
40
|
+
/* Extract parameters and code block (Proc) */
|
|
41
|
+
rb_scan_args(argc, argv, "1&", &parameters, &proc);
|
|
42
|
+
|
|
43
|
+
Check_Type(parameters, T_HASH);
|
|
44
|
+
rb_hash_aset(parameters, ID2SYM(ID_queue_manager), self);
|
|
45
|
+
|
|
46
|
+
return rb_iterate(QueueManager_open_queue_each, parameters, QueueManager_open_queue_block, proc);
|
|
47
|
+
}</pre>
|
|
48
|
+
</body>
|
|
49
|
+
</html>
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>access_queue (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* call-seq:
|
|
15
|
+
* open_queue(...)
|
|
16
|
+
* access_queue(...)
|
|
17
|
+
*
|
|
18
|
+
* Open the specified queue, then close it once the
|
|
19
|
+
* supplied code block has completed
|
|
20
|
+
*
|
|
21
|
+
* Parameters:
|
|
22
|
+
* * Since the number of parameters can vary dramatically, all parameters are passed by name in a hash
|
|
23
|
+
* * See Queue.open for the complete list of parameters, except that :queue_manager is *not* required
|
|
24
|
+
* since it is supplied automatically by this method
|
|
25
|
+
*
|
|
26
|
+
* Example:
|
|
27
|
+
* require 'wmq/wmq_client'
|
|
28
|
+
*
|
|
29
|
+
* WMQ::QueueManager.connect(:q_mgr_name=>'REID', :connection_name=>'localhost(1414)') do |qmgr|
|
|
30
|
+
* qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
|
|
31
|
+
* queue.put(:data => 'Hello World')
|
|
32
|
+
* end
|
|
33
|
+
* end
|
|
34
|
+
*/
|
|
35
|
+
VALUE QueueManager_open_queue(int argc, VALUE *argv, VALUE self)
|
|
36
|
+
{
|
|
37
|
+
VALUE parameters;
|
|
38
|
+
VALUE proc;
|
|
39
|
+
|
|
40
|
+
/* Extract parameters and code block (Proc) */
|
|
41
|
+
rb_scan_args(argc, argv, "1&", &parameters, &proc);
|
|
42
|
+
|
|
43
|
+
Check_Type(parameters, T_HASH);
|
|
44
|
+
rb_hash_aset(parameters, ID2SYM(ID_queue_manager), self);
|
|
45
|
+
|
|
46
|
+
return rb_iterate(QueueManager_open_queue_each, parameters, QueueManager_open_queue_block, proc);
|
|
47
|
+
}</pre>
|
|
48
|
+
</body>
|
|
49
|
+
</html>
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>begin (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* Advanced WebSphere MQ Use:
|
|
15
|
+
*
|
|
16
|
+
* Begin a unit of work between this QueueManager instance and another
|
|
17
|
+
* resource such as a Database
|
|
18
|
+
*
|
|
19
|
+
* Starts a new unit of work under which put and get can be called with
|
|
20
|
+
* with the parameter :sync => true
|
|
21
|
+
*
|
|
22
|
+
* Returns:
|
|
23
|
+
* * true : On Success
|
|
24
|
+
* * false: On Failure
|
|
25
|
+
*
|
|
26
|
+
* comp_code and reason_code are also updated.
|
|
27
|
+
* reason will return a text description of the reason_code
|
|
28
|
+
*
|
|
29
|
+
* Throws:
|
|
30
|
+
* * WMQ::WMQException if comp_code != MQCC_OK
|
|
31
|
+
* * Except if :exception_on_error => false was supplied as a parameter
|
|
32
|
+
* to QueueManager.new
|
|
33
|
+
*/
|
|
34
|
+
VALUE QueueManager_begin(VALUE self)
|
|
35
|
+
{
|
|
36
|
+
PQUEUE_MANAGER pqm;
|
|
37
|
+
Data_Get_Struct(self, QUEUE_MANAGER, pqm);
|
|
38
|
+
|
|
39
|
+
if(pqm->trace_level) printf ("WMQ::QueueManager#begin() Queue Manager Handle:%ld\n", pqm->hcon);
|
|
40
|
+
|
|
41
|
+
pqm->MQBEGIN(pqm->hcon, 0, &pqm->comp_code, &pqm->reason_code);
|
|
42
|
+
|
|
43
|
+
if(pqm->trace_level) printf("WMQ::QueueManager#begin() MQBEGIN completed with reason:%s\n", wmq_reason(pqm->reason_code));
|
|
44
|
+
|
|
45
|
+
if (pqm->comp_code != MQCC_OK)
|
|
46
|
+
{
|
|
47
|
+
if (pqm->exception_on_error)
|
|
48
|
+
{
|
|
49
|
+
VALUE name = rb_iv_get(self,"@name");
|
|
50
|
+
name = StringValue(name);
|
|
51
|
+
|
|
52
|
+
rb_raise(wmq_exception,
|
|
53
|
+
"WMQ::QueueManager#begin(). Error starting unit of work on Queue Manager:%s, reason:%s",
|
|
54
|
+
RSTRING(name)->ptr,
|
|
55
|
+
wmq_reason(pqm->reason_code));
|
|
56
|
+
}
|
|
57
|
+
return Qfalse;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
return Qtrue;
|
|
61
|
+
}</pre>
|
|
62
|
+
</body>
|
|
63
|
+
</html>
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>commit (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* Commit the current unit of work for this QueueManager instance
|
|
15
|
+
*
|
|
16
|
+
* Note:
|
|
17
|
+
* * commit will have no effect if all put and get operations were performed
|
|
18
|
+
* without specifying :sync => true
|
|
19
|
+
*
|
|
20
|
+
* Returns:
|
|
21
|
+
* * true : On Success
|
|
22
|
+
* * false: On Failure
|
|
23
|
+
*
|
|
24
|
+
* comp_code and reason_code are also updated.
|
|
25
|
+
* reason will return a text description of the reason_code
|
|
26
|
+
*
|
|
27
|
+
* Throws:
|
|
28
|
+
* * WMQ::WMQException if comp_code != MQCC_OK
|
|
29
|
+
* * Except if :exception_on_error => false was supplied as a parameter
|
|
30
|
+
* to QueueManager.new
|
|
31
|
+
*/
|
|
32
|
+
VALUE QueueManager_commit(VALUE self)
|
|
33
|
+
{
|
|
34
|
+
PQUEUE_MANAGER pqm;
|
|
35
|
+
Data_Get_Struct(self, QUEUE_MANAGER, pqm);
|
|
36
|
+
|
|
37
|
+
if(pqm->trace_level) printf ("WMQ::QueueManager#commit() Queue Manager Handle:%ld\n", pqm->hcon);
|
|
38
|
+
|
|
39
|
+
pqm->MQCMIT(pqm->hcon, &pqm->comp_code, &pqm->reason_code);
|
|
40
|
+
|
|
41
|
+
if(pqm->trace_level) printf("WMQ::QueueManager#commit() MQCMIT completed with reason:%s\n", wmq_reason(pqm->reason_code));
|
|
42
|
+
|
|
43
|
+
if (pqm->comp_code != MQCC_OK)
|
|
44
|
+
{
|
|
45
|
+
if (pqm->exception_on_error)
|
|
46
|
+
{
|
|
47
|
+
VALUE name = rb_iv_get(self,"@name");
|
|
48
|
+
name = StringValue(name);
|
|
49
|
+
|
|
50
|
+
rb_raise(wmq_exception,
|
|
51
|
+
"WMQ::QueueManager#commit(). Error commiting changes to Queue Manager:%s, reason:%s",
|
|
52
|
+
RSTRING(name)->ptr,
|
|
53
|
+
wmq_reason(pqm->reason_code));
|
|
54
|
+
}
|
|
55
|
+
return Qfalse;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
return Qtrue;
|
|
59
|
+
}</pre>
|
|
60
|
+
</body>
|
|
61
|
+
</html>
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>backout (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* Backout the current unit of work for this QueueManager instance
|
|
15
|
+
*
|
|
16
|
+
* Since the last commit or rollback any messages put to a queue
|
|
17
|
+
* under synchpoint will be removed and any messages retrieved
|
|
18
|
+
* under synchpoint from any queues will be returned
|
|
19
|
+
*
|
|
20
|
+
* Note:
|
|
21
|
+
* * backout will have no effect if all put and get operations were performed
|
|
22
|
+
* without specifying :sync => true
|
|
23
|
+
*
|
|
24
|
+
* Returns:
|
|
25
|
+
* * true : On Success
|
|
26
|
+
* * false: On Failure
|
|
27
|
+
*
|
|
28
|
+
* comp_code and reason_code are also updated.
|
|
29
|
+
* reason will return a text description of the reason_code
|
|
30
|
+
*
|
|
31
|
+
* Throws:
|
|
32
|
+
* * WMQ::WMQException if comp_code != MQCC_OK
|
|
33
|
+
* * Except if :exception_on_error => false was supplied as a parameter
|
|
34
|
+
* to QueueManager.new
|
|
35
|
+
*/
|
|
36
|
+
VALUE QueueManager_backout(VALUE self)
|
|
37
|
+
{
|
|
38
|
+
PQUEUE_MANAGER pqm;
|
|
39
|
+
Data_Get_Struct(self, QUEUE_MANAGER, pqm);
|
|
40
|
+
|
|
41
|
+
if(pqm->trace_level) printf ("WMQ::QueueManager#backout() Queue Manager Handle:%ld\n", pqm->hcon);
|
|
42
|
+
|
|
43
|
+
pqm->MQBACK(pqm->hcon, &pqm->comp_code, &pqm->reason_code);
|
|
44
|
+
|
|
45
|
+
if(pqm->trace_level) printf("WMQ::QueueManager#backout() MQBACK completed with reason:%s\n", wmq_reason(pqm->reason_code));
|
|
46
|
+
|
|
47
|
+
if (pqm->comp_code != MQCC_OK)
|
|
48
|
+
{
|
|
49
|
+
if (pqm->exception_on_error)
|
|
50
|
+
{
|
|
51
|
+
VALUE name = rb_iv_get(self,"@name");
|
|
52
|
+
name = StringValue(name);
|
|
53
|
+
|
|
54
|
+
rb_raise(wmq_exception,
|
|
55
|
+
"WMQ::QueueManager#backout(). Error backing out changes to Queue Manager:%s, reason:%s",
|
|
56
|
+
RSTRING(name)->ptr,
|
|
57
|
+
wmq_reason(pqm->reason_code));
|
|
58
|
+
}
|
|
59
|
+
return Qfalse;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
return Qtrue;
|
|
63
|
+
}</pre>
|
|
64
|
+
</body>
|
|
65
|
+
</html>
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html>
|
|
7
|
+
<head>
|
|
8
|
+
<title>put (WMQ::QueueManager)</title>
|
|
9
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
11
|
+
</head>
|
|
12
|
+
<body class="standalone-code">
|
|
13
|
+
<pre>/*
|
|
14
|
+
* call-seq:
|
|
15
|
+
* put(parameters)
|
|
16
|
+
*
|
|
17
|
+
* Put a message to the queue without having to first open the queue
|
|
18
|
+
* Recommended for reply queues that change frequently
|
|
19
|
+
*
|
|
20
|
+
* * parameters: a Hash consisting of one or more of the following parameters
|
|
21
|
+
*
|
|
22
|
+
* Summary of parameters and their WebSphere MQ equivalents
|
|
23
|
+
* queue.get( # WebSphere MQ Equivalents:
|
|
24
|
+
* :q_name => 'Queue Name', # MQOD.ObjectName
|
|
25
|
+
* :q_name => { queue_manager=>'QMGR_name', # MQOD.ObjectQMgrName
|
|
26
|
+
* q_name =>'q_name'}
|
|
27
|
+
* :message => my_message, # n/a : Instance of Message
|
|
28
|
+
* :data => "Hello World", # n/a : Data to send
|
|
29
|
+
* :sync => false, # MQGMO_SYNCPOINT
|
|
30
|
+
* :new_id => true, # MQPMO_NEW_MSG_ID & MQPMO_NEW_CORREL_ID
|
|
31
|
+
* :new_msg_id => true, # MQPMO_NEW_MSG_ID
|
|
32
|
+
* :new_correl_id => true, # MQPMO_NEW_CORREL_ID
|
|
33
|
+
* :fail_if_quiescing => true, # MQOO_FAIL_IF_QUIESCING
|
|
34
|
+
* :options => WMQ::MQPMO_FAIL_IF_QUIESCING # MQPMO_*
|
|
35
|
+
* )
|
|
36
|
+
*
|
|
37
|
+
* Mandatory Parameters
|
|
38
|
+
* * :q_name => String
|
|
39
|
+
* * Name of the existing WebSphere MQ local queue, model queue or remote queue to open
|
|
40
|
+
* * To open remote queues for which a local remote queue definition is not available
|
|
41
|
+
* pass a Hash as q_name (see q_name => Hash)
|
|
42
|
+
* OR
|
|
43
|
+
* * :q_name => Hash
|
|
44
|
+
* * q_name => String
|
|
45
|
+
* * Name of the existing WebSphere MQ local queue, model queue or remote queue to open
|
|
46
|
+
* * :q_mgr_name => String
|
|
47
|
+
* * Name of the remote WebSphere MQ queue manager to send the message to.
|
|
48
|
+
* * This allows a message to be written to a queue on a remote queue manager
|
|
49
|
+
* where a remote queue definition is not defined locally
|
|
50
|
+
* * Commonly used to reply to messages from remote systems
|
|
51
|
+
* * If q_mgr_name is the same as the local queue manager name then the message
|
|
52
|
+
* is merely written to the local queue.
|
|
53
|
+
* * Note: q_mgr_name should only be supplied when putting messages to the queue.
|
|
54
|
+
* It is not possible to get messages from a queue on a queue manager other
|
|
55
|
+
* than the currently connected queue manager
|
|
56
|
+
*
|
|
57
|
+
* * Either :message or :data must be supplied
|
|
58
|
+
* * If both are supplied, then :data will be written to the queue. The data in :message
|
|
59
|
+
* will be ignored
|
|
60
|
+
*
|
|
61
|
+
* Optional Parameters
|
|
62
|
+
* * :data => String
|
|
63
|
+
* * Data to be written to the queue. Can be binary or text data
|
|
64
|
+
*
|
|
65
|
+
* * :message => Message
|
|
66
|
+
* * An instance of the WMQ::Message
|
|
67
|
+
* * The Message descriptor, headers and data is retrieved from :message
|
|
68
|
+
* * message.data is ignored if :data is supplied
|
|
69
|
+
*
|
|
70
|
+
* * :sync => true or false
|
|
71
|
+
* * Determines whether the get is performed under synchpoint.
|
|
72
|
+
* I.e. Under the current unit of work
|
|
73
|
+
* Default: false
|
|
74
|
+
*
|
|
75
|
+
* * :new_id => true or false
|
|
76
|
+
* * Generate a new message id and correlation id for this
|
|
77
|
+
* message. :new_msg_id and :new_correl_id will be ignored
|
|
78
|
+
* if this parameter is true
|
|
79
|
+
* Default: false
|
|
80
|
+
*
|
|
81
|
+
* * :new_msg_id => true or false
|
|
82
|
+
* * Generate a new message id for this message
|
|
83
|
+
* * Note: A blank message id will result in a new message id anyway.
|
|
84
|
+
* However, for subsequent puts using the same message descriptor, the same
|
|
85
|
+
* message id will be used.
|
|
86
|
+
* Default: false
|
|
87
|
+
*
|
|
88
|
+
* * :new_correl_id => true or false
|
|
89
|
+
* * Generate a new correlation id for this message
|
|
90
|
+
* Default: false
|
|
91
|
+
*
|
|
92
|
+
* * :fail_if_quiescing => true or false
|
|
93
|
+
* * Determines whether the WMQ::Queue#put call will fail if the queue manager is
|
|
94
|
+
* in the process of being quiesced.
|
|
95
|
+
* * Note: This interface differs from other WebSphere MQ interfaces,
|
|
96
|
+
* they do not default to true.
|
|
97
|
+
* Default: true
|
|
98
|
+
* Equivalent to: MQGMO_FAIL_IF_QUIESCING
|
|
99
|
+
*
|
|
100
|
+
* * Note: As part of the application design, carefull consideration
|
|
101
|
+
* should be given as to when to allow a transaction or
|
|
102
|
+
* unit of work to complete or fail under this condition.
|
|
103
|
+
* As such it is important to include this option where
|
|
104
|
+
* appropriate so that MQ Administrators can shutdown the
|
|
105
|
+
* queue managers without having to resort to the 'immediate'
|
|
106
|
+
* shutdown option.
|
|
107
|
+
*
|
|
108
|
+
* * :options => Fixnum (Advanced MQ Use only)
|
|
109
|
+
* * Numeric field containing any of the MQ Put message options or'd together
|
|
110
|
+
* * E.g. :options => WMQ::MQPMO_PASS_IDENTITY_CONTEXT | WMQ::MQPMO_ALTERNATE_USER_AUTHORITY
|
|
111
|
+
* * Note: If :options is supplied, it is applied first, then the above parameters are
|
|
112
|
+
* applied afterwards.
|
|
113
|
+
* * One or more of the following values:
|
|
114
|
+
* WMQ::MQPMO_NO_SYNCPOINT
|
|
115
|
+
* WMQ::MQPMO_LOGICAL_ORDER
|
|
116
|
+
* WMQ::MQPMO_NO_CONTEXT
|
|
117
|
+
* WMQ::MQPMO_DEFAULT_CONTEXT
|
|
118
|
+
* WMQ::MQPMO_PASS_IDENTITY_CONTEXT
|
|
119
|
+
* WMQ::MQPMO_PASS_ALL_CONTEXT
|
|
120
|
+
* WMQ::MQPMO_SET_IDENTITY_CONTEXT
|
|
121
|
+
* WMQ::MQPMO_SET_ALL_CONTEXT
|
|
122
|
+
* WMQ::MQPMO_ALTERNATE_USER_AUTHORITY
|
|
123
|
+
* WMQ::MQPMO_RESOLVE_LOCAL_Q
|
|
124
|
+
* WMQ::MQPMO_NONE
|
|
125
|
+
* * Please see the WebSphere MQ documentation for more details on the above options
|
|
126
|
+
* Default: WMQ::MQPMO_NONE
|
|
127
|
+
*
|
|
128
|
+
* Returns:
|
|
129
|
+
* * true : On Success
|
|
130
|
+
* * false: On Failure
|
|
131
|
+
*
|
|
132
|
+
* comp_code and reason_code are also updated.
|
|
133
|
+
* reason will return a text description of the reason_code
|
|
134
|
+
*
|
|
135
|
+
* Throws:
|
|
136
|
+
* * WMQ::WMQException if comp_code == MQCC_FAILED
|
|
137
|
+
* * Except if :exception_on_error => false was supplied as a parameter
|
|
138
|
+
* to QueueManager.new
|
|
139
|
+
*/
|
|
140
|
+
VALUE QueueManager_put(VALUE self, VALUE hash)
|
|
141
|
+
{
|
|
142
|
+
MQLONG BufferLength; /* Length of the message in Buffer */
|
|
143
|
+
PMQVOID pBuffer; /* Message data */
|
|
144
|
+
/*-----------------10/22/2006 7:11PM----------------
|
|
145
|
+
* TODO: Need dynamic buffer here!
|
|
146
|
+
* --------------------------------------------------*/
|
|
147
|
+
MQBYTE header_buffer[65535]; /* message buffer for header use */
|
|
148
|
+
MQMD md = {MQMD_DEFAULT}; /* Message Descriptor */
|
|
149
|
+
MQPMO pmo = {MQPMO_DEFAULT}; /* put message options */
|
|
150
|
+
MQOD od = {MQOD_DEFAULT}; /* Object Descriptor */
|
|
151
|
+
VALUE q_name;
|
|
152
|
+
VALUE str;
|
|
153
|
+
size_t size;
|
|
154
|
+
size_t length;
|
|
155
|
+
VALUE val;
|
|
156
|
+
|
|
157
|
+
PQUEUE_MANAGER pqm;
|
|
158
|
+
Data_Get_Struct(self, QUEUE_MANAGER, pqm);
|
|
159
|
+
|
|
160
|
+
Check_Type(hash, T_HASH);
|
|
161
|
+
|
|
162
|
+
q_name = rb_hash_aref(hash, ID2SYM(ID_q_name));
|
|
163
|
+
|
|
164
|
+
if (NIL_P(q_name))
|
|
165
|
+
{
|
|
166
|
+
rb_raise(rb_eArgError,
|
|
167
|
+
"Mandatory parameter :q_name is missing from WMQ::QueueManager::put1()");
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
/* --------------------------------------------------
|
|
171
|
+
* If :q_name is a hash, extract :q_name and :q_mgr_name
|
|
172
|
+
* --------------------------------------------------*/
|
|
173
|
+
if(TYPE(q_name) == T_HASH)
|
|
174
|
+
{
|
|
175
|
+
WMQ_HASH2MQCHARS(q_name, q_mgr_name, od.ObjectQMgrName)
|
|
176
|
+
|
|
177
|
+
q_name = rb_hash_aref(val, ID2SYM(ID_q_name));
|
|
178
|
+
if (NIL_P(q_name))
|
|
179
|
+
{
|
|
180
|
+
rb_raise(rb_eArgError,
|
|
181
|
+
"Mandatory parameter :q_name missing from :q_name hash passed to WMQ::QueueManager#put");
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
WMQ_STR2MQCHARS(q_name,od.ObjectName)
|
|
186
|
+
|
|
187
|
+
Queue_extract_put_message_options(hash, &pmo);
|
|
188
|
+
Message_build(&pqm->p_buffer, &pqm->buffer_size, pqm->trace_level,
|
|
189
|
+
hash, &pBuffer, &BufferLength, &md);
|
|
190
|
+
|
|
191
|
+
if(pqm->trace_level) printf("WMQ::QueueManager#put Queue Manager Handle:%ld\n", pqm->hcon);
|
|
192
|
+
|
|
193
|
+
pqm->MQPUT1(
|
|
194
|
+
pqm->hcon, /* connection handle */
|
|
195
|
+
&od, /* object descriptor */
|
|
196
|
+
&md, /* message descriptor */
|
|
197
|
+
&pmo, /* put message options */
|
|
198
|
+
BufferLength, /* message length */
|
|
199
|
+
pBuffer, /* message buffer */
|
|
200
|
+
&pqm->comp_code, /* completion code */
|
|
201
|
+
&pqm->reason_code); /* reason code */
|
|
202
|
+
|
|
203
|
+
if(pqm->trace_level) printf("WMQ::QueueManager#put MQPUT1 ended with reason:%s\n", wmq_reason(pqm->reason_code));
|
|
204
|
+
|
|
205
|
+
if (pqm->reason_code != MQRC_NONE)
|
|
206
|
+
{
|
|
207
|
+
if (pqm->exception_on_error)
|
|
208
|
+
{
|
|
209
|
+
VALUE qmgr_name = QueueManager_name(self);
|
|
210
|
+
|
|
211
|
+
rb_raise(wmq_exception,
|
|
212
|
+
"WMQ::QueueManager.put(). Error writing a message to Queue:%s on Queue Manager:%s reason:%s",
|
|
213
|
+
RSTRING(q_name)->ptr,
|
|
214
|
+
RSTRING(qmgr_name)->ptr,
|
|
215
|
+
wmq_reason(pqm->reason_code));
|
|
216
|
+
}
|
|
217
|
+
return Qfalse;
|
|
218
|
+
}
|
|
219
|
+
else
|
|
220
|
+
{
|
|
221
|
+
VALUE message = rb_hash_aref(hash, ID2SYM(ID_message));
|
|
222
|
+
if(!NIL_P(message))
|
|
223
|
+
{
|
|
224
|
+
VALUE descriptor = rb_funcall(message, ID_descriptor, 0);
|
|
225
|
+
Message_from_mqmd(descriptor, &md); /* This could be optimized to output only fields */
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
return Qtrue;
|
|
230
|
+
}</pre>
|
|
231
|
+
</body>
|
|
232
|
+
</html>
|