Progress® OpenEdge® Compilation Tools

General

Tasks

!!UPDATED!!

Types

Selectors

RCodeSelector

PCTWSBroker task -- <pct:wsbroker />

Description

Adds, updates and deletes WebSpeed brokers declarations

Parameters

Attribute	Description	Type	Requirement	Default value
WorkDir	Working directory	File	Optional	No default value
PortNumber		Integer	Optional	No default value
AutoStart		Boolean	Optional	False
BrokerLogFile	Broker's log file	File	Required	No default value
BrokerLogLevel	Should be between 1 and 5	Integer	Optional	No default value
BrokerLogFileAppend	Append to broker log file	Boolean	Optional	True
ServerLogFile	Server's log file	File	Optional	No default value
ServerLogLevel	Should be between 1 and 5	Integer	Optional	No default value
ServerLogFileAppend	Append to server log file	Boolean	Optional	True
InitialPool	Initial number of servers to start	Integer	Optional	No default value
MinPool	Minimum number of servers	Integer	Optional	No default value
MaxPool	Maximum number of servers	Integer	Optional	No default value
NameServer	Controlling name server	String	Optional	NS1
appURL	Application's URL	String	Optional	No default value
CookiePath		String	Optional	No default value
CookieDomain		String	Optional	No default value
uploadDir	Default upload directory	File	Optional	No default value
binUploadMaxSize		Integer	Optional	No default value
debugMode	2 = Default -- 0 = Disabled -- 2 = Enabled	Integer	Optional	2 (Default)
srvAppMode	False = development -- True = production	Boolean	Optional	False (Development)

Parameters as nested elements

server (com.phenix.pct.PCTASServer)

Definition of servers processes ; Inherits from attributes of PCTRun task, except for the followings :

procedure attribute default value is web/objects/web-disp.p
graphicalMode attribute is removed
debugPCT attribute is removed
baseDir attribute is removed
webLogError attribute is added. Default value is true

Examples

<PCTWSBroker action="create" name="Test" dlcHome="${env.DLC}" />

Simplest declaration : this will create a [UBroker.WS.Test] section in the $DLC/properties/ubroker.properties file. In this case, every attribute is inherited from parent sections.

<PCTWSBroker action="update" name="Test" dlcHome="${env.DLC}" portNumber="1234" />

Updates the previously created broker, by adding portNumber property.

<PCTWSBroker action="delete" name="Test" dlcHome="${env.DLC}" />

Deletes the previously created appserver.

<PCTWSBroker action="delete" name="Test" dlcHome="${env.DLC}" file="myubroker.properties" uid="auto">
  <server procedure="mycustomproc.p" webLogError="false">
    <propath>
      <pathelement path="build" />
      <pathelement path="src" />
    </propath>
    <PCTConnection dbName="foo" dbDir="base" />
    <PCTRunOption name="-pf" value="conf/runtime.fp" />
  </server>
</PCTWSBroker>

WebSpeed broker definition will look like this :

[UBroker.WS.Test]
appserviceNameList=Test
registerNameServer=1
controllingNameServer=NS1
registrationMode=Register-IP
operatingMode=stateless
autoStart=0
srvrStartupParam=-db base/foo -pf conf/param.pf -pf conf/runtime.pf -p mycustomproc.p
propath=build,src
uuid=!!! A RANDOMLY GENERATED UUID !!!

This definition will be integrated in myubroker.properties instead of standard $DLC/properties/ubroker.properties