Directories, Files, and Shortcuts
The PlbWebSrv installation results in the creation of a base directory named 'c:\sunbelt\plbwebsrv.??'
where ?? is the software release number (i.e., 97). The following directories, files, and shortcuts are
created during the installation as follows:
-
sunbelt\plbwebsrv.??\code Directory
-
This directory contains the execution module for the PL/B Web Server along with the configuration to start
and stop the server.
-
plbwebsrv.ini
-
Default INI configuration file for the PWS server.
-
sunbelt\plbwebsrv.??\code\Logs Directory
-
This directory contains the PL/B Web Server log file.
-
sunbelt\plbwebsrv.97\http_root Directory
-
This directory is the root directory that contains the client side components that are dynamically transferred
to the client when an HTTP logon request is processed by the PWS server. This directory contains the following:
-
index.html
-
PL/B Web Demo startup html script file.
-
plbwebstart.html
-
This HTML script is the entry script logic executed at the PWS client.
-
plbwebcorstart.html
-
This HTML script is the entry script logic executed at the PWS Sunbelt Web App.
-
plbwebbasic.js
-
This JSON logic is the main client side logic required to allow the PL/B instructions to perform expected
client UI operations.
-
plbwebctls.js
-
This JSON logic is specialized client side logic used to support UI behaviors and visual affects required
for PL/B objects.
-
plbwebbasic.css
-
This file is a Cascading Style Sheet logic used for describing the presentation\formatting of the Web
objects implemented for the PWS server. The classes specified in the CSS file allow users to tailor the
some characteristics of a Web object appearing in the PWS client viewport window for a Web Browser.
-
plbwebipad.css
-
This file is a Cascading Style Sheet used to contain specialized style classes used for the presentation
of PWS client objects on an Ipad type of device.
-
plbwebiphone.css
-
This file is a Cascading Style Sheet used to contain specialized style classes used for the presentation
of PWS client objects on an Iphone type of device.
-
plbwebboot.html
-
This HTML script is the entry script logic executed at the PWS client when the URL specifies the '.plcb'
to use 'BootStrap 4' framework.
-
plbwebclose.html
-
This HTML file is the default HTML page that is executed if the Plb Web Server has been configured to
immediately close the client window. The 'plbwebclose.html' file is executed if the Plb Web Server has
been configured by setting the PLBWEB_MENU keyword to a '~' character or a 'plbwebclose.html' string.
The SETMODE *PlbWebMenuUrl keyword can also be used invoke the 'plbwebclose.html' page. The 'plbwebclose.html'
page can be used to close the browser window after a PL/B program exits and the PL/B Web Server child
process terminates.
-
plbweberror.html
-
This HTML file is the default HTML page that is executed after a PLB error dialog is closed by an end-user
in the client window. The 'plbweberror.html' can be modified or replaced by the PLB application developer
to provide application specific behaviors at the client window after an error has occurred. A keyword
named 'PLBWEB_ERROR={htmlfile}' can be specified in the 'PlbWebSrv.ini' configuration file to define a
default end-user HTML page to be used in place of the 'plbweberror.html' file. In addition, a *PlbWebErrorUrl={htmlfile}
can be used with the GETMODE and SETMODE instructions to provide program control for setting the HTML
page to be used when program termination with an error and the PL/B Web Server child process terminates.
-
plbwebmenu.html
-
This HTML file is a default HTML page that can be executed when a PLB program terminates normally. The
'plbwebmenu.html' can be modified or replaced by the PLB application developer to provide application
specific behaviors at the client window when a PLB program normally terminates. A keyword named 'PLBWEB_MENU={htmlfile}'
can be specified in the 'PlbWebSrv.ini' configuration file to define a default end-user HTML page or a
PL/B program (i.e. answer.plc') to be used in place of the 'plbwebmenu.html' file. In addition, a new
*PlbWebMenuUrl={htmlfile} has been added to the GETMODE and SETMODE instructions to provide program control
HTML page used on program normal termination.
-
plbwebnologon.html
-
This HTML file is the default HTML page that is executed when the PLB Web Server rejects a client logon
request. The execution of this HTML page is expected when the PLB Web Server is terminating after a '-t'
or '-f' server command has been executed.
-
plbwebbusy.html
-
This HTML file is the default HTML page that is executed when the PLB Web Server rejects a client logon
request because a client process could not be started due to a lack of system resources. These resource
may be memory, shared memory, or system semaphores.
-
plbwebuser.js
-
This file can be edited and used by a PL/B Web developer to include custom user JavaScript routines that
can be executed using the API (WINAPI) instruction or the CLIENT object 'JsRun' method. If this file
does not exist, it is created in the 'http_root' directory with a size of zero bytes. If this file already
exists in the 'http_root' directory, it is not changed nor overwritten. This file is referenced in the
'plbwebstart.html' file as a <script> that the browser downloads from the PWS server 'http_root'
directory.
-
-
sunbelt\plbwebsrv.??\http_root\images Directory
-
This directory contains .JPG or .PNG image files that are dynamically downloaded to a PWS client device
for a PL/B GUI ICON or PICT object. There is a new property for the ICON or PICT object named 'URLSOURCE={url}'
that can be used to reference these images.
-
sunbelt\plbwebsrv.??\http_root\css Directory
-
This directory contains the sub-directories and Cascading Style Sheets required to support the 'jQuery'
libraries that used for the PL/B Web Server operations.
-
sunbelt\plbwebsrv.??\http_root\css\images Directory
-
This directory contains the 'jQuery' images required to support 'jQuery' libraries operations.
-
sunbelt\plbwebsrv.??\http_root\js Directory
-
This directory contains the 'jQuery' Java script libraries used by the PL/B Web Server operations.
-
sunbelt\plbwebsrv.??\demo Directory
-
This is the base directory for the PL/B Web Server demo programs. This base directory has sub-directories
that are required to allow the PL/B Web Server demo programs to execute for the current configuration
specified in the 'plbwebsrv.ini' configuration file.
-
sunbelt\plbwebsrv.??\demo\Programs Directory
-
This directory contains the PL/B Web Demo programs that can be executed from a PWS client UI device.
-
sunbelt\plbwebsrv.??\demo\Programs\source Directory
-
This directory contains the source files for the PL/B Web Demo programs available for evaluation.
-
sunbelt\plbwebsrv.??\demo\SampleShortCuts Directory
-
This directory contains the PL/B Web Demo shortcuts that can be used for starting and stopping the PWS
application from a PWS client browser device.
-
'Local PLB Web Demo Programs' Shortcut
-
This shortcut is defined as 'http://127.0.0.1:8081/' that can start a PWS client browser by logging onto
a PWS server in a local workstation mode. This logon shortcut can only be used when the PLB_ADDRESS keyword
is assigned to the IP address of '127.0.0.1' in the 'plbwebsrv.ini' INI file settings.
-
'Local PLB Web Demo Programs (Debug)' Shortcut
-
This shortcut is defined as 'http://127.0.0.1:8081/answer.plc?runopt=-dr'. This shortcut executes the
'answer.plc' program and starts a GUI debug session by logging on to the DBGIFACE GUI debugger. The DBGIFACE
GUI debugger must already be started with the '-LISTEN' command line option. Otherwise, the 'answer.plc'
program will start without a debug session.
-
'Local Answer With Parameter' Shortcut
-
This shortcut is defined as 'http://127.0.0.1:8081/answer.plc?cmdline=parm1=5,%20Next'. This shortcut
executes the 'answer.plc' program and it passes PL/B program parameters which are moved into the S$CMDLIN
global variable when the program starts executing.
-
'Local Answer With Parameter (Debug)' Shortcut
-
This shortcut is defined as 'http://127.0.0.1:8081/answer.plc?cmdline=parm1=5,%20Next&runopt=-dr'.
This shortcut executes the 'answer.plc' program and it passes PL/B program parameters which are moved
into the S$CMDLIN global variable when the program starts executing. Also, this shortcut starts a GUI
debug session by logging on to the DBGIFACE GUI debugger. The DBGIFACE GUI debugger must already be started
with the '-LISTEN' command line option. Otherwise, the 'answer.plc' program will start without a debug
session.
-
'Network PLB Web Demo Programs' Shortcut
-
This shortcut is defined as 'http://192.168.1.105:8081/' that can start a PWS client browser by logging
onto a PWS server in a network workstation mode. This logon shortcut can only be used when the PLB_ADDRESS
keyword is assigned to the IP address of '192.168.1.105:8081' in the 'plbwebsrv.ini' INI file settings
and this IP address is valid for the PL/B Web Server.
-
The IP address found in the PLBWEB_HOSTNAME keyword of the 'plbwebsrv.ini' file must be changed to the
IP address of the workstation on the network where the 'plbwebsrv.exe' server is executing. The properties
of the Network shortcut must be changed to use the same IP address of the workstation where the 'plbwebsrv.exe'
server is executing.