|
A Batch Runner item gives you access to USoft Batch Runner.
USoft Batch Runner allows you execute batch jobs that were defined using the USoft Batch extension of the USoft Definer. These jobs are either executed on line or deferred. All jobs that involve the manipulation of data are automatically checked against the database constraints and business rules as defined in the USoft Developer repository.
For more information about USoft Batch Runner and how to use it once it is installed on your system, refer to the USoft Batch Server Guide or the USoft Batch help Batch Runner Command Line Options.
A Batch Runner item has the following properties:
 Name
This is the name of the User Application item as it will be displayed in the main window of the USoft Binder file. You can use binder variables in this name.
|
Directory
If this field is completed, USoft Batch will open or create the following files in the specified directory:
•ERR, SUC and MES files in import tasks. •Data files in import and export tasks. A path entry in this field adds data_directory=<path> to the Batch Runner command line. It overrides any data_directory= <path> parameters you may have specified in job properties.
If this field is left empty, the files are opened or created in the current working directory.
|
App From
This property must be set to either Repository or Flat Files.
Repository
If App From = Repository, the User Application is run directly from the repository tables that you are manipulating in USoft Definer. If you change data in repository tables (in USoft Definer), you will not see the result in the User Application unless you restart it from USoft Binder. To make changes to constraints accessible to a User Application started with From = Repository, you can alternatively choose Tools, Refresh Constraints from the User Application main menu.
Flat Files
If App From = Flat Files, the User Application is run from flat files created in USoft Definer. These files must be located in the \APP subdirectory of the USoft installation directory:
Flat file name
|
Created in
|
USoft-install-dir\APP\application.CON
|
USoft Definer
|
USoft-install-dir\APP\application.JOB
|
USoft Definer
|
USoft-install-dir is the USoft installation directory. Application is the value of the App Name property (next section).
|
App Name
This is where you specify the name of the USoft application that you want to design windows or dialogs for.
If App From is set to Flat Files, the application name determines the names of the files from which the application is run.
In many cases, the application name is the same for all the resources developed in the database account, but it is possible to distinguish different applications associated with different GUI look-and-feel or with different authorization rules (or both).
|
Special
This is where you can list any additional startup options for batch runs you wish to be associated with the Batch Runner (RUNBATCH.EXE) executable for this item.
|
Logfile
This is where you can specify the name of a file to be used as a log file by Runbatch when it executes the batch job.
You can specify a full path name, a file name or a folder name. If the specified file already exists, the log information will be appended to the file.
|
Logfile Overwrite
This is where you can specify that an existing log file is to be overwritten by a new log file, instead of being appended with new logging information.
|
Jobs
This is where you can Add, Edit or Delete a job to be run by the USoft Batch Runner application and specify the input parameter values (if any) that it must be run with.
To add a job and specify input parameter values:
| The Edit Job Name and Parameters dialog is displayed. |
| 2. | In the Job Name field, type the name of the batch job. This is the name that you gave to the job in USoft Definer. |
| 3. | In the Job Parameters field, type name-value pairs for input parameters (if any), using the following syntax: |
parameter-name = value, ...
DESTINATION=PARIS CDG, INSURANCE=N
| Parameter-name must be the name of an external set element of the external set associated with the job as its Input Parameter Set. See USoft Definer help for details. Values are case-sensitive, parameter-names are not. |
| IMPORTANT: As the example shows, even if value is a string and contains whitespace, value is NOT quoted. String delimitation depends solely on the equal (=) and comma (,) symbols. Any whitespace preceding or following value is ignored. |
| 4. | Press OK until you reach the USoft Binder main window, then press Save to save work. |
|
|
