Troubleshooting an MFT agent that is not listed by the fteListAgents command

If your agent is not listed by the fteListAgents command or is not displayed in IBM® MQ Explorer, or your file transfers are not displayed in the Transfer Log of IBM MQ Explorer, use a flowchart to investigate the cause.

About this task

Use the following flowchart to help you to diagnose problems and decide what action to take next.

Flowchart:

The diagram shows a flowchart of steps to diagnose your issue. If the fteListAgents command does not list your agent, go to question A. Question A: Are messages building up on the SYSTEM.FTE queue on your coordination queue manager? If yes, go to question B. If no, go to question E. Question B: Have you set the queue manager property PSMODE(ENABLED)? If yes, go to question C. If no, go to solution U. Question C: Have you added SYSTEM.FTE to the coordination queue manager namelist? On z/OS, you must do this when the CHIN is up and running. If yes, go to question D. If no, go to solution V. Question D: Is your coordination queue manager running in a double byte character set on z/OS? If yes, go to solution W. If no, go to solution T. Question E: Is your agent connecting using an intermediate queue manager or agent queue manager? If yes, go to question F. If no, go to solution E. Question F: Are messages building up on the Xmit queue from the agent queue manager to the coordination queue manager? If yes, go to solution X. If no, go to solution Y. Question G: Do the object authorities for the SYSTEM.FTE topic allow this user ID to publish? If no, go to solution Z. If yes, go to solution T. Solution T: Contact the IBM support center for further assistance. Solution U: Set PSMODE(ENABLED) on the coordination queue manager. Solution V: Add SYSTEM.FTE to the coordination queue manager namelist. Solution W: Apply PTF UK47010 to IBM MQ on your z/OS system. Solution X: Xmit queue is not being used by active channels between the agent and coordination queue managers. Alter the sender channel on the agent queue manager side to use the correct Xmit queue. Solution Y (contains label 1): Check which user ID is included in the message descriptor of the messages on the SYSTEM.FTE queue on the coordination queue manager. Solution Z (contains label 2): Either add publish authority for this user ID or change the user ID that is presented by the message descriptor.

Flowchart key:

  1. For more information about how to check the user ID that is presented, see Examining messages before publication. User IDs must conform to the MQ user name 12 character limit. If a user name is longer than 12 characters (Administrator, for example) the user name will be truncated before being checked for authorisation. In an example using Administrator, the following error message is added to the queue manager error log: 
    AMQ8075: Authorization failed because the SID for entity 'administrato' cannot be obtained.
  2. For more information about the authority needed for the SYSTEM.FTE queue, see Authority to publish MFT Agents log and status messages.