Password Management
The supplied FIX_FXCMPRO_Support.mon service monitor can be used to reset the FXCMPRO session password. This monitor should be injected after all of the standard service monitors, but before any FXCMPRO sessions are configured.
To reset the password for a FXCMPRO session, sent the following event to the correlator:
com.apama.fix.fxcmpro.PasswordChangeRequest(<transport>, <requestId>,
<userId>, <oldPassword>, <newPassword>)
Where:
<transport> is the session/transport name (e.g. "FXCMPRO_TRADING")
<requestId> is a user-supplied key to identify replies to this request
<userId> is the SenderCompId for this session
<oldPassword> is the existing password for the session
<newPassword> is the desired new password for the session
Each request should result in a com.apama.fix.fxcmpro.PasswordChangeResponse() event being routed and logged by the monitor:
com.apama.fix.fxcmpro.PasswordChangeResponse(<transport>,
<requestId>, <userId>, <success>, <status>, <message>)
Where:
<transport> is the session/transport name
<requestId> is the user-supplied identifier from the request
<userId> is the SenderCompId from the request
<success> is a boolean value indicating whether the password was changed
<status> is one of the RESPONSE_* constants listed in the FIX_FXCMPRO_Support monitor. Typical values are RESPONSE_PASSWORD_CHANGED ("5") or RESPONSE_USER_NOT_RECOGNISED ("3") which FXCMPRO uses as a catch-all failure code.
<message> is any error message returned by the server
A password reset can be performed at any time after the session has been successfully logged on and a Trading Session Status of "Open" has been sent (this will be logged by the FIX Session Manager). A password reset is *required* if the server sends a Trading Session Status of "Halted" immediately after a successful logon (this will be logged at WARN level by the FIX FXCMPRO Password Manager). Note that you cannot successfully log on with an expired password, so it is advised to perform a password reset as soon as the "Halted" session status is seen. The session will be locked after too many login attempts with an expired password, and can only be unlocked by calling FXCMPRO technical support.