The next line describes the usual program call arguments of ELP for Linux/Unix/Aix/VMS etc  The Windows Print Processor adds them all:

ELP_executable IN_FILE OUT_FILE [-dWorkingDirectory] [-eElpCommandFile] [all other switches]
ELP_executable STDIN STDOUT [-dWorkingDirectory] [-eElpCommandFile] [all other switches]
ELP_executable IN_FILE STDOUT [-dWorkingDirectory] [-eElpCommandFile] [all other switches]
ELP_executable STDIN OUT_FILE [-dWorkingDirectory] [-eElpCommandFile] [all other switches]

The first 2 parameters are mandatory!

 

first parameter STDIN in upper case instructs ELP to read the data stream via stdin.
As ELP is usually piped in a shell script, this is usually the first argument.
  IN_FILE alternatively any file name including path can be supplied. ELP will read and process the complete file.
second parameter STDOUT in upper case instructs ELP to write the data stream to stdout.
As ELP is usually piped in a shell script, this is usually the second argument.
  OUT_FILE alternatively any file name including path can be supplied. ELP will write the processed data to that file.

 

Notes:

  • In the following arguments is NO(!) space allowed between the command line switch and its argument!
  • The first character is case insensitive, the argument usually not.
  • If arguments might contain blanks, please set the complete arguments within ""
  • Especially for Linux, some of the arguments are available in the shell environment, so either pass them in the command line using %Env.Variable.Name% or use in the rule GLOBAL the GetEnvVariable key.

 

-cIniFile.ini -c followed directly with a full path plus file name of the converter 's command file name. This file defines a huge range of additional ELP commands, like triggered rules or searched items.
Usually the file is called convert.ini and it is generated with the Windows Version of ELP. For Linux etc. simply copy the file over.
For W-ELP the path can be set in the Admin Register Tab 
-dWorkingDirectory -d followed directly with a full directory path advises the ELP software, where to look for the macro files or store the log files or debugged data streams. Therefore it is recommended to set full access to that directory for all users.
For W-ELP the path is set in the Admin Tab.
The command line option is stored into the ELP variable #ELP_FORMS_PATH#
-fPathToPDFConverter.exe Windows only: The full path and program call for the Lincoln  PCL5 or PCL6 to PDF converter. The path is set in the Admin Tab 
-iPathToTIFFConverter.exe Windows only: The full path and program call for the Lincoln  PCL5 or PCL6 to TIFF converter. The path is set in the Admin Tab 
-o[i|o] Same command as INI-file DEBUG_INDATA and DEBUG_OUTDATA commands, which should be preferably used and set here
This parameter is used for archiving print files, or simply for input and output data caption. Important: The -d command must be supplied. This parameter will generate up to two files: in_data.prn and out_data.prn in the WorkingDirectory.
-oi stores only the incoming data
-oo stores only the outgoing data
-o stores both data streams
-p1NameOfThePrinter In order to perform print queue name based rules, this command can be used to tell ELP the actual printer name.
The command line option is stored into the ELP variable #PRINTERNAME#
For CUPS ELP can also read the environment variable, holding this name.
Is a Rule rule named like this argument, it is executed right at the beginning of the process.
-p2NameOftheWorkstation/Server/PC. Can be used for watermark printing or for W-ELP to redistribute the job to the same server.
The command line option is stored into the ELP variable #PCNAME# usually \\NAME depending on the system, sometimes this is also the IP of the server, see also -q7
-p3NameOfTheUser Usually the logon name of the user. It is stored int the ELP variable #USERNAME#. See also -r3 switch
Is a Rule rule named as this argument, it is executed right at the beginning on the process.
-p4DocumentDescription MS Windows: Document Description coming from the spooler. See also -q6
The command line option is stored into the ELP variable #PRINTDOCNAME#
-p5TotalPages

If provided, (MS Windows) it is independent for the data stream language documented by the Accounting module: For PCL5 data streams the number is verified by ELP using form feed counting.
The command line option is stored into the ELP variable  #ACCTOTALPAGES#

-p7 If set W-ELP behaves like a Linux / Printer internal version of the product. Functions like IN/OUTPORT will not work anymore under Windows.
The command line option is stored into the ELP variable !DIMM_EMULATION!
-p8# Distributor number # for watermark and other behaviors.

-p9Port

TCP/IP number or port expression of the windows printer driver. Is a Rule rule named like this argument, it is executed right at the beginning of the process.
The command line option is stored into the ELP variable  #VAR_TCPIP_PORT#
-q0ShareName Printer share name, mainly for W-ELP in order to resend the same job to the same queue using the variable \\#HOSTNAME#\#PRINTERSHARENAME#.
The command line option is stored into the ELP variable #PRINTERSHARENAME#
-q1DriverName Also mainly for W-ELP to setup triggered rules which belong for all activated printers, using a special driver.
The command line option is stored into the ELP variable  #PRINTERDRIVERNAME#
-q3LogFileName The default log file name is log_file.txt located in the -d directory. As this file is overwritten by each print job, when just a special queues should be logged, then either set the protocol here or pass in a special log file name with that command line key.
-q6PrintDocNameInUnicode MS Windows: Document Description coming for the spooler in Unicode encoding. See also -p4 
The command line option is stored into the ELP variable #PRINTDOCNAME_UNI#
-q7NameOftheWorkstation/Server/PC Can be used for watermark printing or for W-ELP to redistribute the job to the same server. Compared to -p2 it is usually the real name.
The command line option is stored into the ELP variable #HOSTNAME#
-q8 Only for UNIX/Linux based systems. If this parameter is set and STDIN is the first argument, ELP reads first from stdin the complete job into a temp file, and then process the job out of it.
The file is removed after printing.

-r1PrinterLocationText

Windows: Location field content of the windows queue description
The command line option is stored into the ELP variable  #DRIVERLOCATION#

-r2QueueDescription Windows: Comment field content of the windows queue description
The command line option is stored into the ELP variable #DRIVERCOMMENT#
-r3UserName

User name in ELP's Unicode encoding, see also -p3 switch
The command line option is stored into the ELP variable  #USERNAME_UNI#

-tTriggerFile Windows only: Filename to trigger file (#_#.trg) that indicates the print processor welpprint.dll that the job is done.
-wWaterMarkText ELP in demo mode prints a watermark. The text can be manipulated with the distributor number (see -p8) or with the here provided  text

 

All the following arguments are older, from the beginning of the ELP development. They should not be used in the command line anymore because they can be defined as well in the ini file. For backward compatibility they are still in and fully supported.

 

-eElpCommandFile followed directly with a full path and file name of a text file, holding a complete ELP Command.
-g# The positive number stands for the DEBUG Mode. As this mode is usually set in the rule GLOBAL using the key LOG_MODE (usually set here!) the only interesting number here might be -g20. This number will document only on the Windows platform the processing speed of the filter recorded in the file log_file.txt in the forms directory.
IMPORTANT NOTE: -g must be AFTER the -d parameter!
Note: If an virus scanner is running which monitors file access, the system may result in very slow printing.

 

Examples for program calls:

convert INfile.tmp OUTfile.prn
convert STDIN STDOUT < INfile.tmp > OUTfile.prn
convert $1 STDOUT -d/home/user/ELP-dir -c/home/user/ELP-dir/cinvert.ini | LP ......

The first 2 examples, used on an UNIX platform, perform exactly the same action.

For test purposes, use some of the demo files *.pcl supplied with the product.

 

Related articles: X-ELP and Linux / Unix / AIX / Solaris etc.