Post Transfer Action Troubleshooting

Gateway Administrator PTAs

To view Gateway Administrator PTA output and error messages, use the Gateway Administrator console log file and look for entries that include TransferSiteEventHandler. The default location is.:

C:\Program Files\Attachmate\FileXpress\Gateway\GatewayAdministrator\logs\console.yyyymmdd.log

Also review the following troubleshooting guidelines:

  • If the PTA doesn't run, confirm that the action is added to your transfer site.
  • Check the log to see if any resolved arguments include spaces. Use double quotation marks around these tokens.
  • If the log includes syntax errors, check to see if any resolved arguments include unsupported characters.
  • If the log includes the error "Unable to complete Transfer Site action," check to see that the configured name and path specified for the PTA program are correct. If the the action configuration includes a full path to the executable program, confirm that the SFTP server user account has rights to access this path.
  • If the log includes permission errors, check to see if the SFTP server user account has permissions to write to locations required by actions defined in the PTA. If you are using the default FileXpress proxy setting for file storage, review the configuration information in Configure PTAs in Gateway Administrator.
  • If PTAs fail to execute and/or the server starts showing very high CPU utilization, you may have multiple queued PTA events that are not completing or are taking unexpectedly long to complete. Check the event queue file (<install path>\GatewayAdministrator\etc\eventQueue.rnd). If this file is large (>500 KB), it suggests that events that have not completed are preventing others from being processed. To remove all queued events, delete this file.
  • If you are running a Gateway Administrator cluster, confirm that you have configured file storage on an SFTP server. If the FileXpress Gateway Proxy is used as the file storage server, and it is installed on the same system as one of the Gateway Administrator instances, actions will not run reliably.

Reflection for Secure IT PTAs

To view Reflection for Secure IT PTA output and error messages, configure output to the debug (text) log file. For details, see Configure PTAs in Reflection for Secure IT.

Also review the following troubleshooting guidelines:

  • Confirm that you saved your server settings after creating or modifying your action and that the action is enabled.
  • If the PTA doesn't run, the expression for your filter might be incorrect. Try a test with the default filter (.*).
  • Check the log to see if any resolved arguments include spaces. Use double quotation marks around these tokens.
  • If the log includes syntax errors, check to see if any resolved arguments include unsupported characters.