Jobs

Use the Jobs page to view and manage Reflection Gateway Jobs.

To view the Jobs page and manage Jobs, you must be a member of a group with the Manage jobs role enabled.
From the Jobs tab, use Add to open the New Job page.
You can copy existing Jobs to create new Jobs with similar functionality to existing Jobs. All copied Jobs are marked as Disabled initially. This ensures that you don't have identical Jobs running simultaneously.

More Information

New/Edit Job

Getting there

Log into Gateway Administrator as a member of a group that has the Manage jobs role enabled.
Click the Jobs tab.
Click New, or select an existing Job and click Edit.

Use this page to specify the directory to be scanned and to configure Job actions to take place when new or updated files are found in the scanned directory.

To view the Jobs page, you must be a member of a group with the Manage jobs role enabled


Name	A descriptive name for this Job.
State	Enabled – Jobs will run on the specified Scan Interval. Disabled – Jobs will not run automatically, but can be run using Run Now.
Run Now	When you click this button, Reflection Gateway scans the files in the specified Directory and initiates listed Job actions if new or updated files are found that meet the filter criteria. You can use Run Now when the state is set to either Enabled or Disabled. Clicking Run Now will not initiate Job actions if no files have changed since the last time you tested. To test updated Job actions, be sure to make modifications to files in the scanned directory. The Running Job dialog box indicates that the Job has been initiated. It remains open until you close it. You can close it at any time; closing this dialog box has no effect on the running job.

Source Files


Server	Specify the SFTP server whose directory you want to scan. This can be any Windows or UNIX SFTP server that has been added to Gateway Administrator by the Reflection Gateway system administrator. (See Add File Servers to Gateway Administrator).
Directory	The directory to be scanned. Reflection Gateway monitors this directory for new or updated files at the specified scan interval. Select Recursive to include all subdirectories in the scan.
Scan Interval	Set the frequency of scans, which days of the week scans take place, and when during the day scans take place.
Filters	Set which files are to be scanned based on file name and type, size, modification time, and/or the total number of files in the directory.
Execute failure action at the end of each scan interval if files do not meet filter conditions	Use this option if you want to receive notification when no new or updated files that meet the filter conditions are found in the scan directory.

Actions

Specify one or more Job actions. These take place in the order given. You can use the arrows to the right of the list to edit this order. Job actions can be either of the following:

Transfer files
Execute a command

Note

If your administrator has configured required preset actions, you will also see a Preset Actions list on this page. Preset actions run at the beginning of every job. You can view the configuration of these actions, but they are not editable.

More Information

Create a Job
Notes for Testing Job Actions

Transfer File (Job Action)

Getting there

Log into Gateway Administrator as a member of a group that has the Manage jobs role enabled.
Click the Jobs tab.
Click New, or select an existing Job and click Edit.
Under Action, in the Add action... list, select Transfer file.

You can copy or move files between any available SFTP servers.


Preserve file attributes	When it is not selected, the destination file’s timestamp shows the date and time of the transfer. When it is selected, the transferred file’s timestamp is the same as the file on the source server.
From	Specify the source server and files to transfer from this server. Enter an expression to describe the files to transfer. For most transfers, use $SCANNED_PATH$/$RELATIVE_FILE_NAME$ (the default) for the initial transfer. This will transfer all updated files on the scanned server that meet your filter criteria. If the scan is recursive, this option will also include all subdirectories in that directory. For subsequent transfers, replace $SCANNED_PATH$ with the correct actual path for the files on the server you are transferring from.
To	Specify the destination server and filename and path to copy files to on this server. You can combine tokens with text and/or other tokens. The default value, $RELATIVE_FILE_NAME$ transfers files to the SFTP login directory for the user whose UserID is configured for authentication to this SFTP server. For additional examples, see Entering Expressions for Destination Files.
Add	Use this option to transfer the same file set to additional servers.

More Information

Execute Command (Job Action)

Getting there

Log into Gateway Administrator as a member of a group that has the Manage jobs role enabled.
Click the Jobs tab.
Click New, or select an existing Job and click Edit.
Under Action, in the Add action... list, select Execute command.

Use a command Job action to run an executable program or operating system command on a specified server.

You can use tokens to pass arguments to the executable program. The tokens available depend on whether Options is set to Run once or Run for each file. For details, see Tokens for Job Actions that Execute Commands.


Run once	Run the specified command a single time.
Run for each file	Run the specified command for each file that has been added or updated since the last scan.
Command	The command to run on the specified server. You can use tokens to pass arguments to the executable program. The command runs as a remote SSH command executed using the user account specified for UserID on the SFTP server setup page. The executable file and output locations must be available to this user. The working directory is the user’s home directory. On Windows servers, precede DOS commands with `cmd /c`, for example: `cmd /c echo $FILENAME$ >> c:\output\filelist.txt` If you include full path information for output, as shown in the example above, the directories in the specified path must exist, and the user who is specified for UserID in the file server definition must have access to these directories. If you do not include full path information for command output, it is created in the terminal session login directory for the user who is specified for UserID in the file server definition. On UNIX systems this is typically the home directory (home/userID). On the Reflection for Secure IT Server for Windows, this is the user’s Windows Profile directory by default (c:\users\userID). This default can be modified from the Reflection for Secure IT Server console using the Permissions pane. See Sample Commands for Job Actions.

More Information