Skip to Content
Author's profile photo Austin Jacob

Monitoring a Local or Shared Folder for a File using PCo

This blog post explains about how to Monitor a Local or a Shared Folder for a file and process the contents of the File using SAP PCo and SAP MII. It uses an SAP PCo Agent called File Monitor Agent which is available in PCo 2.2 and above. It Works in both Notification and Query Mode

In PCo you define which folder is to be monitored. If the agent finds a file that meets the configuration criteria that you specified in the PCo, then it generates, for example, a notification message and sends it to the connected destination system. In this way you can transfer file contents to the destination system. You can also define specific actions to be done like Moving, Copying, Renaming the files.

Let us see step by step procedure using an example.

Creation of Source System

  • Go to SAP PCo Management Console
  • Click on Add New Source System.


  • Choose the Source System type as FileMonitorAgent and create one


  • After the Source System has been created, in the Settings Tab of the new Source System, Browse the folder you need to Monitor and enter the File Mask as needed, (in our case I am giving it as ‘*.csv’ to monitor csv files). default is “*.*”


  • And choose one of the File Handling Actions from the below Dropdown, (Default is DoNothing). In Case of Move, Copy or Rename, you must choose a Destination Folder using the Folder Browse button
    • You cannot choose a System Folder for Monitor and Destination,
    • You can obviously monitor a Network Folder which is shared from another system or server as well. In that case you can give the shared folder path in the Folder to monitor like (\\Servername\SharedFolderPath)
    • Check the Ignore unavailability of UNCFolders if you are using a network shared folder as, the network folder might be disconnected often which will stop the agent
  • In case if Authentication is needed to access the Folder if it is a Shared Folder, you can give the credentials in the Authentication Tab. Click to Test the Connection


  • Save the Changes

Creation of Destination System

  • Add the MII System as a New Destination System


  • Give SAP MII Server Details and Credentials and Save the Destination System


Creation of Agent Instance

  • Create an Agent Instance and choose the Source System as the “MonitorFolder”.



  • Once the Agent instance has been created, Go to Subscription Tab and add the tags to be monitored by following below steps
    • Click on Browse and a Tag Browser opens


    • Click on Browse again in the Browse Pop up so as to see the available Tags
    • Select them and Click “Add Selected Items” and Click OK


    • Now the Subscription items have been added


  • Click on the Query ports Tab and Choose SAP MII as the Port Type and type an unused port of SAP MII Server from where the File Monitor Agent can be queried


  • Save the Agent Instance

Creation of Notification

  • Right Click on the Agent instance and Click on “Add Notification” and create a New Notification



  • In the trigger tab, Keep the Trigger Type as Always and check the Enabled checkbox.


  • In the Output Tab, click the Generate Expressions to generate all the subscription items of the Agent.


  • Meanwhile in SAP MII, Destination System, Create a Simple Transaction with XML Saver which can save the XML input from PCo Notification


  • In the Destinations Tab, Add the Already configured SAP MII Destination System


  • In the Destination Tab, Browse the already created transaction in SAP MII and map the Input Parameter Name


  • Save the Changes.

Testing the Notification

  • Start the Agent


  • Paste a CSV File in the folder which PCo is monitoring. As we are Moving the files, in few seconds we can see that the file is disappearing


  • Now the Notification should have run automatically.
  • Now we can go and check the Workbench for a newly saved XML file which we received from PCo Notification


  • Now MII has received the File Content through PCo File Monitor Notification, Which an MII expert can parse and use it as necessary


Query Mode

  • Create a PCo Dataserver in SAP MII.
  • Choose the Connector type as PCo Connector and Click Next
  • Enter PCo wsdl and Click Next and give credentials.
  • All the PCo Agents will appear, Choose the appropriate Agent


  • Click Finish, Enable and Save the Data server.
  • Make sure that you have few files in the Folder which is being monitored by SAP PCo. Which means that it should not be in Move File Handling Action mode in the Source System


  • Go to the SAP MII Workbench and create a PCo Query and choose the new Data Server
  • Choose “Tag Retrieve Query” mode and go to Tag Retrieve Query tab. The available Files in the Monitored folder will appear and you can select the files as needed.


  • Execute the Query and check the result, as the different file contents will appear in different Rowsets.


We can use other file types as also such as .txt, .log etc using File Monitor Agent



Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Shikhil Vyas
      Shikhil Vyas

      Hey Austin,

      Great post and thanks for sharing your experience.

      Just a small query came to my mind when I was exploring File monitoring agent. Is there a way that we can read a file from a shared folder on Pco ( using Pco expression) and based on validation move the file to another archive / another folder.
      As only notification has trigger expression , the file is moved to another location and then message is sent to MII.

      Is there any alternative or work around where we should move the files from a shared folder location to a different archive folder location, only if the file and content is valid ?



      Author's profile photo Austin Jacob
      Austin Jacob
      Blog Post Author


      Shikhil, Thanks for your response. File Handling based on the File Content validation is not possible. But, as you said notification can be controlled based on file content in Notification Expression.



      Author's profile photo Former Member
      Former Member

      Is there any way to trigger a notification when the file is updated instead of when the file is created?

      Author's profile photo Michael Schmalfeldt
      Michael Schmalfeldt


      is there any way to use PCo to send back a (XML) file from SAP to a local folder on the PC? We managed to monitor a folder on the PC and process the content in SAP. But based of the result we would like to write back a result file to the same (or different) local folder.

      Regards, Michael


      Author's profile photo Arif Kanik
      Arif Kanik


      I am taking an error like Monitored folder \\PATH is temporarily not available when trying to monitor the folder on server. The folder is shared to everyone and read write authorization is given . How can I solve this?