Progress® OpenEdge® Compilation Tools

General

Tasks

!!UPDATED!!

Types

Selectors

RCodeSelector

PCTASBroker task -- <pct:asbroker />

Description

Adds, updates and deletes appservers brokers declarations

Parameters

Attribute	Description	Type	Requirement	Default value
Name	Appserver's name	String	Required	No default value
Action	Must be one of create, update, delete	String	Required	No default value
OperatingMode	Should be stateless, state-aware, state-reset or state-free	String	Optional	Stateless
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

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 is removed
graphicalMode attribute is removed
debugPCT attribute is removed
baseDir attribute is removed
activateProc attribute is added
deactivateProc attribute is added
startupProc attribute is added
shutdownProc attribute is added
connectProc attribute is added
disconnectProc attribute is added

Examples

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

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

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

Updates the previously created appserver, by adding portNumber property.

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

Deletes the previously created appserver.

<PCTASBroker action="delete" name="Test" dlcHome="${env.DLC}" file="myubroker.properties" uid="auto">
  <server startupProc="apsv/startup.p" shutdownProc="apsv/shutdown.p" paramFile="conf/param.pf">
    <propath>
      <pathelement path="build" />
      <pathelement path="src" />
    </propath>
    <PCTConnection dbName="foo" dbDir="base" />
    <PCTRunOption name="-pf" value="conf/runtime.fp" />
  </server>
</PCTASBroker>

Appserver's definition will look like this :

[UBroker.AS.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
srvrStartupProc=apsv/startup.p
srvrShutdownProc=apsv/shutdown.p
propath=build,src
uuid=!!! A RANDOMLY GENERATED UUID !!!

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