+

Search Tips | Advanced Search

DestinationTransferEndExit.java interface


DestinationTransferEndExit.java

/*
 *   Licensed Materials - Property of IBM
 *
 *   "Restricted Materials of IBM"
 *
 *   5724-H72
 * 
 *    Copyright IBM Corp. 2008, 2020. All Rights Reserved.
 * 
 *   disclosure restricted by GSA ADP Schedule Contract with
 *   IBM Corp.
 */
package com.ibm.wmqfte.exitpoint.api;

/**
 * An interface that is implemented by classes that want to be invoked as part of
 * user exit routine processing.  This interface defines a method that will be
 * invoked immediately after completing a transfer on the agent acting as the
 * destination of the transfer.
 */
public interface DestinationTransferEndExit {

	/**
	 * Invoked immediately after the completion of a transfer on the agent acting as
	 * the destination of the transfer.
	 * 
	 * @param transferExitResult
	 *            a result object reflecting whether or not the transfer completed
	 *            successfully.
	 * 
	 * @param sourceAgentName
	 *            the name of the agent acting as the source of the transfer.
	 * 
	 * @param destinationAgentName
	 *            the name of the agent acting as the destination of the
	 *            transfer.	 This is the name of the agent that the 
	 *            implementation of this method will be invoked from.
	 * 
	 * @param environmentMetaData
	 *            meta data about the environment in which the implementation
	 *            of this method is running.  This information can only be read,
	 *            it cannot be updated by the implementation.  The constants
	 *            defined in <code>EnvironmentMetaDataConstants</code> class can 
	 *            be used to access the data held by this map.
	 * 
	 * @param transferMetaData
	 *            meta data to associate with the transfer.  The information can
	 *            only be read, it cannot be updated by the implementation.  This 
	 *            map may also contain keys with IBM reserved names.  These 
	 *            entries are defined in the <code>TransferMetaDataConstants</code> 
	 *            class and have special semantics.
	 * 
	 * @param fileResults
	 *            a list of file transfer result objects that describe the source
	 *            file name, destination file name and result of each file transfer
	 *            operation attempted.
	 * 
	 * @return    an optional description to enter into the log message describing
	 *            transfer completion.  A value of <code>null</code> can be used
	 *            when no description is required.
	 */
	String onDestinationTransferEnd(TransferExitResult transferExitResult,
					String sourceAgentName,
					String destinationAgentName,
					Map<String, String>environmentMetaData,
					Map<String, String>transferMetaData, 
					List<FileTransferResult>fileResults);
}
Parent topic: Java interfaces for MFT user exits


Related reference


Related information

Last updated: 2020-10-04