Calling Using a Command Line

Calling SDI Using a Command Line

SDI can be called using command line parameters to select and perform actions. There is a defined set of arguments that can be used to call the utility.

All command line parameters to SDI now require that they be sent in pairs that are absolutely clear as to their meaning with the exception of only one. The allowable commands are now "DFL=" or "D=", "VIEW=" or "V=", "REPORT=" or "R=", "BATCH=" or "B=", "PRINT=" or "P=", "BATCHREBUILD". So a typical command line might be:
"Sdi.exe DFL=MyDFL.dfl VIEW=MyView REPORT=MyRpt"
or
"Sdi.exe BATCHREBUILD"
The pairs are NOT required to be in any order.

"DFL=" or "D=" - This parameter is the name of the application .DFL file to use when looking for data. This parameter can include the path when the .DFL is not located in the current directory.

"VIEW=" or "V=" - This parameter is the name of the view that is to be used initially during this session. Passing this value as a parameter bypasses the View Selection screen once SDI has started.

"REPORT=" or "R=" - This parameter is the name of the report that is to be used initally during this session. Passing this value as a parameter bypasses the Report Selection screen once SDI has started.

"BATCH=" - This parameter tells SDI if you are attempting to use SDI to generate a report in a batch mode (without the user interface). Passing a value of BATCH=ON turns on this mode. In this mode the report can be browsed or printed without any user intervention. See the information on the PRINT= command line parameter for more information.

"PRINT=" - This parameter is used in conjunction with the BATCH= parameter and tells SDI if you want to view or print the report that was passed on the command line. If the value passed is PRINT=ON then the report name passed in will be sent to the print output rather than brought up in browse mode.

"BATCHREBUILD" - This parameter tells SDI that you are attempting to make sure that any SDI relations are not in a version conflict state. Since SDI is a SageST application that stores its information in relation files it is subject to new versions of its .DFL containing new relation definitions. When SDI is opened it always checks for this condition and automatically tries to do a version rebuild of the data. When the BATCHREBUILD parameter is passed to SDI once the version rebuilding of the SDI data files is completed the program will exit. Without this parameter the program continues on normally and will bring up the user interface screens.

Example Command Line Call - A typical command line call might be as follows:

"Sdi.exe DFL=MyDFL.dfl VIEW=MyView REPORT=MyRpt PRINT=ON BATCH=ON"
or
"Sdi.exe BATCHREBUILD"

The pairs are NOT required to be in any order.

Go Back To Sage-ST TABLE OF CONTENTS