To add the Samba protocol adapter:

1. Open the Windows Control Panel and double-click Add or Remove Programs.

   The Add or Remove Programs dialog box opens.

2. Select iWay Service Manager and click the Change/Remove button.

   The Already Installed dialog box opens.

3. Select Add/Reinstall components and click Next.

   The iWay Service Manager Select Features dialog box opens.

4. Expand the Protocol Adapters group, select the check box for SMB/CIFS (SAMBA), and click Next.
5. Click Finish.
6. Stop and restart iWay Service Manager.

   Note: You must perform a hard restart. Using the Restart function in the iWay Service Manager Administration Console is not sufficient.

To add a Samba listener:

1. In the left console pane of the registry menu, select Listeners, as shown in the following image.

   

   The listener pane opens, as shown in the following image.

   

   The table provided lists any existing listeners and short descriptions of each.

2. Click Add.
3. Select Samba from the list, and then click Next.

   

4. Provide the required configuration parameters for the new listener, which are described in Samba Listener Configuration Parameters.

   

5. Click Next.

   The Name and Description pane opens.

6. Enter a name and an optional description for the listener and click Finish.

   The listener is added to the list in the listeners pane, as shown in the following image.

   

   After a listener is added to iWay Service Manger, you can assign a listener to an inlet that is used to construct a channel.

To add a Samba emitter:

1. In the left console pane of the Registry menu, select Emitters, as shown in the following image.

   

2. Click Add.

   

   The Emitters type pane opens, as shown in the following image.

   

3. Select Samba from the list of protocols and click Next.

   The configuration parameters pane for the Samba emitter opens.

   

4. Provide the required parameters for the Samba emitter, which are described in Samba Emitter Configuration Parameters.
5. Click Next.

   The Name and Description pane opens.

6. Provide a name and an optional description for the Samba emitter and click Finish.

   The Samba emitter is added to the list in the emitter pane, as shown in the following image.

   

   After an emitter is added to iWay Service Manger, you can assign an emitter to an outlet that is used to construct a channel.

1. From the Windows Start menu select Programs, iWay 6.1 Service Manager, tools, and then iWay Designer.
2. Connect to the repository from which you want to work, for example, iWay.
3. Right-click the repository node and select New Project from the drop-down list.

   The Designer Project Information dialog box opens.

4. In the Name field, type SambaAgent as the project name.
5. Click Next.

   The Designer Project Bindings dialog box opens.

6. To create the project in the iWay Registry, select iWay Registry and click Finish.

   The choice of project association depends on where you intend to publish (deploy) your process flow. If you are developing a process flow for use as part of a channel, you must publish it to the Registry for subsequent deployment.

   The SambaAgent project node appears under the repository in which it was created (in this example, it appears under iWay).

7. To save the project to the repository, right-click the project node and select Save from the drop-down list.
8. Expand the SambaAgent project node to expose the project elements (Processes, Services, Transforms, and so on).
9. Right-click the Processes folder and select New Process from the drop-down list.

   The iWay Process Configuration dialog box opens.

10. In the Name field, type SambaPflow as the process flow name.
11. Click Finish.

    The new SambaPflow node appears under the Processes folder, and the workspace displays a Start object.

You are ready to build the SambaPflow by adding objects to it and specifying their relationships.

To add a Samba agent Service object:

1. Drag and drop the Service object icon from the toolbar to the workspace.

   The Service Name and Description dialog box opens.

2. In the Name field, type a new name for this Service object, and leave the default value (Service object) in the Description field.
3. Click Next.

   The Service Type dialog box opens.

4. Select Class Name and enter one of the following class names (depending on which Samba agent you want to use).
   • com.ibi.agents.XDSambaReadAgent

     To view a list of parameters that are required to configure the Samba Read agent, see Samba Read Agent Configuration Parameters.

   • com.ibi.agents.XDSambaEmitAgent

     To view a list of parameters that are required to configure the Samba Emit agent, see Samba Emit Agent Configuration Parameters.

   • com.ibi.agents.XDSambaOpsAgent

     To view a list of parameters that are required to configure the Samba Ops agent, see Samba Ops Agent Configuration Parameters.

5. Click Next.

   The Define Service dialog box opens.

6. Select the Define Service Globally check box.
7. Click Finish.

   The new Service object appears in the workspace.

   Now you need to connect the Start object to the Service object.

8. Select the Start object, right-click the Service object, and select Build Relation from the context menu.

   The Line Configuration dialog box opens.

9. From the Event drop-down list, select OnCompletion and click OK.

   This option indicates that there are no conditions that affect the path, and that the path between the two objects will always be followed.

   A line appears between the objects to indicate that a relationship has been established.

All processing paths must terminate with an End object.

1. Drag and drop the End object icon from the toolbar to the workspace.

   The End Name and Description dialog box opens.

2. In the Name field, type a new name for this End object, and leave the default value (End object) in the Description field.
3. Click Next.

   The End Name Schema dialog box opens.

4. Since no schemas are used in this processing path (that is, the process flow will not be exposed as a web service), from the Schema drop-down list, select None.
5. Click Next.

   The Properties dialog box opens.

6. Click Finish to accept the default values and close the dialog box.

   The new End object appears in the workspace.

7. Select the Service object, right-click the End object, and select Build Relation from the context menu.

   The Line Configuration dialog box opens.

8. From the Event drop-down list, select OnSuccess and click OK.

   This option indicates that the path will be followed if there is a normal completion.

   You can reposition the objects as desired.

9. To save the process flow, right-click the SambaPflow node and select Save from the drop-down list.

   Now you need to validate the process flow and publish it to the Registry of the iWay Service Manager Administration Console for use in the route in the channel for inbound processing.

   Validating a process flow ensures that its structure is correct. Publishing a process flow makes it available in the Registry for use in channel configuration.

   For instructions on validating and publishing the process flow, see the iWay Designer User's Guide.

10. Close iWay Designer.

    Note: This is the simplest possible process flow to configure. In a real world scenario, most users will have more complex business logic. For more information on how to construct process flows and use the supported object types, see the iWay Designer User's Guide.

    Your next step is to add a new route to the Registry of the iWay Service Manager Administration Console and associate the process flow with it.

This section describes how to create and test a process flow for the Samba Read agent using iWay Designer.

The Samba Read agent can be used in conjunction with a File listener to embed file contents (the file picked up by the listener) into the XML file that is read from the Samba drive by specifying a tag. In the case of a process flow, the test document can be used as the enclosing document.

The full file path must be provided for the InputFile property. The document that is read from the Samba drive as specified by the InputFile property is:

<Test>Hello World</Test>

The input file to the process flow (given at runtime) is:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<parent><test1>Test By Soumya</test1></parent>

The properties of the Samba Read agent can be specified, as shown in the following image.

After running the process flow, the test result is:

<parent>><Test>Hello World</Test><test1>Test By
Soumya</test1 </parent>

//SambaDrive/file

This section describes how to create and test a process flow for the Samba Emit agent using iWay Designer.

This section describes the behavior of the Samba Emit agent for a Status return type.

You can use the same process flow as explained in How to Test the Samba Emit Agent for an Emit Operation to a Samba Drive. In this example, the file that will be emitted is emit.xml.

1. Right-click the Samba Emit agent Service object and select Properties from the context menu.
2. From the Return drop-down list, select status.
3. Run the process flow.

The emit.xml file is generated under the Samba drive that is specified for the Destination field.

The following output is obtained at the end of the stream.

<?xml version="1.0" encoding="UTF-8" ?> 
- <emitstatus status="0">
<protocol>Samba</protocol> 
- <parms>
    <parm name="nopreemit">false</parm> 
    <parm name="b64">false</parm> 
    <parm name="uncpathin">\\SoumyaPC\softwares\testSmaba\file_out</parm>
    <parm name="pattern">emit.xml</parm> 
    <parm name="userid">sr12231</parm> 
    <parm name="return">status</parm> 
    <parm name="password">***</parm> 
</parms>
<timestamp>2009-01-23T17:54:37.755Z</timestamp> 
<status>0</status> 
<count>1</count>
<name>smb://sr12231:*******@SoumyaPC/softwares/testSmaba/file_out/
</name>
</emitstatus>

To check the Samba Emit agent for a status (return) code and branch accordingly:

1. Create a new process flow.
2. Add a control to check for the status code and to branch accordingly.

   In the following example, a Decision Test object is added to the result of the Samba Emit agent. If a success condition is returned, a database operation is performed. If an error condition is returned, an email is sent to the user to inform them of the error.

   

3. Check the status code by using an XPATH function in the Decision Test object.
4. Provide the following condition:

   XPATH (/emitstatus/@status) equals 0 (indicating success).

   A status code other than 0 indicates an error condition and is routed to the SendEmail object.

As a test, run the process flow and provide an incorrect password when connecting to the Samba drive. The SendEmail object will be reached because a failure edge is returned. The status code is 1.

//SambaDrive/file

This section describes how to create and test a process flow for the Samba Ops agent using iWay Designer.

The prepend operation refers to prepending the contents of the file specified by the From File property to the file specified by the To File property. The resulting file is stored in To File. The full file path must be specified for both the From File and To File fields. For example:

'\\SoumyaPC\softwares\testSamba\file_in\in.xml'.

Create a new Service object for the Samba Ops agent by setting the properties, as shown in the following image.

The content of From File is:

<test/>

The content of To File is:

<parent><test1>Hello World</test1></parent>

The To File content is modified as:

<test/>
<parent><test1>Hello World</test1></parent>

To set the Samba drive in Windows:

1. Create a new folder, for example, sambadrive.
2. Share the new folder and grant permission to Everyone, All, or Windows User.

   

3. Click Permissions. A dialog box is displayed in the following image. Make sure that you give full permissions to Everyone/User which is being used.

   

4. Select the Allow check box for the Full Control permission and click OK

   

5. Create all sub-folders that can be used for the listener/emitter.

   The Samba drive is set and ready to be used.