MQSecurityExit

 



public interface MQSecurityExit
extends Object

The security exit interface allows you to customize the security flows that occur when an attempt is made to connect to a queue manager.

Note:
This interface does not apply when connecting directly to WebSphere MQ in bindings mode.

To provide your own security exit, define a class that implements this interface. Create a new instance of your class and assign the MQEnvironment.securityExit variable to it before constructing your MQQueueManager object. For example:


// in MySecurityExit.java
class MySecurityExit implements MQSecurityExit {
  //  provide an implementation
  // of the securityExit method
  public byte[] securityExit(
    MQChannelExit       channelExitParms,
    MQChannelDefinition channelDefinition,
    byte[]              agentBuffer)
  {
    // your exit code goes here...
  }
}
// in your main program...
MQEnvironment.securityExit = new MySecurityExit();
 ...    // other initialization
MQQueueManager qMgr        = new MQQueueManager("");

 

Methods

securityExit
public abstract byte[] securityExit MQChannelExit(channelExitParms,
                           MQChannelDefinition channelDefinition,
                           byte agentBuffer[])

The security exit method that your class must provide.

Parameters

channelExitParms
Contains information regarding the context in which the exit is being invoked. The exitResponse member variable is an output parameter that you use to tell the WebSphere MQ Client for Java what action to take next. See the MQChannelExit for further details.

channelDefinition
Contains details of the channel through which all communications with the queue manager take place.

agentBuffer
If the channelExitParms.exitReason is MQChannelExit.MQXR_SEC_MSG, agentBuffer contains the security message received from the queue manager; otherwise agentBuffer is null.

Returns

If the exit response code (in channelExitParms) is set so that a message is to be transmitted to the queue manager, your security exit method must return the data to be transmitted.

See also:

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.