Command Line Parameters

> Command Line Parameters

Command Line Parameters

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 append a range of parameters to the command line statement. Some of these parameters relate to setting the login procedure to suit specific operator needs. Others help to automate the login procedure and launch specific programs and functions.

You can also launch SYSPRO from a third party application (e.g. as an attachment within an e-mail message).

Login Parameters

Parameter	Description and sample usage
/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 Name/IP of the host computer.
/time=	Indicates the initial timeout in seconds.
/instance=	Indicates the SYSPRO installation to use. This applies when you have more than one version of SYSPRO installed on a client, server, or standalone machine. You find the required entry in the `BaseDir` of the applicable machine (i.e. the client, the server or the standalone machine).
/log	Creates a 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. This file contains the path to your SYSPRO working directory. /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. This parameter is ignored if concurrent use of the operator code is enabled.
/htm=	Indicates the location of an HTML page (or an Internet address) that must be loaded for the operator. \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 of SYSPRO by indicating that a smaller splash screen image must be displayed when loading SYSPRO. \SYSPROClient.EXE /host=SysproServer /T
/exe=	Indicates that you want to override the assumed executable (i.e. `SYSPROClient.EXE` in a client/server environment and `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. /lang=07
/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. \SYSPROAuto.EXE /WCF=localhost:1978 /INSTANCE=2

Program and Function Parameters

Parameter Description and sample usage

Indicates that you want to hide the main SYSPRO login and menu screen, launch the named program and exit SYSPRO when the program has completed.

If run from a locked computer this will stop at the logon screen and the called program will not run.
This parameter is available only if the Office Automation & Messaging module is installed as part of your registration license.

Indicates that you want to run in silent mode. This should only be used for programs that have no user interface. Otherwise a Runtime 173 error message is displayed.

Details of the error message are written to a log file (RTS_ERROR.TXT) located in the settings folder on the server.

/prog=X Indicates the name of the SYSPRO program you want to launch.

/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.
Operator intervention is still required if the system cannot locate the import file.
Details of any error messages are written out to a log file (FILENAME.ERR).
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.

/prog=IMP01B /link=import-auto

/prog=WIPP60 /link=import-auto

/link=import-auto-file=XXXXXX

Automatically imports the file (where XXXXXX indicates the name of the file). 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.

The path and filename cannot exceed 150 characters.
Any errors detected are reported in a file of the same name as the FILENAME import file specified, but with an extension of .err.

/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=QOTP10 parameter, this begins the capture of a quotation for the customer indicated by xxxxxx. You do not need to insert leading zeros if the customer key type is numeric.

/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 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=QOTP10 parameter, this begins the maintenance of an existing quotation indicated by xxxxxx. If the quotation key type is numeric, you do not need to insert leading zeros.

/prog=REPP80/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 to run the report without operator interaction (providing the report contains no run-time prompts).

Prerequisites:

Request Print Dialog option is disabled
Request Print Dialog option is disabled
The report does not contain run-time prompts.

/link=CRM:

Captures a quotation against a prospect's number and name. The first 12 characters are the prospect's number and the next 30 characters are the prospect's name.

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 Quotation Entry.

/link=Function:NEW

Indicated after the /prog=MRPP40 parameter, this runs the Requirements Calculation program and takes a new snapshot. The system date is used as the date of the calculation.

If you want to output a log file containing details of the phases processed, as well as any errors that may have occurred, then 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.

If you specify a filename that exists, it is overwritten. If you exclude the pathing to the log file then the file is created in the Base folder of your SYSPRO installation. If Job Logging is enabled, then the same information is output to the job logging details.

/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. The system date is used as the date of the calculation.

/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 and recalculates, and recreates suggested jobs. The system date is used as the date of the calculation.If you want to output a log file containing details of the phases processed, as well as any errors that may have occurred, then 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.

/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 and recalculates, and retains current suggested jobs. The system date is used as the date of the calculation.

/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.

/prog=WIPP05 /link=JOB:590 /h

/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 to run the report without operator interaction (unless the report contains run-time prompts).

Prerequisites:

Request Print Dialog option is disabled
Print Preview option is disabled
The report does not contain run-time prompts.

/prog=REPP80 /LINK=REP-001 Y /h

/link-xfilename.edi

Indicated after the /prog=IMPNDX parameter, this uses the file selections created using 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.

/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 parameters:

BASE (the cost basis)
- B - BOM Costs
- I - Inventory costs
- L - Last cost
- W - What if costs
UPDATE (the costs you want to update)
- B - BOM Costs
- W - What if costs
- X - Both BOM and what-if costs

ROUTE (the route you want to use when rolling up costs). Enter ~ if costing is defined by warehouse; you are storing costs against the stock/warehouse record and you want to apply the routes and component warehouses held against the parent warehouse's control record.

This is ignored unless you are only updating what-if costs and alternate routings are in use.

If ignored and alternative routings are in use then the program will use route 0 or, if costs are retained by warehouse, the route (and component warehouse) defined against each parent warehouse's control record.

LOG
You can define a log file to which the processing details are written. You would use this instead of printing a log. If job logging is in use, then the processing details can be viewed using the Zoom function of the Job Logging Query program.

/prog=BOMP40 /link={Base:B,Update:W,Route:0,Log:.\BOMP40.LOG} /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 the programs you pre-define the form values required, otherwise the default system form values for the program are used.

You cannot run SYSPRO in automated mode if the monitor is locked.

/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.

/prog=TASK /link=Daily

where Daily indicates the name of the group of programs.

/link=KEY

Indicated after the /prog=SORPIQ parameter, the specific entry at the /link= parameter enables you to query a customer's invoice:

entry position 1 to 7 indicates the customer number.
entry position 8 to 13 indicates the invoice number.

/prog=SORPIQ /Link=0000001123456 /h

where 0000001 indicates the customer number and 123456 indicates the invoice number.

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.

character position 1 to 30 indicates the stock code.
character position 31 to 33 indicates the revision.
character position 34 to 36 indicates the release.
character position 37 to 38 indicates the warehouse.

/prog=MRPPE1 /Link=B100 FG /h

where B100 indicates the stock code and FG indicates the warehouse.

Indicated after the /prog=IMP041 parameter, the specific entry at the /link= parameter enables you to print an order document. The program assumes a single document must be processed and uses the key information supplied to determine the type of document that must be processed.

Document	Key for Print	Key for Reprint
Delivery note	Order no	Order no
Order acknowledgement	Order no	Order no
Dispatch note	Dispatch note no	Dispatch note no
Consolidated dispatch invoice	N/A	Invoice no
Dispatch invoice	Dispatch note no	Invoice no
Dispatch SCT transfer	Dispatch note no	Transfer no
SCT transfer	Order no	Transfer no
Invoice	Order no	Invoice no
Credit note	Order no	Invoice no
Debit note	Order no	Invoice no

To run without operator intervention, you need to ensure that a number of options are configured appropriately:

Request Print Dialog option is not selected.
Print Preview option is not selected.
Invoice sales recap is not enabled.

/prog=IMP041 /link=KEY000001 /h

/link=KILL

Indicated after the /prog=IMPPID parameter, this terminates all unknown processes on the server. An unknown process is one where a Windows SYSPRO process on the server is found with no corresponding entry in SYSPRO's user file. 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.

/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.

/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 (e.g. if you use this option when logged in as ADMIN, then SYSPRO processes for all operators are terminated with the exception of processes for operator ADMIN.

/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. It excludes any process initiated by the current operator code.

For example, 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.

This parameter works the same way as KILL-ALL, but applies only to operators logged into the same company as the current operator.

/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. This parameter is typically used when run from the command line.

/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 is typically used when run from the command line.

This parameter works the same way as KILL-ALL-EXIT, but applies only to operators logged into the same company as the current operator.

/prog=IMPPID /link=KILL-ALL-COMP-EXIT

Web Applet Parameters

Parameter	Description
&applet=ordentry.exe	Invokes the Customer order entry applet.
&applet=cusquery.exe	Invokes the Customer statement applet.
&applet=ordquery.exe	Invokes the Order status query applet.
&applet=invquery.exe	Invokes the Stock availability applet.
&applet=updcust.exe	Invokes the Edit customer details applet.
&applet=updsupp.exe	Invokes the Edit supplier details applet.

Notes and warnings

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
- Operator password (if the operator has a password)
- Company
- Company password (if the company has a password)