From 5c1c862d5ed11edec114314326a2a76d19a63e59 Mon Sep 17 00:00:00 2001 From: agibert Date: Mon, 5 Jan 2009 16:16:59 +0000 Subject: [PATCH] Document new options and add an example. --- ReadMe.txt | 51 ++++++++++++++++++++++++++++++++++----------------- 1 file changed, 34 insertions(+), 17 deletions(-) diff --git a/ReadMe.txt b/ReadMe.txt index 728c1ad..1574f40 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,7 +1,7 @@ # $RCSfile: ReadMe.txt,v $ -# $Revision: 1.9 $ +# $Revision: 1.10 $ # $Name: $ -# $Date: 2008/12/12 10:47:06 $ +# $Date: 2009/01/05 16:16:59 $ # $Author: agibert $ @@ -21,29 +21,40 @@ Installation: -Notes: +Usage: ------ + MQSLoad [-qm "Output_QueueMng_Name"] [-cc] [-cs "character_set"] [-mp "message_priority"] [-st "sleep_time"] [-fb "field_break"] [-mb "message_break"] [-mt "message_tail"] [-kmb] [-ms "message_skip"] [-mc "message_count"] [-rc "repeat_count"] - - MQSLoad has been tested with WMQ 6.0 + Default: Output QueueMng Name: () Character Convert: (false) Character Set: (1208) Message Priority: (-1) Sleep Time: (0) Field Break: () Message Break: (\r\n) Message Tail: () Keep Message Break: (false) Message Skip: (0) Message Count: (0) Repeat Count: (1) + + +Arguments: +---------- - Optional arguments: - -qm "Output_QueueMng_Name": - -cc "character_convert": - -cs "character_set": - -st "sleep_time": - -fb "field_break": - -mb "message_break": - -mt "message_tail": - -kmb: - -ms "message_skip": - -mc "message_count": - -rc "repeat_count": + -qm "Output_QueueMng_Name": Name of the queue manager to use, + -cc "character_convert": Switch on the caracter conversion (Set the MQMessage format to MQC.MQFMT_STRING), + -cs "character_set": QMessage character set, + -mp "message_priority": Priority of the message, + -st "sleep_time": Delay between message sending, + -fb "field_break": String used as field separator, + -mb "message_break": String used as message separator, + -mt "message_tail": String added at the message end, + -kmb "keep_message_break": Keep the message break (inserted at the message end, next to the message tail), + -ms "message_skip": Number of messages to skip before to start the loading, + -mc "message_count": Number of messages to load, + -rc "repeat_count": Number of time the whole process (start of file + skip + load) should be repeated. - Mandatory arguments: - : - : + : Name of the output message queue to load to, + : Name of the input file to load from. + +Notes: +------ + - MQSLoad has been tested with WMQ 6.0 + - "-fb" and "-mb" arguments accept a string with formated escape character: + "\n" for newline, + "\r" for return, @@ -72,9 +83,15 @@ Usage Examples: - To load a swift batch file "swift-batch.txt" with "---MESSAGE-BREAK---" message separator into the MQ/Series "SWIFT-QUEUE" use: java MQSLoad -mb "---MESSAGE-BREAK---\r\n" SWIFT-QUEUE swift-batch.txt + + - To load 10 time the third message of the file "swift-batch.txt" with "---MESSAGE-BREAK---" as message separator into the MQ/Series "SWIFT-QUEUE" use: + java MQSLoad -mb "---MESSAGE-BREAK---\r\n" -ms 2 -mc 1 -rc 10 SWIFT-QUEUE swift-batch.txt + - To load a raw swift batch file "swift-batch-raw.txt" with "}\r\n" message break into the MQ/Series "SWIFT-QUEUE" and by keeping message break separator use: java MQSLoad -mb "}\r\n" -kmb SWIFT-QUEUE swift-batch-raw.txt + - To load a raw swift batch file "swift-batch-raw.txt" with "}\r\n" message break into the MQ/Series "SWIFT-QUEUE" and by keeping only "}" as end of message use: java MQSLoad -mb "}\r\n" -mt "}" SWIFT-QUEUE swift-batch-raw.txt + - To load a csv batch file "batch.csv" with ";" field separator into the MQ/Series "DATA-QUEUE" use: java MQSLoad -fb ";" DATA-QUEUE csv-batch.csv