mqsload/ReadMe.txt

# $RCSfile: ReadMe.txt,v $
# $Revision: 1.9 $
# $Name:  $
# $Date: 2008/12/12 10:47:06 $
# $Author: agibert $





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



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

	- You only need the MQSLoad.class file.



Notes:
------

	- MQSLoad has been tested with WMQ 6.0

	- 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":		

	- Mandatory arguments:
	  <Output_MsgQueue_Name>:	
	  <Input_File_Name>:		


	- "-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 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