Server Command Line Utility

Name

Centerprisecl.exe

Purpose

Gives ability to submit, terminate, and monitor jobs from a command line

Requirements

Access to Astera Integration Server

Astera.Core.dll

Usage

Syntax

Copy

Centerprisecl [/H <ServerUri>] [/R <filePath> [[/A] [/V <check|trace>] [/P <paramn1=value1>] [/U <interval>]]] | [/S <JobId>] | [/T <JobId>] | [/I <JobId>]

Switches

Example

Centerprisecl /r “c:\test data\dataflow1.df” /h myservername:9258

/p “DelimitedSource1.SourceFile=c:\test data\testforparam.csv;DelimitedDest1.DestinationFile=c:\temp\outwithparam.csv” /v trace /u 3000

In the above example, we are submitting a dataflow (c:\test data\dataflow1) to be run on the server myservername that is listening on port 9258. We are also changing the filepath found inside of an action called DelimtiedSource1 as well as DelimitedDestination1. These are two different swaps separated by a ‘;’ character. Finally, we are setting the verbosity of the monitoring by using the /v switch with the “trace” option and adding to the trace every 3 seconds.

Running a Job

Running a job requires use of the /R switch. When this is done, the path of the file is read, parsed, and the contents sent to the server. Keep in mind that the server may be on a completely separate machine and file paths need to be accessible from that server. If the /A switch is used, only the ID of the job that was created is returned and displayed on screen. If the /A is not used, centeprisecl will not return until the job has finished. If the check verbosity flag is used, a status will periodically display along with a timestamp. This timestamp is not when the job started. It is the time of the status request. If the “trace” verbosity switch is used, centerprisecl will periodically poll the server and get the latest trace infoformation.

Monitoring a Job

Monitoring a job is usually done when the /A switch is used to submit it. So, for example, you can submit a job, get the job ID back and later use the /I or /S flags to check on it.

General Flow Parameters

Centerprisecl has the ability to change any parameter available in a flow using the /P switch. The /P is given once followed by a semicolon separated list of name value pairs. The format is:

ObjectName.parameter=value

Where ObjectName is the name of the action you wish to modify. For example, if you have a dataflow that has an delimited file reader named ExtractCustomerABCFile, ObjectName would be “ExtracCustomerABCFile”. The parameter name is a special name that each action exposes. If I wish to change the filepath, that name would be “SourceFile”. The list of parameters changes with each action. To see the list of parameters, you can click on the “replace parameters” button while your dataflow is open in the designer. This will show a list of objects in your flow. When you click on that object, the screen will display a list of parameters on the right. These are the parameters you can set from the centerprisecl.

Deploying Centerprisecl

The only thing needed to run centerprisecl.exe is the executable itself and the dependent astera.core.dll assembly. All other assemblies found in the server’s bin directory (read program files) are irrelevant. This means that centerprisecl.exe is a lightweight program that can be anywhere .NET is installed.

Last updated

© Copyright 2023, Astera Software