<< Click to Display Table of Contents >> Command line mode |
![]() ![]() ![]() |
This mode is activated when the program receives parameters on the command line when it starts.
The syntax is as follows:
xipcc.exe "PathToYourScript.bif" [var=value] [/silent] [/ini=PathToINIFile] [/log=PathToLogFile] [/showclient]
•Script name
If the file is located outside of the program directory, you must specify the full path. If the path contains spaces then you must enclose it with quotes.
•Variables
If your script uses variables then you must define them in the command line. The number of variables is not limited.
•Silent mode
By default the script processor ends when the script has ended successfully and when exit instruction has been found in the code.
If the silent mode is activated then the window is always closed when the script has ended regardless of whether it was successful or not and whether the exit instruction was reached.
•Path to the INI File
This option allows to change the path to the INI file. If the file specified by this parameter is not found then the INI file is read from the directory where SmartIS PC Client is installed.
•Path to the LOG File
By this option you can set the log file name. All log messages created by the program are redirected to that file.
•showclient
By this option you instruct PC client to start in the standard mode when BIF file name is specified. That means that the full client is displayed.
It allows you to start the client and open/run the BIF automatically. Variables still can be used and when they exist then a new variable set called "BIF_CMD_LINE_VARS" is created.
When the client is shown then BIF can contain also OPEN_DOCUMENT statement, that is otherwise (in command line mode without /showclient option) not allowed.
Sample:
This command starts C:\Test\test.bif script in the silent mode and uses two variables:
sys=SYSH
logon=petr.lgn
The logon is always executed when the LOGON command is reached by the parser.
The logon parameter of the command line in this sample does not do a logon, but it only sets the logon variable, which is replaced in the script.
If the script doesn't use the logon variable then the value set in the command line has no effect.
In the command line you can set any variables you want and then you can use them in your script.
If you set the logon variable in the command line, then is is used only when the script looks like this:
Logs
The program writes all logs into the log directory specified in Basic General Options.
In case of errors you can read it and check what was wrong.
The program returns the return code to the operating system. Possible return codes are:
0 - when there was no error
8 - when any error was found