Managing Files with Sterling Connect:Direct File Agent 1.4.0.1 IBM Contents Managing Files with Sterling Connect:Direct File Agent.......................................... 1 Sterling Connect:Direct File Agent Overview.............................................................................................. 1 How to Run Sterling Connect:Direct File Agent.......................................................................................... 2 Sterling Connect:Direct File Agent Logging.................................................................................................3 Sterling Connect:Direct File Agent Configuration Planning........................................................................ 3 Sterling Connect:Direct File Agent Worksheet ...........................................................................................4 Considerations for a Large Number of Watch Directories.......................................................................... 6 Modifying MaxFileSize............................................................................................................................ 6 Modifying MaxBackupIndex...................................................................................................................6 Considerations for a Large Number of Files in a Watch Directory..............................................................7 Sterling Connect:Direct File Agent Configuration Scenarios...................................................................... 7 Scenario:Detecting a File Added to a Watched Directory on a z/OS System........................................7 Scenario:Detecting a VSAM Data File Added to a Watched Directory on a z/OS System.....................8 Scenario:Detecting a File by File Size on a Microsoft Windows System...............................................8 Scenario:Detecting a System Event by Title on a Microsoft Windows System.....................................9 Scenario:Passing the UNIX Pathname for a Detected File to a Process............................................ 10 Scenario:Configuring the Gate Keeper for Multiple Sterling Connect:Direct File Agent Instances...11 Tips for Using Sterling Connect:Direct File Agent.....................................................................................12 Configure the Default Settings............................................................................. 12 A Default Configuration..............................................................................................................................12 Creating the Default Configuration File............................................................................................... 13 Verifying the Default Configuration......................................................................................................17 Sterling Connect:Direct File Agent Variables............................................................................................ 18 Microsoft Windows or UNIX Process Arguments Example...................................................................... 18 z/OS Process Arguments Example...................................................................................................... 21 The Default Configuration with Rules........................................................................................................21 Match Criteria and Operators...............................................................................................................21 Rules Processing.................................................................................................................................. 23 Guidelines for Defining Rules...............................................................................................................23 Creating a Watched File Rule.................................................................................................................... 23 Validating a Watched File Rule.................................................................................................................. 25 Creating a System Event Rule................................................................................................................... 26 Reordering Rules....................................................................................................................................... 29 Configuration File Hierarchy......................................................................................................................29 Configuration Files.............................................................................................. 29 Creating a New Configuration File.............................................................................................................29 Editing a Configuration File........................................................................................................................34 Deleting a Configuration File..................................................................................................................... 34 Creating Multiple Configurations with the Copy Function........................................................................ 35 Creating Multiple Configurations...............................................................................................................39 Configuration Template Variable Rules............................................................................................... 40 Configuration Build File Variable Rules............................................................................................... 40 Locking a Configuration File for Distribution....................................................................................... 40 Copying a Rule........................................................................................................................................... 41 Deleting a Rule...........................................................................................................................................41 Enabling and Disabling a Rule................................................................................................................... 42 Editing a Rule........................................................................................................................................42 Variables in Rules................................................................................................................................. 42 ii Saving a Configuration in a Text File....................................................................................................45 Operating Sterling Connect:Direct File Agent........................................................47 Running Sterling Connect:Direct File Agent as a Microsoft Windows Service......................................... 47 Starting Sterling Connect:Direct File Agent Automatically on a UNIX Computer....................................47 Starting Sterling Connect:Direct File Agent from a Microsoft Windows Shortcut................................... 47 Running Sterling Connect:Direct File Agent from the UNIX Command Line with a Specific Configuration File............................................................................................................................ 48 Microsoft Windows Command............................................................................................................. 48 Using UNIX Commands to Start...........................................................................................................48 Sterling Connect:Direct File Agent in a z/OS Environment.......................................................................49 Sterling Connect:Direct File Agent with SMS-Managed GDGs............................................................50 Sterling Connect:Direct File Agent for SMS-Deferred Roll In Configuration............................................50 Modifying the Script for the Sterling Connect:Direct File Agent Execution Job................................. 50 Shutting Down Sterling Connect:Direct File Agent on z/OS................................................................51 Ending a Sterling Connect:Direct File Agent Configuration Session........................................................ 51 Sterling Connect:Direct File Agent Log Files.............................................................................................52 Changing Console Logging Level to WARN.......................................................................................... 52 Changing Console Logging Level to DEBUG.........................................................................................53 Configuring to Run in Verbose Mode....................................................................................................53 Status and Monitoring..........................................................................................53 Sterling Connect:Direct File Agent Status Information............................................................................ 53 Sterling Connect:Direct File Agent Configuration Guidelines...................................................................54 Sterling Control Center Monitoring Guidelines......................................................................................... 54 SNMP Trap Information......................................................................................................................