 |
 |
|
|
|
|
|
|
|
|
Command Line Parameters
Command line parameters can be supplied to modify PBL Peeper’s start up behaviour.
Command line parameters can be supplied via Windows Run command dialog or via shortcut
properties. Please see Windows documentation for full information on how to supply
applications with command line parameters. See the Applied PBL Peeper chapter for details on
how to use these parameters to launch PBL Peeper from Windows Explorer.
Application Start
/WIN:InitWindow
|
Automatically loads the specified window on start. Default
value is PBLPeeper when this parameter is not specified, or
when an incorrect value is supplied to this parameter.
Acceptable values are:
PBLPeeper
SQLFormatter
SQLParser
ScriptFormatter
Stringer
PSRViewer
RTFViewer
None
|
PBL Peeper Start
“Application” Contents
/PBVER:x
|
Identifies the “current” version of PowerBuilder to be used to
determine the application identify. If omitted, the latest version
of PowerBuilder found will be used as the current version.
|
/CURRENT
[:{WORKSPACE |
TARGET |
APPLICATION}]A
|
Automatically loads the current application, target or
workspace as defined by PowerBuilder for the current
PowerBuilder version. When not specified, the parameter
defaults to the current application. For PowerBuilder 8 and
forward, when the application is specified, the last run
application in the current workspace is loaded. Automatically
switches to the Browse page, indexing PBL directories, unless
/INITPAGE is specified.
|
/APP:xyzA
|
Loads the application with the name. If more than one
application with the name xyz are defined in the PB.INI file, the
one that is either current or last defined is used. Searches the
PB.INI of the current version of PowerBuilder only. In
PowerBuilder 8 and forward, appropriate registry entries,
workspace and target files are searched. Automatically
switches to the Browse page, indexing PBL directories, unless
/INITPAGE is specified.
|
/TARGET:TargetFileNameA
|
Loads the application associated with target file. Automatically
switches to the Browse page, indexing PBL directories, unless
/INITPAGE is specified.
|
/WORKSPACE:WorkspaceFileNameA
|
Loads all PowerBuilder applications associated with workspace
file. Automatically switches to the Browse page, indexing PBL
directories, unless /INITPAGE is specified.
|
/PBL:PBLName1[,PBLName2...]A
|
Loads the PBL or PBLs listed. Wildcards are accepted. The
supplied PBL names should be fully pathed. Automatically
switches to the Browse page, indexing PBL directories, unless
/INITPAGE is specified.
|
/PBLAPP:PBLNameA
|
Loads the first application found that has the supplied PBL in
its library list. Searches the PB.INI of the current version of
PowerBuilder only. In PowerBuilder 8 and forward,
appropriate registry entries, workspace and target files are
searched. If this search fails to load an application, all PBLs
from the same directory as PBLName will be loaded.
Automatically switches to the Browse page, indexing PBL
directories, unless /INITPAGE is specified.
|
/EXPORTS:FolderNameA
|
Loads the folder as an export container (acts the same as a
PBL) if any *.SR* files are found.
|
/S
|
Used with /PBL or /EXPORTS, searches subdirectories
beneath the one specified for matching files or folders.
|
Initial Behaviour
/INITPAGE:pageB
|
Used in conjunction with /CURRENT, /APP, /PBL or
/PBLAPP. When the app specified in the command line
parameter is loaded, the application moves to the specified
page of the tab on the main window. Valid values are:
Browse
Lists
Find
Reports
Trace
Exports
Process
Compare
|
/DBG:filenameB
|
Loads the DBG file specified in the filename parameter. The
Trace page is automatically selected. May be used with in
conjunction with any other parameters that load an application,
but if none is provided, the DBG file will be shown in the
treeview without source code shown in parallel.
|
/INDEX:expr[,expr2...]
|
For the application specified by another parameter, all the
objects in all PBLs prefixed by one of the expr are indexed.
|
/PBINI:file1[,file2...]
|
Loads applications from a PB.INI file other than the one found
in the same directory as the PowerBuilder executable.
|
Tool Windows Start
/LOADCLIPBOARDC
|
Loads a value from the clipboard on start up. The default action
is automatically initiated. Applicable when the initial window
is SQLFormatter, ScriptFormatter or Stringer.
|
/LOADFILE:FileNameC
|
Loads the contents of the specified file on start up. The default
action, if applicable, is automatically initiated. Applicable
when the initial window is SQLFormatter, ScriptFormatter,
Stringer, PSRViewer or RTFViewer.
|
/SAVECLIPBOARDD
|
Saves the result of the default action to the clipboard. Valid
only with /LOADCLIPBOARD or /LOADFILE. Applicable
when the initial window is SQLFormatter, ScriptFormatter or
Stringer.
|
/SAVEFILE:FileNameD
|
Saves the result of the default action to the specified file. Valid
only with /LOADCLIPBOARD or /LOADFILE. Applicable
when the initial window is SQLFormatter, ScriptFormatter or
Stringer.
|
/AUTOCLOSE
|
If parameters /LOADCLIPBOARD or /LOADFILE and
/SAVECLIPBOARD or /SAVEFILE are successful, PBL
Peeper is automatically closed down. Applicable when the
initial window is SQLFormatter, ScriptFormatter or Stringer.
|
It should be noted that options with identical superscripts are mutually exclusive.
Sole File or Directory Parameters
If only a file name is passed to PBL Peeper, the parameter will be mapped based on the file
extension as follows:
Extension
|
Mapping
|
PBL
|
/PBLAPP:%1
|
PBT
|
/TARGET:%1
|
PBW
|
/WORKSPACE:%1
|
SR*
|
/EXPORTS:%1
|
TXT, RTF
|
/WIN:RTFViewer /LOADFILE:%1
|
PSR
|
/WIN:PSRViewer /LOADFILE:%1
|
SQL
|
/WIN:SQLFormatter /LOADFILE:%1
|
If only a folder name is passed to PBL Peeper, the parameter will be mapped to /EXPORTS.
|
|
|
|
|
|
|
|
|
|
|
