# $RCSfile: ReadMe.txt,v $
# $Revision: 1.10 $
# $Name:  $
# $Date: 2009/01/05 16:16:59 $
# $Author: agibert $





Compilation:
------------
	- Just type: "javac MQSLoad.java" !



Installation:
-------------

	- You only need the MQSLoad.class file.



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"] <Output_MsgQueue_Name> <Input_File_Name>

	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":	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:
	  <Output_MsgQueue_Name>:	Name of the output message queue to load to,
	  <Input_File_Name>:		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,
		+ "\t" for tabulation,
		+ "\\" for \.

	- Message breaks are used for message separation in the batch file,
	- Message breaks are striped from the sended message if "-kmb" (keep message break) is not set,
	- Message tail specified after "-mt" option is inserted between message and message break,
	- Field breaks are striped from the sended message.
 
	- Windows text files: newline is specified as "\r\n",
	- Unix text files: newline is specified as "\n".

	- By default:
		+ There is no field break,
		+ Message break is "\r\n",
		+ Message breaks are striped.

	- This software is under the GNU General Public License. See GNU-GPL.txt.



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