PLBCE Command Line Syntax
Since Windows CE has no command line interface, a text file with an extension of PLW containing the command line for PLBCE may be used. The PLW file extension is associated with the runtime when it is installed. For example, the PLW file might contain a command line such as:
The PLW file must contain a single line with the following format:
Parameters:
options
One of the valid command line options listed below.
plc
The name of a previously compiled PL/B program.
args
Program arguments passed to the PL/B program using the S$CMDLIN system variable.
Note the following:
The following options are available:
|
Option |
Meaning |
|
a |
execute runtime using 'ansi.sys'. |
|
b |
force screen controls S0 through S9 to update screen. |
|
e |
display user count information for all runtimes and expiration time for time stamped runtimes. |
|
f |
adjust font size. |
|
g{nnnnnnn} |
allocate memory for global data area (Default is 65535). The value is specified in bytes. |
|
h |
hide primary window. |
|
i {ini name} |
override the default .ini file. |
|
ms |
override number of subwindows that may be saved (Default is 10). |
|
s {scrn name} |
override the default screen definition file selection. |
|
t |
sets the wait time in seconds to receive a complete function key. |
|
p {print device} |
override the default printer device/file. |
|
w{nn} |
set default screen attribute where nn is a hex digit. |
Any of the options are accepted in either upper or lower case.
If {plc} is not specified, PLBCE searches the root directory then each one in the PLB_PATH environment variable list, if specified, (i.e., the search paths) for the default ANSWER and MASTER files specified by the screen definition file in use.
If {scrn file} is specified with the "s" option, it is used instead of the screen definition name built by appending ".def" to the user's TERM entry. Note: There may be a space between the "s" option and the file specification.
If {print device} is specified with the "p" option, it is used in place of the default printer device/file in the screen definition file. Note: There may be a space between the "p" option and the file specification.
If {ini file} is specified with the "i" option, the file name is used in place of the default program information file (PLBWIN.INI). Note: There is a space between the "i" option and the file specification. The name is limited to twelve (12) characters. If an extension is not specified, the default extension (.ini) is used.
The .ini file name processing occurs as follows:
The runtime qualifies and uses an INI file when the file contains any section header. A section header is an INI file record that starts with '[' and is terminated with a ']'.
The runtime looks for and uses an INI filename found in three possible directories. The runtime always processes the INI files in the same order giving the user the ability to override globally defined parameters. The file name searching is as follows:
First, the runtime looks for an INI filename in the current working directory. This allows someone doing very specific and local program execution using keyword controls that override default keyword controls specified in (b) or (c) below.
Second, the runtime looks for an INI filename in the current user Windows directory. If the INI filename is found, it becomes the local keyword controls for the runtime. This allows someone to define workstation INI file controls. The local INI file controls can override (c) below.
Third, the runtime looks for an INI filename in the directory where PLBCE.EXE is found. If the INI filename is found, it becomes the global (default) keyword controls for the runtime.
If the runtime is started WITHOUT using the '-i' option, the runtime looks for the default INI file named 'PLBWIN.INI' in the three possible areas. Any PLBWIN.INI files found in the three directories are then used to locate requested INI file keywords in the order as described in (B) above.
If the runtime is started WITH the '-i' option being specified and the INI file name DOES NOT have a path specified, the runtime looks for the INI file name in the three possible directories defined in (B) above. The runtime only processes the user named INI file from the three directories defined in (b.) above. This means the 'PLBWIN.INI' is NOT used in this case.
If the runtime is started WITH the '-i' option being specified and the INI file name DOES have a path specified, the runtime looks for and uses the single specified INI file if found. This case DISABLES the runtime from processing multiple INI files as described in (B) above.
Command Line Examples:
Use the default screen definition file built by appending '.def' to the TERM environment variable entry and all the default PL/B environment characteristics therein (including the default printer device/file). Attempt to initiate the ANSWER to MASTER program concept by searching the search paths for the ANSWER and MASTER programs specified in the screen definition file in use.
Use the default screen definition file and then append the PL/B Code extension specified in the screen definition file to 'test' and attempt to load it from one of the search paths.
Override the default screen definition file and use 'scrndef.def' in its place, search the search paths for 'MASTER.PLC'. Note: there is a space between the "s" and the file name.
Override the specified printer device/file name within the default screen definition file with '\usr\spool\report1.lst' in its place, search the search paths for 'report.plc'. Note: there is a space between the "p" and the file name.
Use the default screen definition file and attempt to load 'test.plc' from one of the search paths. The argument to 'test.plc' is '*.pls'. The string "option1" is placed in the system variable S$CMDLIN.
Each option must be specified separately.
See Also: PLBCE Runtime Requirements, PLBWIN INI File Format, PLBCE Keywords, PLBCE Non-Supported Features, Compiler and Runtime Options
|
|