PLBWEB_DEFAULT Keyword
PLBWEB_DEFAULT={ [ PlcProgName | WebPageName ] }
This keyword specifies the default PLB program name or a HTML web page file to be executed when a PL/B
Web client initiates a logon request that does not have anything specified in the URL logon request string.
If this keyword is not specified or this keyword is assigned to be null, the PL/B Web Server runtime locates
and executes the ‘answer.plc’ applying the normal PL/B Answer\Master concept.
Note:
1. The {PlcProgName}
program name must include the extension and the name is case sensitive.
2. The {PlcProgName}
program name can begin with a relative sub-directory to the OS directory specified by the PLBWEB_PROGRAM_ROOT
keyword. The {PlcProgName} cannot contain a fully qualified OS path.
3. If the PLBWEB_PROGDD
keyword is set to an ‘off’ state, the {PlcProgName} may not contain any pathing information. Otherwise,
the program may not be executed. When the PLB_PROGDD keyword
is set to ‘off’, this configuration prevents unsolicited probing by malicious logon requests.
4. Alternatively, the
PLBWEB_DEFAULT can specify the file name of a Web Page that is to be downloaded to a client browser when
a PL/B Web client initiates a logon request that does not have anything specified in the URL logon request
string.
Examples assuming PLBWEB_PROGDD=ON:
-
PLBWEB_DEFAULT=
-
In this case, when the PL/B Web Client URL does not provide a PLC program name, the PL/B Web Server locates
and executes the 'answer.plc' program using the normal Answer\Master concept.
-
PLBWEB_DEFAULT=mymaster.plc
-
The program named ‘mymaster.plc’ is used as the default startup program. This PLC program must be located
in the directory specified by the PLBWEB_PROGRAM_ROOT when the PLBWEB_PROGRAM_ROOT keyword is used. If
the PLBWEB_PROGRAM_ROOT is NOT being used, the PL/B Web Server attempts to find and open the ‘mymaster.plc’
program like all other PL/B runtimes. First, the runtime attempts to open the PLC in the current working
directory. Otherwise, the runtime scans the PLB_PATH directories to locate the PLC.
-
PLBWEB_DEFAULT=companyPath\mymaster.plc
-
The program named ‘companyPath\mymaster.plc’ is used as the default startup program where the PLC must
exist in a sub-directory named ‘companyPath‘. If the PLBWEB_PROGRAM_ROOT is used, the ‘companyPath’ sub-directory
must exist under the PLBWEB_PROGRAM_ROOT directory. Otherwise, normal runtime searching methods are used
to find and open the PLC program.
-
PLBWEB_DEFAULT=c:\companyPath\mymaster.plc
-
A fully qualified Windows OS path is not allowed.
-
PLBWEB_DEFAULT=/usr/home/user/Path/mymaster.plc
-
A fully qualified Linux OS path is not allowed.
-
-
PLBWEB_DEFAULT=demo.html
or
PLBWEB_DEFAULT=index.html -
A default web page is specified
See Also: PLBWEBSRV Keywords,
Server
Command Line