mqsload/ReadMe.txt

# $RCSfile: ReadMe.txt,v $
# $Revision: 1.8 $
# $Name:  $
# $Date: 2007/12/11 16:46:37 $
# $Author: agibert $





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



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

	- You only need the MQSLoad.class file.



Notes:
------

	- MQSLoad has been tested with MQ/Series 5.2, 5.3 and 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 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