Command Line and Configuration File Syntax

The Batch Client can be used with command-line parameters or with a configuration file.

Command-line Syntax and Example

The Batch Client can be used with the command-line parameters in Command Line Parameters and Configuration File Keys. Bracketed values ( [ ] ) are optional extensions provided for clarity. Both shorter and longer versions of the value are supported. Commands and parameters are not case-sensitive.

Caution:

For all parameters, version names containing a space must be in quotes, for example, "April – Production".

Below is an example of the command-line syntax.

C:\Oracle\Middleware\EPMSystem11R1\products\DataRelationshipManagement\client\batch-client\drm-batch-client.exe /url=net.tcp://localhost:5210/Oracle/Drm/Engine /u=mylogin /pw=mypassword /log="C:\Oracle\Data Relationship Management\rdsc.log" /op=Export
/xtype=Export /xname="WeeklyExport" /cver="COA Current" /pver="COA Previous"
/outfile="C:\Oracle\Data Relationship Management\export_data.txt"

Configuration File Syntax and Example

Configuration files are formatted like INI files, with sections, keys, and values. There is a General section and an additional section for the specific operation. Section names are enclosed in brackets ( [ ] ) and can be any string value but must match the value specified by the operation key. Lines within each section are formatted in key=value pairs. The Batch Client can be used with the configuration file keys in Command Line Parameters and Configuration File Keys

Below is an example Batch Client configuration file.

[General]
Operation=Export
UserName=mylogin
Password=mypassword
URL=net.tcp://localhost:5210/Oracle/Drm/Engine
LogFileName="C:\Oracle\Data Relationship Management\rdsc.log"
[Export]
ExportType=Export
ExportName=WeeklyExport
OutFile= "C:\Oracle\Data Relationship Management\export_data.txt"
CurrentVersionAbbrev="COA Current"
PrevVersionAbbrev="COA Previous"

A configuration file can include multiple operations. Each operation is contained in a separate section with a unique label. A special section labeled [Operations] is used to specify the number of operation sections in the file and the label for each. The operations are performed in the order listed.

Below is an example of a Batch Client configuration file with multiple operations. Note that when using multiple operations, the operation key, for example Operation=Import, must be included in each section.

Note:

Sections, keys, and values are not case sensitive.

[General]
Operation=Multiple
UserName=mylogin
Password=mypassword
URL=net.tcp://localhost:5210/Oracle/Drm/Engine
LogFileName="C:\Oracle\Data Relationship Management\rdsc.log"
[Operations]
OperationCount=3
Operation1=Weekly_Import
Operation2=Update_CostCenters
Operation3=Merge_Data
[Weekly_Import]
Operation=Import
InFile="COA_data.txt"
ImportAbbrev="RDSC Import"
ImportLogFileName="C:\Oracle\Data Relationship Management\Batch Client\import_log.txt"
VersionAbbrev="COA Current"
VersionDescription="COA for this month"
[Update_CostCenters]
Operation=Action Script
InFile=CostCenter_changes.txt
StripQuotedStrings=True
Delimiter=comma
[Merge_Data]
Operation=Blend
Blendname="COA Blender"
SourceVersionAbbrev="COA Current"
TargetVersionAbbrev="COA Previous"
NewVersionAbbrev="COA Blended"
NewVersionDescription="Current and Previous COA"