Register command

This command enables a client application or service to monitor FTM SWIFT events.

Use the Register command to register a client application or service to receive a set of FTM SWIFT events on a specified queue.

For more information about the structure of an FTM SWIFT event, see ComIbmDni folder in LocalEnvironment or MQRFH2. For an application, the event information is always located in the MQRFH2 of an IBM® MQ message.

Prerequisites

None.

Process

The monitor service performs the following processing for a Register command:
  • Checks whether the ComIbmDni.OU.Function.DNI_MONITOR.reg.Request folder contains a properly specified request
  • Checks whether the user is authorized to register to receive FTM SWIFT events for the specified OU
  • Registers the client application or service to receive a set of FTM SWIFT events
  • Sends a response to the client application or service

Error conditions

If an error occurs during processing or access is denied, the monitor service sends a response to the client application or service with the following characteristics:
  • The ComIbmDni.Function.DNI_MONITOR.reg.Response.Completion.MPU field is set to DNIM5001E.
  • The ComIbmDni.Function.DNI_MONITOR.reg.Response.Completion.Code field is set to Failed.
  • The ComIbmDni.Function.DNI_MONITOR.reg.Response.Completion.ReasonList folder contains one or more Reason folders whose Response.MPU field is set to one of the following values:
    • DNIM5002E
    • DNIM5004E
    • DNIM5006E
    • DNIM5008E
    • DNIM5009E
    • DNIM5011E
    • DNIM5012E
    • DNIM5013E
    • DNIM5014E
    • DNIM5017E
See Codes for the corresponding message texts.