> For the complete documentation index, see [llms.txt](https://amfdocs.mftlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://amfdocs.mftlabs.io/agile-messaging-framework/tutorials/usecases/uc22.md).

# UC22

**S3** **--> SFG --> AMF --> SFG -->** **CD**

**Use Case:** We run Schedule to get file from Partner43 (Sender) folder to SFG via S3 Protocol, we Unzip the file and Deliver those files to the Partner44 (Receiver) using CD Protocol via AMF.&#x20;

**Sequence Diagram:**

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2Fv89Kj2AE0SHd4apZVlEe%2FUC22.drawio.png?alt=media&amp;token=ae047d07-e0f4-49cb-8053-f751b64d81d1" alt=""><figcaption></figcaption></figure>

**Steps:**&#x20;

A. Onboard Partner43 and Partner44 in SFG using AMF.

B. Onboard Partner43 S3 Receive profile in SFG using AMF (MFT Initiated Communication Profile (Inbound)).

C. Create Communication Rule with Sender; Receiver, Message Type and Comm. Profile Name select Delivery Type as Schedule.

D. Onboard Partner44 Connect Direct Node in SFG using AMF (Customer Initiated Communication Profile (Inbound)).&#x20;

E. Create Message Type or use the existing one in AMF.&#x20;

F. Create Message Mapping with Sender, Receiver and Message Type with a file pattern.

G. Create GUNZIP Action as Action Type.

H. Create EOL Conversion Action as Action Type.

I. Create Delivery Action or use the predefined one (Deliver as is).

J. Create Workflow Definitions and add Actions (Created in **step G** and **step H** and  **step I**) as step1, step2 and step3 respectively.

K. Create Workflow Rule with Sender, Receiver, Message Type and Workflow Definition Name (Created in **step J**).

L. Onboard Partner44 Connect Direct Node Profile in SFG using AMF (MFT Initiated Communication Profile (Outbound))

M. Create Communication Rule with Sender, Receiver, Message Type and Comm. Profile Name.

N. Verify the Message Activity in AMF once the Partner43 uploads the file to SFG via S3 protocol. If everything was configured correctly, the file will be delivered to Partner44 via CD protocol.&#x20;

**Process:**

**A. Onboard Partner43 and Partner44 in SFG using AMF:**

Login to AMF

![
](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FoUU9cbSIJ6MZeysF3rOA%2F0.png?alt=media)

Go to Onboarding -> Users

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2F4pOvgm8t17WAwzeuUiBG%2F1.png?alt=media)

Click on + icon at the top right corner

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FhMwMknhZFOqW4V7PE1CJ%2F2.png?alt=media)

Select Customer and give details of Partner43, select User Type, Authentication Type and click next.

1. **User Type**: Which Zone does the partner belong to send or receive files? (DMZ or Trusted)
2. **Authentication Type**: Where we store the partner credentials? (LDAP or local (SFG/AMF) or Both)

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2Fh6lna36mnk68Bn8yrA3p%2F3.png?alt=media" alt=""><figcaption></figcaption></figure>

Select the provider the Partner belong to and click next

1. **AMF:** AMF provider is used to onboard Partners which use UFA
2. **IBM:** This will come from the providers config. We can choose several types based on the provider's config.
3. **Open Ldap:** We need to select this if we selected the Authentication Type as LDAP in the step &#x32;**.**

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2Fx5Yp54EuLM8yoNchDSNi%2F4.png?alt=media" alt=""><figcaption></figcaption></figure>

Verify the Partner details and click **Onboard User**.

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FL2lbgY0ULNhXP17nqeOc%2F5.png?alt=media)

Repeat the above steps to Onboard Partner44.

**B. Onboard Partner43 S3 receive profile in SFG using AMF (MFT Initiated Communication Profile (Inbound)).**

Double click on the Partner43

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FyyskyYfrDGm2QIDsbecP%2F6.png?alt=media" alt=""><figcaption></figcaption></figure>

Click on + icon in the top right corner

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FI3P8mYNmVY6uCJ193Xzt%2F7.png?alt=media" alt=""><figcaption></figcaption></figure>

Give details of the S3 MFT Initiated download Profile details and click save

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2F1P8JX7b3kuAL07GNAGA5%2F8.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FGrmB80eh5NbOZZHXwWcI%2F9.png?alt=media" alt=""><figcaption></figcaption></figure>

Give details and click save

1. **S3 bucket**: S3 Bucket name
2. **S3 Region:** Region where S3 belongs
3. **S3 Access Key ID**: Access key ID of the S3 bucket
4. **S3 Secret Key**: Secret key of S3 bucket
5. **Message to Process**: Option to process the original or current message
6. **Proxy Required**: Option to open connections via proxy server
7. **Proxy URL:** Proxy server URL (If proxy was enabled)
8. **Proxy User Name**: Proxy user name (If proxy was enabled)
9. **Proxy Password**: Proxy password (If proxy was enabled)
10. **Download Path**: Path to get files
11. **File Pattern**: Pattern to filter the files
12. **Options**: Options to perform after file get

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FyL3l36M6Ak6qVSq5Vk4x%2F10.png?alt=media" alt=""><figcaption></figcaption></figure>

Once the onboarding was done, we can see the status.

**C. Create Communication Rule with Sender, Receiver, Message Type and Comm Profile Name. Select Delivery Type as Schedule.**

Go to Comm Rules under Onboarding

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2F52R2wD1XOBiqMvVuWwib%2F11.png?alt=media)

Click on + icon in the top right corner

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FKn0ubBumXYdYoLXIlGG1%2F12.png?alt=media" alt=""><figcaption></figcaption></figure>

Select Delivery Type as Schedule

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FHQ1OEqkvBxxu6aOtTsk9%2F13.png?alt=media" alt=""><figcaption></figcaption></figure>

**D. Onboard Partner44 connect direct node in SFG using AMF (Customer Initiated Communication Profile (Inbound)).**&#x20;

Double click on the Partner44

!\[Graphical user interface, table

Description automatically generated]\(/files/QmkKFNo9iZJiOUsFwHF2)

Click on + icon in the top right corner

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FhInw56LxTO8NZiHcTFj8%2F15.png?alt=media)

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FdEpSC23lzqWgulcDNkhz%2F16.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FO43kxUHvpuEOknwNp6Ek%2F17.png?alt=media" alt=""><figcaption></figcaption></figure>

1. **Operating System:** Operating system of the Partner44
2. **SPOE:** Option to enable/disable secure point of entry
3. **Node Name:** Node name of Partner44CD Node
4. **Host Name/IP:** Host/IP of the Partner44CD Node
5. **Port:** Port of the Partner44CD Node
6. **Alternate IPs:** we can give there is any alternate IPs for this CD node
7. **Secure+:** Option to enable/disable Secure+ for SSL (If secure+ was enabled)
8. **Cert File:** Public cert of the Partner44 CD Node (in txt format with no Partner44 headers)
9. **Common Name:** Common Name of the CD (If secure+ was enabled)
10. **TLS Version:** TLS version to be used in the Communication
11. **Ciphers:** Ciphers to be used in the Communication (If secure+ was enabled)

**E. Create Message Types or use the existing one in AMF**

Go to Message Types under Onboarding

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FBjc7qSPmO2uV02eVgIxK%2F18.png?alt=media" alt=""><figcaption></figcaption></figure>

Click on + icon in the right corner to add a new Message Type

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2F0JSjoA5u5d0esEC400wP%2F19.png?alt=media" alt=""><figcaption></figcaption></figure>

**Note**: In this scenario we will use the existing Message Types (GENERIC)

**F. Create Message Mapping with Sender, Receiver and Message Type with a file pattern:**

Go to Message mapping under Onboarding

!\[Graphical user interface, application, Teams

Description automatically generated]\(/files/4XDRAnqqzgU2kzDBtfSl)

Click on +icon at the top right corner

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FTG0PwwhCRpCRgWhC4A94%2F3.png?alt=media)

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2Fmtn73PjM08VUb76LJL8u%2Fimage.png?alt=media&amp;token=af35d5cc-ad7a-4fc0-9e0c-69b514dd00e5" alt=""><figcaption></figcaption></figure>

**H. Create Gunzip Action or use the predefined one(Gunzip)**

Go to Actions under Onboarding->Workflow

!\[Graphical user interface

Description automatically generated]\(/files/RsngSBArYKECWXTGCmwC)

Click on + icon to create new action

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FzJIoMAMZYQb4O6gY1QwV%2F7.png?alt=media)

Give Action Name, Action Type Guzip and save

!\[Graphical user interface, application

Description automatically generated]\(/files/TReDAdT4fJUin7aGF63s)

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2F8ToF6po40X9iVabl7cnb%2F9.png?alt=media)

**I. Create Deliver Action or use the predefined one(Gunzip)**

Go to Actions under Onboarding->Workflow

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FDV1D4PyGZAU3dX9MX7Zc%2F10.png?alt=media" alt=""><figcaption></figcaption></figure>

Click on + icon to create New Action

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FsPsKkr503YRGVAiZ5L4E%2F11.png?alt=media)

Give Action Name, Action Type Deliver and save

!\[A screenshot of a computer

Description automatically generated with medium confidence]\(/files/WZq3rWb8YH52yMWJ25W6)

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FZwCjcaatLZR7QDqXNOgh%2F13.png?alt=media)

**J. Create Workflow Definition and add Actions (Created in step F and step G) as step1 and step2.**

Go to Definitions under Onboarding->Workflow

![
](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FNxzR7MY6jvYu7IGgm1hm%2F14.png?alt=media)

Click on + icon at the top right corner

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FOYhwtLwMwdUG1t4HCdo3%2Fimage.png?alt=media&amp;token=cc11483c-5d37-4f19-b27f-2ed8c98c7c51" alt=""><figcaption></figcaption></figure>

Give Workflow Name, Description and click save

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FemGaiU0iX7ICn02sfgOL%2F16.png?alt=media)

**K. Create Workflow Rule with Sender, Receiver, Message Type and Workflow Definition Name (Created in step J).**&#x20;

Go to Rules under Onboarding -> Workflow

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FSkM7656Thrh3zomnoz1k%2F0.png?alt=media)

Click on + icon at the top right

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FIH5htvk4h6gWQvGDIjk6%2F1.png?alt=media)

Give Sender, Receiver, Message Type and Workflow (Created in **step J**) and click on save

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FIZZWg6h16KKuxgCLtLYC%2F2.png?alt=media)

**L. Onboard Partner44 Connect Direct Node Profile in SFG using AMF (MFT Initiated Communication Profile (Outbound))**

Double click on the Partner44

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FVQeM9wRCyYYRGpD7qUzs%2F3.png?alt=media" alt=""><figcaption></figcaption></figure>

Click on + icon in the top right corner

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FckrX2fPzkfJT6QqQhVRK%2F4.png?alt=media" alt=""><figcaption></figcaption></figure>

Give details of the Node and click save

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FW0fkbkFf4SSakeYCBiBY%2F5.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FnTqpSvxrjIHnI5F6JT4u%2F6.png?alt=media" alt=""><figcaption></figcaption></figure>

Give the details and clicks save

1. **SPOE:** Option to know if user will use SPOE or not (If SPOE was not used then we need to give Remote user ID and Remote Password)
2. **Submitter User ID:** Option to pass submitter user ID
3. **Remote User ID:** Remote User ID in the user node
4. **Use Source File Name**: Option to use source filename.
5. **Remote File Name:** Remote file name if you disabled the Use Source File Name in the 3-iv.
6. **Remote Path:** Path for the file to be placed.
7. **Disposition:** Dropdown to select disposition of the file
8. **Binary mode:** Option to enable or disable binary mode for file transfer
9. **Copy Statement Sys opts**: Option to execute copy step Sys opts. If we enable that we need to give the Sys opts to run
10. **Run Task:** Option to execute run task Sys opts. If we enable that we need to give the Sys opts to run
11. **Run Job:** Option to execute run job Sys opts. If we enable that we need to give the Sys opts to run
12. **Send Email Notifications**: Option to send email notifications for successful delivery
13. **Receivers Mail Ids:** Recipients mail addresses if we enable Send Email Notifications.
14. **Clean-up on Delivery:** Option to clean the file in file system after the file was delivered (Once the file is cleaned, we cannot redeliver the file again)

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FluN7s6dTB0kC7s7l0USw%2F7.png?alt=media)

Once the onboarding was done, we can see the status.

**M. Create Communication Rule with Sender, Receiver, Message Type and Comm Profile Name:**

Go to Rules under onboarding->Communication

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2Fmfq72KHN843YVNeAHQeK%2F8.png?alt=media)

Click on + icon at top right corner

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FQc1yvDfci5m6Z06NJHJN%2F9.png?alt=media)

Select Sender, Receiver, Message Type and Comm. Profile name and click save

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FvnHjE7I7Sy2AfNxOYYhO%2F10.png?alt=media)

**N. Verify the Message Activity in AMF once the Partner43 uploads the file to SFG via S3 Protocol. If everything was configured correctly, the file will be delivered to Partner44 via CD Protocol.**

Go to Message Activity under Track N Trace

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FVoivWVNjv2FcLMRYmd6Q%2F11.png?alt=media)

To see more details of the Delivery double click on the record

![](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2FDQj2Uy0xrrs7Hs0IUsoZ%2F12.png?alt=media)

Here we can see the Process Name, Process Number, Message ID, DDSN etc. for the file delivered to the Partner44

![
](https://529847091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3lEcft4Hj193xOMx83Gm%2Fuploads%2F5hWTGi40MNlkfiVcOfvv%2F13.png?alt=media)
