Examples of how to set MSIF options

The information that instructs MSIF transfer service about how it is to process a request can be specified in the request itself or, if it is not in the request, obtained from an option set. The examples in this section illustrate how you can distribute this information between the option sets and requests.

Assume that you want to create a SendFile request, and that you want the resulting request primitive to contain the option values shown in Table 1, and to use the SAG communication options shown in Table 2.

Table 1. Example of options specified by a request primitive
Option type	Option	Value
Transfer options	LocalDN	o=ptsatwff,o=swift
	RemoteDN	ou=winfa2,o=ptsatwff, o=swift
	Service	swift.generic.fa!x
	RequestType	pacs.xxx.sct.s.any
File send options	Signed	True
	CryptoMethod	CryptoBlock
	ReturnSignatureList	False
	NRIndication	True
	DeliveryMode	SNF
	TransferDescription	store-and-forward
	TransferInfo	mode=SNF
	DeliveryNotif	True
	Priority	Normal
	RelativeExpiration	P0DT1H0M
	Copy	False
	AuthNotif	False
Delivery notification options	LocalDN	ou=OU1,o=ptsatwff, o=swift
	RequestType	xsys.xxx.delnotif
	AppNotifQueue	INST1.APPL.NOTIF
	QueueManager	QM012
	AuthorisationAction	App
	RefusalAction	App
	NonDelivWarningAction	App
	SuccessDelivNotifAction	App
	FailedDelivNotifAction	Event
File options	AppCodepage	(no code page conversion)
	NetworkCodepage	(no code page conversion)
	Compression	Zip
	CompressionLevel	BestSpeed
	EntryNameInContainer	transactions.rje
	FileDescription	"compressed file in SWIFT RJE format"
	FileInfo	"Format=SWIFTRJE"
	HeaderInfo	(none)
SAG MP options	SnlId	snl00001
	MP	EFAMPOU1
	SnlEP	(none)
	NotifSnFQueue	MY.SNF.QUEUE
	AuthoriserDN	cn=testfa,ou=test, o=ptsatwffa, o=swift
	SignerDN	(none)
	EncryptDN	(none)

Table 2. Example of SAG communication option settings
SAG communication option	Value	Notes
SagRequestQueue	ITA.SNL00001.SPECIFIC.CLIENT.REQUEST
SagQueueManager	MYQMGR
SWIFTNetVersion	70	These are the system defaults, and so are not explicitly set in the option set.
MaxAutoRecoverCount	0
AutoRecoverInterval	120
RTRecoveryOptionSet	(none)
SnFRecoveryOptionSet	(none)
TimeToRecover	P0DT24H0M
TransferEP	(none)
EventMP	EFAMPEVT
SagDirectory	C:\tmp\mqha
SagSubDirectory	efa\files
TransferDirectory	sag/files
CommType	MQHA
LftPutFileQueue	ITA.SNL00001. DNF_PUTFILEQ
LftGetFileQueue	ITA.DNF_GETFILEQ
LftTimeOut	90 seconds	These are the system defaults, and so are not explicitly set in the option set.
LftMaxRetryCount	2
LftChunking	(set)
LftChunkSize	4	These are the system defaults, and so are not explicitly set in the option set.
MaxFileSize	2147483648
FileWindowSize	15	Assuming the SAG is running with 3 FileAct client processes.

Each of the following examples results in the same request primitive being sent to the SAG. The only differences are from where the value for each option is obtained:

Example 1: The minimum number of options are specified in the request and the maximum number of options are supplied by option sets. See Example 1.
Example 2: The maximum number of options are specified in the request and the minimum number of options are supplied by option sets. See Example 2.
Example 3: Some options are both specified in the request and supplied by option sets. See Example 3.

The same principles apply also for other scenarios, such as SendMsg, ProvideFileForDownload, or DownloadFile scenarios. For more information about how you can distribute information among option sets and requests, see Options and option sets.