IBM Support

How to Receive Binary files via SFTP

Troubleshooting


Problem

User is wanting to receive a binary file from their SFTP server. However when they try this using the same file name structure as a FTP receiver it does not work. For an FTP Receiver to receive binary files it has to follow this structure: Binary files have a required file name structure, because the files are not inspected at all by the Document Manager. The file name structure is: "To_PartnerID.Unique_Filename" When a binary file is detected by the Receiver component, it is written to shared storage and passed to the Document Manager for processing. The name of the directory in which the file was detected is used to evaluate the From Partner Name, and the first part of the file name is used to evaluate the To Partner Name. The position of the file in the directory structure is used to evaluate whether the transaction is a Production or Test transaction. For example, a file named 123456789.abcdefg1234567 is detected in the \ftproot\partnerTwo\binary\production directory. The Document Manager knows the following information: The From Partner Name is partnerTwo (because the file was found in the partnerTwo part of the directory tree). The To Partner Name is partnerOne (because the first part of the file name is 123456789, which is the DUNS ID for partnerOne). Note: All DUNS numbers are meant to be examples only. WebSphere Partner Gateway requires the To_PartnerID to match the recipient partner DUNS. In case the Duns ID is not found, the channel lookup will fail. The Transaction type is Production. The Document Manager looks for a Production partner connection from partnerTwo to partnerOne for: Package: None (N/A) Protocol: Binary (1.0) Document Type: Binary (1.0) The Document Manager then processes the file. Binary files can also be transferred over FTP using either the GenericPreprocess handler or FileNamePartnerId handler.

Environment


Resolving The Problem

If the user wishes to send Binary files using the SFTP receiver, they can use the GenericDocumentFlowHandler to achieve this.





Using this pre-process handler you would be able to receive Binary files using the SFTP receiver. However to add pre-process handlers to the SFTP receiver you would need to add certain SFTP APAR fixes. You will need to move to Fix pack 2 or later which contains these apar fixes

[{"Product":{"code":"SSDKKW","label":"WebSphere Partner Gateway Advanced Edition"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF033","label":"Windows"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"6.2.0.3;6.2.0.2;6.2.0.1;6.2;6.2.0.4;6.2.0.5;6.2.1.0","Edition":"Advanced;Enterprise","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
16 June 2018

UID

swg21433903