Creating an archive of MFT troubleshooting information

After you have collected the data needed to investigate the Managed File Transfer (MFT) problem that you are seeing, you need to create an archive that contains all of the relevant files and send it in to IBM® Support. You can either create the archive manually, or by using the fteRAS utility.

About this task

Warning: If there are a large number of Managed File Transfer agents configured on a system, the fteRAS command can take a long time to complete. If that happens, you should create the archive manually by compressing the contents of the Managed File Transfer agent's logs and configuration directories into a zip file.

[MQ 9.3.4 Oct 2023] From IBM MQ 9.3.4, you can collect troubleshooting information for a specific Managed File Transfer agent or agents instead of for all agents on the system. You do this by running the fteRAS command with the -agents parameter.

Procedure

To archive the Managed File Transfer files automatically using the fteRAS command:
- On UNIX and Linux®, copy any interactive command traces and javacores to the /var/mqm/errors directory and then run the fteRAS command as shown in the following example:
```
sh> fteRAS /var/mqm/errors
...
BFGCL0604I: fteRAS command completed successfully. Output is stored in /var/mqm/errors/fteRAS.zip
```
- On Windows, copy any interactive command traces and javacores to the top-level IBM MQ errors directory. The actual path name of this directory depends on which version of IBM MQ you are using. For more information, see Program and data directory locations on Windows. Run the fteRAS command with the correct path name for your system, for example:
```
C:\> fteRAS "C:\ProgramData\IBM\MQ\errors"
...
BFGCL0604I: fteRAS command completed successfully. Output is stored in C:\ProgramData\IBM\MQ\errors\fteRAS.zip
```
- On IBM i, copy any interactive command traces and javacores you created (that is, spool files from the GENJVMDMP command) to /QIBM/UserData/mqm/errors and then run the fteRAS command from the Qshell as shown in the following example:
```
===> /QIBM/ProdData/mqm/bin/fteRAS /QIBM/UserData/mqm/errors
...
BFGCL0604I: fteRAS command completed successfully. Output is stored in /QIBM/UserData/mqm/errors/fteRAS.zip
```
To archive the Managed File Transfer files manually:
- On UNIX and Linux, copy the agent and logger javacores, traces, logs, properties and FFST files. Include any interactive command traces and javacores written to the current directory or to other directories as well as the contents of:
```
/var/mqm/mqft/logs/COORDQMNAME/*
/var/mqm/mqft/config/COORDQMNAME/*
```
- On Windows, copy the agent and logger Javacores, traces, logs, properties and FFST files. Include any interactive command traces and javacores written to the current directory or to other directories as well as the contents of the following directories.
```
C:\Program Files\IBM\MQ\mqft\logs\COORDQMNAME\*
C:\Program Files\IBM\MQ\mqft\config\COORDQMNAME\*
```
  The actual path name of these directories depends on which version of IBM MQ you are using. For more information, see Program and data directory locations on Windows.
- On IBM i, copy the agent and logger JVM dumps, traces, logs, properties and FFST files. Include any interactive command traces and javacores you created (that is, spool files from the GENJVMDMP command), as well as the contents:
```
/QIBM/UserData/mqm/mqft/logs/COORDQMNAME/*
/QIBM/UserData/mqm/mqft/config/COORDQMNAME/*
```

What to do next

Send the information that you have collected to IBM. For more information, see Step 3 of Collecting information for Managed File Transfer problems on Multiplatforms.