As part of the installation, an icon is created that can be used to launch SYSPRO from the desktop. This icon is configured to run SYSPRO's executable program (SYSPRO.EXE) from a specific location.
You can optionally append a range of parameters to a command line statement. Some of these parameters relate to setting the login procedure to suit specific operator needs, while others help to automate the login procedure and launch specific programs or functions.
You can also launch SYSPRO from a third party application (e.g. as an attachment within an e-mail message).
Parameter | Description | ||||
---|---|---|---|---|---|
/oper= | Indicates the operator code to use. | ||||
/pass= | Indicates the operator password. | ||||
/comp= | Indicates the company that must be loaded. | ||||
/cpas= | Indicates the company password. | ||||
/serv= | Indicates the name for the initial connection.
|
||||
/host= | Indicates the computer name or IP address of the host
computer.
|
||||
/time= | Indicates the initial connection timeout in seconds. | ||||
/instance= | Indicates the SYSPRO installation to use.
You can find the required entry in the BaseDir of the applicable machine (i.e. the client, the server or the standalone machine). |
||||
/log | Creates a communication log file
(LOG.TXT) for debugging purposes.
The file is created in the Base folder of your SYSPRO installation and records the client/server communications dialog each time the operator tries to connect to the server. |
||||
/wrk= | Indicates the location of the
IMPWRK.INI file, which contains the path
to your SYSPRO working directory.
Example: /wrk=IMPWRK.OPERATORNAME.INI |
||||
/ini= | Indicates the path to the IMPACT.INI file. | ||||
/f or /F | Suppresses the warning message that is displayed when
you log in and the system detects you are already logged in.
If a minor database upgrade is in progress, a dialog box is displayed to reflect the upgrade progress. |
||||
/htm= | Indicates the location of an HTML page (i.e. URL) that
must be loaded for the operator in the SYSPRO
browser. Examples: \SYSPRO.EXE /oper=SALES /comp=A /htm=x:\HtmlMenu\SALES.HTM \SYSPRO.EXE /oper=SALES /comp=A /htm=www.Syspro.com |
||||
/t or /T | In a Terminal Server/Citrix environment, this can
improve the startup time by indicating that a smaller splash
screen image must be displayed when loading SYSPRO.
Example: \SYSPROClient.EXE /host=SysproServer /T |
||||
/exe= | Indicates that you want to override the assumed
executable (i.e. SYSPROClient.EXE in a
client/server environment or SYSPRO.EXE
in a mapped drive/standalone environment). For example: If you invoke SYSPROAuto as SYSPROAuto /exe=TEST, then SYSPROAuto invokes the executable TEST.EXE from the SYSPRO \Base directory. SYSPROAuto then changes to the base directory and invokes the SYSPRO executable, applying the same command line arguments that may have been associated with launching SYSPROAuto. |
||||
/lang= | Indicates the language code.
Example: /lang=EN |
||||
/WCF= |
Indicates that you want to use WCF to communicate with SYSPRO. The system automatically determines that this is a client-server environment and automatically sets the executable to SYSPROClient.exe. If your server instance is not 0, then you will need to specify a /BaseDir= for the server instance. If your client instance is not 0, then you will need to specify a /BaseDir= for the client instance. Example: \SYSPROAuto.EXE /WCF=localhost:1978 /INSTANCE=2 |
Parameter | Description | ||||
---|---|---|---|---|---|
/h | Indicates that you want to hide the main SYSPRO login
and menu screens. The named program is then automatically launched and will exit when the program has completed.
If this parameter is used to run SYSPRO from a locked computer, the process will stop at the logon screen and the called program will not run. |
||||
/s | Indicates that you want to run in silent mode, with no
user interface.
|
||||
/prog=X | Indicates the name of the SYSPRO program you want to
launch from the SYSPRO menu.
|
||||
/link= | Indicates the linkage to be passed to the called program. |
Programs | Parameters available |
---|---|
BOMP40 (Cost Implosion) |
|
IMP01B (Job Receipts) |
|
IMP041 (Document Print) |
|
IMP040 (Sales Order Entry) |
|
IMPNDX (Reindex Files) |
|
MRPP40 (Requirements Calculation) |
|
MRPPE1 (Requirements Planning Query) |
|
PORP10 (Purchase Order Entry) |
|
REPP80 (Report Writer) |
|
QOTP1A (Quotations) |
|
SORPIQ (Sales Invoice Query) |
|
WIPP05 (Job Entry) |
|
WIPP60 (WIP Labor Import) |
|
Programs displayed in the Automation Design listview. |
|
Parameter | Description | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/link=KEY | Indicated after the /prog=SORPIQ
parameter, the specific entry at the
/link= parameter enables you to query a
customer's invoice. Entry positions:
Example (where 1 indicates the customer number and 100301 indicates the invoice number): /prog=SORPIQ /Link=000000000000001100301 /h |
|||||||||||||||||||||||||||||||||
/link=KEY | Indicated after the /prog=MRPPE1
parameter, the specific string entry at the
/link= parameter enables you to query a
stock item in a specific warehouse. Entry positions:
Example (where B100 indicates the stock code and FG indicates the warehouse): /prog=MRPPE1 /Link=B100 FG /h |
|||||||||||||||||||||||||||||||||
/link=KEY | Indicated after the /prog=IMP041
parameter, the specific entry at the
/link= parameter enables you to print
an order document. The program assumes that a single document must be processed and uses the key information supplied to determine the type of document that must be processed.
To run without operator intervention, you need to ensure that a number of options are configured appropriately:
Example: /prog=IMP041 /link=KEY000001 /h |
|||||||||||||||||||||||||||||||||
/link=Run | Indicates a program to run automatically without
operator intervention. A list of valid programs are displayed in the Automation Design listview. Against each of these programs you pre-define the form values required, otherwise the default system form values for the program are used.
Example: /prog=APSP01/link=RUN |
|||||||||||||||||||||||||||||||||
/link=Group | Indicates a group of programs to run automatically
without operator intervention, where
Group denotes the name of the group
created using the Automation Design program. A list of valid programs are displayed in the Automation Design listview. Against each of the programs you pre-define the form values required, otherwise the default system form values for the programs are used.
Example (where Daily indicates the name of the group of programs): /prog=TASK /link=Daily |
|||||||||||||||||||||||||||||||||
/link=import-auto | Automatically runs an import function without
operator intervention. Ensure that your operator login parameter has an extension of .EDI and that the import file resides in the \Base folder of your SYSPRO installation.
Details of any error messages are written out to a log file (FILENAME.ERR). Example: /prog=IMP01B /link=import-auto /prog=WIPP60 /link=import-auto Using command line parameters to import information has been largely superseded by the use of Business Objects (i.e. you can generate XML and pass this to a business object to add items), which is more flexible and can be used by third party systems and different languages. |
|||||||||||||||||||||||||||||||||
/link=import-auto-file=XXXXXX | Automatically imports a specific file (where
XXXXXX indicates the name of the
file). With this link, the operator login parameter does not require an .EDI extension and the import file does not have to reside in the Base folder of your SYSPRO installation.
Example: /prog=IMP01B /link=import-auto-file=JOB.EDI |
|||||||||||||||||||||||||||||||||
/link=CUS:xxxxxx | Indicated after the /prog=IMP040
parameter, this begins the capture of a Sales
Order for the customer indicated by
xxxxxx. Indicated after the /prog=QOTP1a parameter, this begins the capture of a quotation for the customer indicated by xxxxxx.
|
|||||||||||||||||||||||||||||||||
/link=SUP:xxxxxx | Indicated after the /prog=PORP10
parameter, this begins the capture of a Purchase
Order for the supplier indicated by
xxxxxx.
|
|||||||||||||||||||||||||||||||||
/link=nnnnnnn | Indicated after the /prog=IMP040 or /prog=PORP10 parameter, this maintains Sales Order lines for the order number indicated by nnnnnnn. | |||||||||||||||||||||||||||||||||
/link=QIK:xxxxxx | Indicated after the /prog=IMP040 parameter, this begins the capture of a Quick Entry order for the customer indicated by xxxxxx. | |||||||||||||||||||||||||||||||||
/link=QOT:xxxxxx | Indicated after the /prog=QOTP1a
parameter, this begins the maintenance of an existing
Quotation indicated by
xxxxxx.
|
|||||||||||||||||||||||||||||||||
/link=xxxxxxxxxxY | Enables you to run a Report Writer report without operator
intervention. The first 10 characters (passed with spaces, if required) indicate the name of the report you want to run. The 11th character must be a Y (in uppercase) to run the report without operator interaction. Prerequisites for this linkage:
Example: /prog=REPP80 /link=REP-001 Y /h |
|||||||||||||||||||||||||||||||||
/link=CRM: | Captures a Quotation against a
prospect's number (first 12 characters) and name (following
30 characters). The prospect's number is saved at the Description field as: CRM A/C# 123456789012 and the prospect's name is saved into the Customer name field in the QOTP1A (Quotations) program. |
|||||||||||||||||||||||||||||||||
/link=Function:NEW | Indicated after the /prog=MRPP40
parameter, this runs the Requirements Calculation program and takes a new
snapshot.
To output a log file containing details of the phases processed, as well as any errors that may have occurred, a Log: entry needs to be added to the command line. A single space must exist between the Function: entry and the Log: entry, otherwise the Log: entry is ignored.
Example: /prog=MRPP40 /link=Function:NEW Log:C:\Mylog.txt /h |
|||||||||||||||||||||||||||||||||
/link=Function:DEL | Indicated after the /prog=MRPP40
parameter, this runs the Requirements Calculation program and deletes the
current snapshot.
To output a log file containing details of the phases processed, as well as any errors that may have occurred, a Log: entry needs to be added to the command line. A single space must exist between the Function: entry and the Log: entry, otherwise the Log: entry is ignored.
Example: /prog=MRPP40 /link=Function:DEL Log:C:\Mylog.txt /h |
|||||||||||||||||||||||||||||||||
/link=Function:REC | Indicated after the /prog=MRPP40
parameter, this runs the Requirements Calculation program, retains the
snapshot, recalculates, and then recreates the suggested
jobs.
To output a log file containing details of the phases processed, as well as any errors that may have occurred, a Log: entry needs to be added to the command line. A single space must exist between the Function: entry and the Log: entry, otherwise the Log: entry is ignored.
Example: /prog=MRPP40 /link=Function:REC Log:C:\Mylog.txt /h |
|||||||||||||||||||||||||||||||||
/link=Function:RECJ | Indicated after the /prog=MRPP40
parameter, this runs the Requirements Calculation program, retains the
snapshot, recalculates, and retains the current suggested
jobs.
To output a log file containing details of the phases processed, as well as any errors that may have occurred, a Log: entry needs to be added to the command line. A single space must exist between the Function: entry and the Log: entry, otherwise the Log: entry is ignored.
Example: /prog=MRPP40 /link=Function:RECJ Log:C:\Mylog.txt /h |
|||||||||||||||||||||||||||||||||
/link=JOB:nnnnnnnn | Indicated after the /prog=WIPP05
parameter, this runs the Job Entry program and enables you to
update the job number indicated by
nnnnnnnn. Example: /prog=WIPP05 /link=JOB:590 /h |
|||||||||||||||||||||||||||||||||
/link-xfilename.edi | Indicated after the /prog=IMPNDX
parameter, this uses the file selections created for the
Export Selections function, where
xfilename.edi is the name of the file
exported. The /h parameter enables you to reindex files in background mode. Example: /prog=IMPNDX /link=xfilename.edi /h Refer to Hints and tips in for additional information. |
|||||||||||||||||||||||||||||||||
/link={Base: Update: Route: Log:} | Indicated after the /prog=BOMP40
parameter, this uses the following link parameters:
Example: /prog=BOMP40 /link={Base:B,Update:W,Route:0,Log:.\BOMP40.LOG} /h |
See also: Notes and warnings.
Parameter | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
/link=KILL | Indicated after the /prog=IMPPID
parameter, this terminates all unknown processes on the
server.
Terminating these processes typically does no harm as the user is not actually using SYSPRO, but there is a process still running on the server. Example: /prog=IMPPID /link=KILL |
||||||||
/link=KILL-EXIT | Indicated after the /prog=IMPPID
parameter, this terminates all unknown processes and then
exits SYSPRO gracefully when
completed. Example: /prog=IMPPID /link=KILL-EXIT |
||||||||
/link=KILL-ALL | Indicated after the /prog=IMPPID
parameter, this terminates all SYSPRO processes on the server,
excluding any process initiated by the current operator
code.
Example: /prog=IMPPID /link=KILL-ALL |
||||||||
/link=KILL-COMP | Indicated after the /prog=IMPPID
parameter, this terminates all SYSPRO processes on the server
for users logged into the same company as the current user.
If you use this option when logged in as ADMIN, then SYSPRO processes for all operators in the selected company are terminated with the exception of processes for operator ADMIN.
Example: /prog=IMPPID /link=KILL-COMP |
||||||||
/link=KILL-ALL-EXIT | Indicated after the /prog=IMPPID
parameter, this terminates all SYSPRO processes on the server
(same as KILL-ALL) but then exits SYSPRO
gracefully when completed.
Example: /prog=IMPPID /link=KILL-ALL-EXIT |
||||||||
/link=KILL-ALL-COMP-EXIT | Indicated after the /prog=IMPPID
parameter, this terminates all SYSPRO processes on the server
for users logged into the same company as the current user and
then exits SYSPRO gracefully when completed.
This parameter works the same way as KILL-ALL-EXIT, but applies only to operators logged into the same company as the current operator. Example: /prog=IMPPID /link=KILL-ALL-COMP-EXIT |
||||||||
/link=REM-ORPHAN-EXIT | Indicated after the /prog=IMPPID
parameter, this removes client connections from the
AdmCurrentUsers table in the system-wide
database if those connections are not linked to a currently
valid process. This ensures that all invalid entries are
removed prior to running nightly balances or other automated
tasks This function doesn't target unknown processes, as this
is already handled by the KILL-EXIT
function. Example: /prog=IMPPID /link=REM-ORPHAN-EXIT |
Parameter | Description |
---|---|
GENP81 \path\to\file.xml | This runs the GL XML Report Viewer program and loads the relevant financial report. |
If you use spacey file names then you must surround the command line with quotes so that Windows can determine the end of the application executable.
"c:\program files\syspro7\base\SYSPROAuto.exe" /oper=xxxx /comp=x
The minimum parameters required for SYSPRO to run and a program to be called are:
Operator (/oper)
Operator password, if required (/pass)
Company (/comp)
Company password, if required (/cpas)
Program (/prog)
A maximum of 200 characters can be entered on the command line.
The number of characters to pass on the command line can (in some cases) be reduced by:
using the Automation Design program to create a form for the program you are calling on the command line
saving all the values that never change on the form
adding only the parameters that change to the command line
You can enter login parameters in lowercase or uppercase.
When entering parameter links, ensure that the correct/applicable case is used (e.g. program names must be entered in uppercase).
When you end processes that relate to client/server sessions, these may have to be ended by running a SYSPRO client connected through the same communications service (e.g. CCI or SYSPROCOMMS).
The following occurs when you terminate processes using either the End functions of the Windows Task Manager program, or one of the KILL command line parameters:
All run away process on the server are killed.
Active processes are killed according to the End option or Kill command line parameter used.
The Admin Users Currently Using SYSPRO(ADMUSR) file is updated.
The Update Admin System Audit file is updated.