Tasks and extension points for custom code

We can use the following tasks and extension points when creating custom code to work with the ConfigEngine framework.

Common Properties

These attributes are a reflection of similar attributes present on the WsAdmin task. Not all attributes on the WsAdmin task are exposed and some have a restricted range of values. None of these values are written into the dynamic profile.

Attribute	Description	Required	Scope
wasuser	Contains the user ID to authenticate with the server.	Yes	Global
waspassword	Contains the password associated with the wasuser user ID to authenticate with the server.	Yes	Global
conntype	Type of server connection. The following values are allowed: SOAP: Establishes a SOAP connection. This value is the default. NONE: No server connection is used. Instead, a direct connection to the local WebSphere Application Server configuration repository is used.	No	Global
properties	Java properties file containing attributes to set in the JVM System properties. The default is ${EngineInstallLocation}/config/work/was/jacl.properties.	No	Global
script	Provides the location of the deployment script file. This file contains has a set of commands to be passed to the WsAdmin script processor. The script processor used is determined by the setting of the lang attribute. If not specified, each deployment task assigns a default script location, built from the home directory of the configuration engine and a name specific to the task (for example: wplc_deployEar). Refer to the individual task for this name. The file extension is determined by the setting of the lang attribute.	No	Global
lang	Contains the language to be used to interpret scripts. The supported values are as follows: jacl: Use the Jacl interpreter. This value is the default. jpython: Use the Java Python interpreter.	No	Global

Framework-specific Attributes

These attributes provide information about the runtime environment associated with the configuration engine.

Attribute	Description	Required	Scope
engineinstalllocation	The location of the configuration engine home directory. This location is used as the root when constructing many of the default locations. It defaults to the setting of the Ant property: engineInstallLocation.	No	Global
engineinstalllocation	The location of a deployment file containing some or all of the deployment attributes of the targeted resource(s). This file is an XML file whose syntax mirrorthat of the Ant task which references the file.	No	not applicable

Embedded Markup Tag

The following markup tags are supported.

Comment markup tag

Use the comment markup tag to embed a comment into a task value. The comment text is displayed during the task output trace, enclosed by parentheses, but is not included in the value passed to the task execution. Use <c> or <comment> to begin a comment. This tag has no attributes.

Default markup tag

Use the default markup tag to force a default value for a task value. The default is chosen if the target value resolves to an empty string. Otherwise, it is ignored. Use <d> or <default> to delimit text that is defaulted. This tag has the following single attribute:

• value: The default value. This attribute is required.

Lower markup tag

Use the lower markup tag to force text to lowercase. Use <l> or <lower> to delimit lower case text. This tag has no attributes.

Password markup tag

Use the password markup tag to indicate a portion of text that is to remain hidden (or obscured) whenever the text value is logged. Use <p>, <pw>, or <password> to indicate the beginning of password text. This tag has no attributes. The default is to substitute the string, PASSWORD_REMOVED, for the text value during logging. We can override this value using the log attribute.

• log: The value that is substituted for the real password during logging of the task. Defaults to PASSWORD_REMOVED. This attribute is not required.

Upper markup tag

Use the upper markup tag to force text to uppercase. Use <u> or <upper> to delimit upper case text. This tag has no attributes.

Examples

The following example illustrates the use for each of the supported tags. The last instance embeds an undefined tag. This tag causes the parsing to abort and results in a value that is unchanged.

<wplc-create-variable server="server"
      node="node"
      wasuser="${WasUserid}"
      waspassword="${WasPassword}"
      testbeanclass="com.ibm.wplc.deploy.tasks.impl.TestAdminBeanImpl">
      <resource name="r1" value="&lt;cValue for r1&lt;/>v1"/>      
    <resource name="r2" value="&lt;dvalue=&quot;xxx&quot;> &lt;/>"/>    
    <resource name="r3" value="<u>uPpEr</u>"/>      
    <resource name="r4" value="<l>LoWeR</l>"/>      
    <resource name="r5" value="<p>password</p>"/>      
    <resource name="r6" value="<p log="SECRET">password</p>"/>      
    <resource name="r7" value="<undefined attr="Attribute">password</undefined>"/>    
</wplc-create-variable> 

Run the previous task results in the following trace. The second set of output for each instance is produced by the test bean class. This bean class is a dummy bean implementation used to echo the output passed in to a bean for each WPLC task.

    [wplc-create-variable] Task parameters:
    [wplc-create-variable]   Global attributes:
    [wplc-create-variable]     cell=""
    [wplc-create-variable]     engineinstalllocation="directory_path"
    [wplc-create-variable]     pathseparator=";"
    [wplc-create-variable]     osarch="x86"
    [wplc-create-variable]     node="node"
    [wplc-create-variable]     server="server"

    [wplc-create-variable]   Instance attributes (Set 1 of 7):
    [wplc-create-variable]     name="r1"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="(Comment:  Value for r1)v1"
    [wplc-create-variable] name="r1"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="v1"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 2 of 7):
    [wplc-create-variable]     name="r2"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="xxx"
    [wplc-create-variable] name="r2"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="xxx"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 3 of 7):
    [wplc-create-variable]     name="r3"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="UPPER"
    [wplc-create-variable] name="r3"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="UPPER"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 4 of 7):
    [wplc-create-variable]     name="r4"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="lower"
    [wplc-create-variable] name="r4"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="lower"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 5 of 7):
    [wplc-create-variable]     name="r5"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="PASSWORD_REMOVED"
    [wplc-create-variable] name="r5"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="password"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 6 of 7):
    [wplc-create-variable]     name="r6"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="SECRET"
    [wplc-create-variable] name="r6"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="password"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 7 of 7):
    [wplc-create-variable]     name="r7"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="password"
    [wplc-create-variable] name="r7"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="password"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

wplc-create-application-library-ref

Definition and usage

Use this Ant task to create or modify the specified library reference

Required parameters

The following parameters are required:

• appName: The name of the application with required library reference. The scope is instance.

• libraryName: The name of the library reference. The scope is instance.

Optional parameters

The following parameters are optional:

• mode: The mode of the classloader. The scope is instance.

• sharedClassloader: Boolean - specifies whether or not to use a shared classloader. The scope is instance.

Parameters specified as nested elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationLibraryRefCreateImpl class implements this task.

wplc-remove-application-library-ref

Definition and usage

Use this Ant task to remove the specified library reference

Required parameters

The following parameters are required:

• appName: The name of the application with required library reference. The scope is instance.

• libraryName: The name of the library reference. The scope is instance.

Optional parameters

The following parameter is optional:

• mode: The mode of the classloader. The scope is instance.

Parameters specified as nested elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationLibraryRefRemoveImpl class implements this task.

wplc-create-app-server-classloader

Description and usage

Use this Ant task to create the specified application server classloader.

Required parameters

The following parameters are required:

• mode: The mode to operate the application server classloader in. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.
• node: The node scope of resource action. The scope is global.

• server: Server scope of resource action. The scope is global.

Parameters specified as nested Elements

A generic attribute parameter for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationServerClassloaderCreateImpl class implements this task.

wplc-remove-app-server-classloader

Description and usage

Use this Ant task to create the specified application server classloader.

Required parameters

The following parameters are required:

• mode: The mode to operate the application server classloader in. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.
• node: The node scope of resource action. The scope is global.

• server: Server scope of resource action. The scope is global.

Parameters specified as nested Elements

A generic attribute parameter for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationServerClassloaderCreateImpl class implements this task.

wplc-create-app-server-custom-property

Description and usage

Use this Ant task to create or modify a custom property.

Required parameters

The following parameters are required:

• name: The name of the property to create. The scope is instance.

• value: The value of the property to create. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.
• description: The description of the property we are creating. The scope is instance.
• node: Node scope of resource action. The scope is global.

• required: Boolean - specifies if the property is required or not. The scope is instance.

• server: Server scope of resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationServerCustomPropertyCreateImpl class implements this task.

wplc-remove-app-server-custom-property

Description and usage

Use this Ant task to remove a custom property.

Required parameters

The following parameter is required:

• name: The name of the property to remove. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.
• node: The node scope of resource action. The scope is global.

• server: Server scope of resource action. The scope is global.

Parameters specified as nested Elements

A generic attribute parameter for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationServerCustomPropertyRemoveImpl class implements this task.

wplc-create-app-server-library-ref

Description and usage

Use this Ant task to create or modify the specified reference.

Required parameters

The following parameters are required:

• libraryName: Tells what library reference to add. The scope is instance.

• mode: The mode of the classloader. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.
• node: Node scope of resource action. The scope is global.

• server: Server scope of resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationServerLibraryRefCreateImpl class implements this task.

wplc-remove-app-server-library-ref

Description and usage

Use this Ant task to remove the specified library reference.

Required parameters

The following parameters are required:

• libraryName: Tells what library reference to remove. The scope is instance.

• mode: The mode of the classloader. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.
• node: Node scope of resource action. The scope is global.

• server: Server scope of resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationServerLibraryRefRemoveImpl class implements this task.

wplc-create-cmp-connection-factory

Description and usage

Use this Ant task to add a datasource to the specified CMP J2CResAdaptor.

Required parameters

The following parameters are required:

• authDataAlias: The AuthAlias used this binding procedure. The scope is instance.
• datasourcename: Name of the data source. The scope is instance.

• j2cresourceadaptorname: The J2C Resource Adaptor name. The scope is instance.

• jdbcprovidername: Name of the JDBC provider which identifies this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• containerauthalias: Authorization alias for container. The scope is instance.

• containermappingalias: Map alias for container. The scope is instance.
• description: A description of the datasource. The scope is instance.

• forceScope: Set to true if do not want to scope to the existing cluster. The scope is instance.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

• usecontainer: Use the container. The value must be set to true or false. The scope is instance.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

customproperty - used to create a custom property under this datasource.

• name: The name of the custom property.

• value: The value of the custom property.

connectionpool - used to set the connection pool properties for this datasource.

• name: The name of the connection pool.

• value: The value of the connection pool.

relationalresourceadapter - used to set the Relational Resource Adapter properties for this datasource.

• name: The name of the relational resource adapter.

• value: The value of the relational resource adapter.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.CMPConnectionFactoryCreateImpl class implements this task.

wplc-remove-cmp-connection-factory

Description and usage

Use this Ant task to remove a datasource to the specified CMP J2CResAdaptor.

Required parameters

The following parameters are required:

• containermappingalias: The mapping alias for the container.
• datasourcename: Name of the data source. The scope is instance.

• j2cresourceadaptorname: The J2C Resource Adaptor name. The scope is instance.

• jdbcprovidername: Name of the JDBC provider which identifies this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• containerauthalias: Authorization alias for container. The scope is instance.

• containermappingalias: Map alias for container. The scope is instance.
• description: A description of the datasource. The scope is instance.

• forceScope: Set to true if do not want to scope to cluster, if exists. The scope is instance.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

• usecontainer: Use the container. The value must be set to true or false. The scope is instance.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

customproperty - used to create a custom property under this datasource.

• name: The name of the custom property.

• value: The value of the custom property.

connectionpool - used to set the connection pool properties for this datasource.

• name: The name of the connection pool.

• value: The value of the connection pool.

relationalresourceadapter - used to set the Relational Resource Adapter properties for this datasource.

• name: The name of the relational resource adapter.

• value: The value of the relational resource adapter.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.CMPConnectionFactoryRemoveImpl class implements this task.

wplc-create-datasource

Description and usage

Use this Ant task to create a datasource at the target scope.

Required parameters

The following parameters are required:

• datasourcename: Name of the data source. The scope is instance.

• jdbcprovidername: Name of the JDBC provider which identifies this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.

• containerauthalias: Authorization alias for container. The scope is instance.

• containermappingalias: Map alias for container. The scope is instance.

• DbDriverType: Driver type for this datasource. Can be the type 2 or type 4 driver for this database. The scope is instance.

• DbType: The database type for this datasource. Use this to specify db2, oracle, sqlserver, db2 for zOS, etc database types. The scope is instance.

• DbUrl: The database URL this datasource should use to connect to the database. The database name should appear in this URL. The scope is instance.
• description: A description of the datasource. The scope is instance.

• forceScope: Set to true if do not want to scope to existing cluster. The scope is instance.

• isPortalDatasource: Specifies whether or not this is a Portal datasource domain. Portal datasource domains are governed by special rules for config-split and database domain function in Portal. If the datasource is not governed by these rules, this should be specified false as the default for this property is true. The scope is instance.
• node: Node of the resource action. The scope is global.

• portalDomain: Required only for WebSphere Portal domain based datasources. This setting tells the name of the domain of the datasource. The scope is instance.

• server: Server of the resource action. The scope is global.

• templatename: Name of the WebSphere template to follow when creating the data source. The scope is instance.

• usecontainer: Use the container. The value must be set to true or false. The scope is instance.

• useXA: Whether this datasource should use XA connections or not. The value must be set to true or false. The scope is instance.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

customproperty - used to create a custom property under this datasource.

• name: The name of the custom property.

• value: The value of the custom property.

connectionpool - used to set the connection pool properties for this datasource.

• name: The name of the connection pool.

• value: The value of the connection pool.

relationalresourceadapter - used to set the Relational Resource Adapter properties for this datasource.

• name: The name of the relational resource adapter.

• value: The value of the relational resource adapter.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.DataSourceCreateImpl class implements this task.

wplc-modify-datasource

Description and usage

Use this Ant task to modify a datasource at the target scope.

Required parameters

The following parameters are required:

• datasourcename: Name of the data source. The scope is instance.

• jdbcprovidername: Name of the JDBC provider which identifies this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.

• containerauthalias: Authorization alias for container. The scope is instance.

• containermappingalias: Map alias for container. The scope is instance.
• description: A description of the datasource. The scope is instance.

• forceScope: Set to true if do not want to scope to existing cluster. The scope is instance.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

• usecontainer: Use the container. The value must be set to true or false. The scope is instance.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

customproperty - used to create a custom property under this datasource.

• name: The name of the custom property.

• value: The value of the custom property.

connectionpool - used to set the connection pool properties for this datasource.

• name: The name of the connection pool.

• value: The value of the connection pool.

relationalresourceadapter - used to set the Relational Resource Adapter properties for this datasource.

• name: The name of the relational resource adapter.

• value: The value of the relational resource adapter.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.DataSourceModifyImpl class implements this task.

wplc-remove-datasource

Description and usage

Use this Ant task to remove a datasource at the target scope.

Required parameters

The following parameters are required:

• datasourcename: Name of the data source. The scope is instance.

• jdbcprovidername: Name of the JDBC provider which identifies this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.

• forceScope: Set to true if do not want to scope to existing cluster. The scope is instance.
• node: Node of the resource action. The scope is global.

• portalDomain: Required only for WebSphere Portal domain based datasources. This setting tells the name of the domain of the datasource. The scope is instance.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.DataSourceRemoveImpl class implements this task.

wplc-create-host-alias

Description and usage

Use this Ant task to create the specified Host Alias.

Required parameters

The following parameters are required:

• host: The host name for the host alias. The scope is instance.

• port: The port number for this host alias. The scope is instance.

• virtualHostName: The virtual host name to use for this host alias. The scope is instance.

Optional parameters

The following parameter is optional:

• cell: The cell scope of resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.HostAliasCreateImpl class implements this task.

wplc-remove-host-alias

Description and usage

Use this Ant task to remove the specified Host Alias.

Required parameters

The following parameters are required:

• host: The host name for the host alias. The scope is instance.

• port: The port number for this host alias. The scope is instance.

• virtualHostName: The virtual host name to use for this host alias. The scope is instance.

Optional parameters

The following parameter is optional:

• cell: The cell scope of resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.HostAliasRemoveImpl class implements this task.

wplc-create-j2c-auth

Description and usage

Use this Ant task to create an entry in the security table of the target cell. This entry can be used as a user-password pair for your configuration.

Required parameters

The following parameters are required:

• alias: The alias used to identify this authentication data. The scope is instance.
• password: The password associated with this user ID.

• user: The user name used to create a connection using this authentication data.

Optional parameters

The following parameters are optional:

• cell: The name of the cell where this J2C authentication data is created, removed, or modified. The scope is global.
• description: A description of what this authentication data is used for and what it connects to. The scope is instance.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.J2CAuthCreateImpl class implements this task.

wplc-modify-j2c-auth

Description and usage

Use this Ant task to modify an entry in the security table of the target cell. This entry can be used as a user-password pair for your configuration.

Required parameters

The following parameters are required:

• alias: The alias used to identify this authentication data. The scope is instance.
• password: The password associated with this user ID.

• user: The user name used to create a connection using this authentication data.

Optional parameters

The following parameters are optional:

• cell: The name of the cell where this J2C authentication data is created, removed, or modified. The scope is global.
• description: A description of what this authentication data is used for and what it connects to. The scope is instance.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.J2CAuthModifyImpl class implements this task.

wplc-remove-j2c-auth

Description and usage

Use this Ant task to remove an entry in the security table of the target cell.

Required parameters

The following parameter is required:

• alias: The alias used to identify this authentication data. The scope is instance.

Optional parameters

The following parameter is optional:

• cell: The name of the cell where this J2C authentication data is created, removed, or modified. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.J2CAuthRemoveImpl class implements this task.

wplc-create-jvm-custom-property

Description and usage

Use this Ant task to create or update a custom JVM property in the WAS environment.

Required parameters

The following parameters are required:

• name: The name of the JVM custom property. The scope is instance.

• value: The value of the property to create.

Optional parameters

The following parameters are optional:

• cell: The cell scope of the resource action. The scope is global.
• description: A description of the JVM custom property. The scope is instance.
• node: The node scope of the resource action.

• required: The Boolean value used to tell WebSphere if this property is required or not.

• server: The server scope of the resource action.

• zosProcessDefType: z/OS only: Used to tell which region this property should be created for: Servant, Control, or Abjunct. The value defaults to Servant.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.JVMCustomPropertyCreateImpl class implements this task.

wplc-remove-jvm-custom-property

Description and usage

Use this Ant task to remove a custom JVM property in the WAS environment.

Required parameters

The following parameters are required:

• name: The name of the JVM custom property. The scope is instance.

• value: The value of the property to create.

Optional parameters

The following parameters are optional:

• cell: The cell scope of the resource action. The scope is global.
• node: The node scope of the resource action.

• server: The server scope of the resource action.

• zosProcessDefType: z/OS only: Used to tell which region this property should be removed from: Servant, Control, or Abjunct. The value defaults to Servant.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.JVMCustomPropertyRemoveImpl class implements this task.

wplc-create-jdbc-provider

Description and usage

Use this Ant task to create a JDBC provider resource on the target scope.

Required parameters

The following parameter is required:

• jdbcprovidername: The name of the JDBC provider that identities this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.

• DbDriverType: Driver type for this JDBC Provider. Can be the type 2 or type 4 driver for this database. The scope is instance.

• DbType: The database type for this JDBC Provider. Use this to specify db2, oracle, sqlserver, db2 for zOS, etc database types. The scope is instance.

• DbUrl: The database URL this JDBC Provider should use to connect to the database. The database name should appear in this URL. The scope is instance.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.

• implementationClassName: The class name used to create this JDBC Provider. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

• templatename: Name of the template to follow when creating the JDBC Provider. The scope is instance.

• useXA: Whether this JDBC Provider should use XA connections or not. Set to true or false. The scope is instance.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.JDBCProviderCreateImpl class implements this task.

wplc-modify-jdbc-provider

Description and usage

Use this Ant task to create a JDBC provider resource on the target scope.

Required parameters

The following parameter is required:

• jdbcprovidername: The name of the JDBC provider that identities this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.JDBCProviderModifyImpl class implements this task.

wplc-remove-jdbc-provider

Description and usage

Use this Ant task to remove a JDBC provider resource on the target scope.

Required parameters

The following parameter is required:

• jdbcprovidername: The name of the JDBC provider that identities this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell scope of resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.JDBCProviderRemoveImpl class implements this task.

wplc-create-library

Description and usage

Use this Ant task to create or modify the specified library.

Required parameters

The following parameter is required:

• name: The name of the library. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.

• classpath: Tells what classpath entries to add. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.LibraryCreateImpl class implements this task.

wplc-remove-library

Description and usage

Use this Ant task to remove the specified library.

Required parameters

The following parameter is required:

• name: The name of the library. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.LibraryRemoveImpl class implements this task.

wplc-create-res-env-custom-property

Description and usage

Use this Ant task to create or reassign a Resource Environment Provider custom property.

Required parameters

The following parameters are required:

• name: The name of the resource to create, update, or modify. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

• value: The value of the custom property. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• description: The description of the custom property. The scope is instance.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• required: The Boolean value to specify if this property is required or not. The scope is instance.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCustomPropertyCreateImpl class implements this task.

wplc-retrieve-res-env-custom-property

Description and usage

Use this Ant task to return the value of a Resource Environment Provider custom property.

Required parameters

The following parameters are required:

• name: The name of the resource to create, update, or modify. The scope is instance.

• propToSet: The property set in the Ant project with the value retrieved from this property. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCustomPropertyRetreiveImpl class implements this task.

wplc-remove-res-env-custom-property

Description and usage

Use this Ant task to remove a Resource Environment Provider custom property.

Required parameters

The following parameters are required:

• name: The name of the resource to create, update, or modify. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCustomPropertyRemoveImpl class implements this task.

wplc-create-res-env-entry

Description and usage

Use this Ant task to create or modify a resource environment entry.

Required parameters

The following parameters are required:

• jndiName: The JNDI name. The scope is instance.

• name: The name of the resource to create, update, or modify. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

• referenceable.Class: The class of the resource environment provider. The scope is instance.

• referenceable.FactoryClass: The factory class of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• category: The name of the category. The scope is instance.

• cell: The cell of the resource action. The scope is global.
• description: The description of the resource action. The scope is instance.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryCreateImpl class implements this task.

wplc-remove-res-env-entry

Description and usage

Use this Ant task to remove a resource environment entry.

Required parameters

The following parameters are required:

• name: The name of the resource to create, update, or modify. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryRemoveImpl class implements this task.

wplc-create-res-env-entry-custom-property

Description and usage

Use this Ant task to create or reassign a custom SSL property in WAS security.

Required parameters

The following parameters are required:

• entryName: The name of the resource entry to update. The scope is instance.

• name: The name of the resource to create, update, or modify. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

• value: The value of the custom property. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• description: The description of the custom property. The scope is instance.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• required: The Boolean value to specify if this property is required or not. The scope is instance.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryCustomPropertyCreateImpl class implements this task.

wplc-remove-res-env-entry-custom-property

Description and usage

Use this Ant task to remove a custom SSL property in WAS security.

Required parameters

The following parameters are required:

• entryName: The name of the resource entry to update. The scope is instance.

• name: The name of the resource to create, update, or modify. The scope is instance.

• providerName: The name of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryCustomPropertyRemoveImpl class implements this task.

wplc-create-resource-env-provider

Description and usage

Use this Ant task to create a resource environment provider at the specified scope.

Required parameters

The following parameter is required:

• name: The name of the resource to create, update, or modify. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• description: The description of the custom property. The scope is instance.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCreateImpl class implements this task.

wplc-remove-resource-env-provider

Description and usage

Use this Ant task to remove a resource environment provider at the specified scope and with the specified name.

Required parameters

The following parameter is required:

• name: The name of the resource to create, update, or modify. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderRemoveImpl class implements this task.

wplc-create-res-referenceable

Description and usage

Use this Ant task to create or modify a resource entry we can reference.

Required parameters

The following parameters are required:

• providerName: The name of the resource environment provider. The scope is instance.

• referenceable.Class: The reference class of the resource environment provider. The scope is instance.

• referenceable.FactoryClass: The reference factory class of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to cluster, if exists. The scope is instance.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceReferenceableCreateImpl class implements this task.

wplc-remove-res-referenceable

Description and usage

Use this Ant task to remove a resource entry we can reference.

Required parameters

The following parameters are required:

• providerName: The name of the resource environment provider. The scope is instance.

• referenceable.Class: The reference class of the resource environment provider. The scope is instance.

• referenceable.FactoryClass: The reference factory class of the resource environment provider. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ResourceReferenceableRemoveImpl class implements this task.

wplc-create-variable

Description and usage

Use this Ant task to create or reassign a WAS environment variable and value.

Required parameters

The following parameters are required:

• name: The name of the variable. The scope is instance.

• value: The value assigned to the variable. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• description: The description of the variable.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.VariableCreateImpl class implements this task.

wplc-remove-variable

Description and usage

Use this Ant task to remove a WAS environment variable and value.

Required parameters

The following parameter is required:

• name: The name of the variable. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.VariableRemoveImpl class implements this task.

wplc-retrieve-variable

Description and usage

Use this Ant task to retrieve a WAS environment variable and value.

Required parameters

The following parameter is required:

• name: The name of the variable. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: The cell of the resource action. The scope is global.
• node: The node of the resource action. The scope is global.

• server: The server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.VariableRetrieveImpl class implements this task.

wplc-create-res-env-directory

Description and usage

Use this Ant task to create RP file names in the directory.

Required parameters

The following parameter is required:

• rpPropertyDirectoryName: The property directory name. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to an existing cluster. The scope is instance.
• node: Node of the resource action. The scope is global.

• rpPrefix: The name of the prefix. The scope is instance.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.REProviderCreateByDirectoryImpl class implements this task.

wplc-cluster-sync-all-node

Description and usage

Use this Ant task to sync all nodes in the cluster.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ClusterSyncAllNodesImpl class implements this task.

wplc-cluster-sync-single-node

Description and usage

Use this Ant task to sync a single cluster node.

Required parameters

The following parameter is required:

• syncNode: The name of the node to sync. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ClusterSyncSingleNodeImpl class implements this task.

wplc-extract-ear-local-or-remote

Description and usage

Use this Ant task to extract ear files locally or remotely.

Required parameters

The following parameters are required:

• appName: The application name for the ear file. The scope is instance.

• earFile: The local directory and file where the ear file is exported to. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ExtractEarLocalOrRemoteImpl class implements this task.

wplc-query-application-list

Description and usage

Use this Ant task to query a list of applications installed in the cell and to return a comma delimited string. The application list is placed in an ANT property called ${filteredAppList}.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.
• filter: The filter used for the application query; for example: PA_.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ApplicationsQueryImpl class implements this task.

wplc-retrieve-datasource-custom-property

Description and usage

Use this Ant task to retrieve a value from the datasource custom properties.

Required parameters

The following parameters are required:

• datasourcename: Name of the data source. The scope is instance.

• jdbcprovidername: Name of the JDBC provider which identifies this resource. The scope is instance.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• forceScope: Set to true if do not want to scope to the existing cluster. The scope is instance.
• node: Node of the resource action. The scope is global.

• propertyName: The name of the custom property to retrieve the value from. The scope is instance.

• propToSet: The property set in the Ant project with the value retrieved from WAS. The scope is instance.

• server: Server of the resource action. The scope is global.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.DataSourceRetrieveCustomPropertyValue class implements this task.

wplc-wait-for-sync-to-complete

Description and usage

Use this Ant task to wait for the ear expansion and distribution to complete.

Optional parameters

The following parameters are optional:

• cell: Cell of the resource action. The scope is global.

• maxAppTimeToWait: The maximum time in minutes to wait for each application expansion process to complete.

• maxTimeToWait: The maximum time in minutes to wait for the expansion process to complete.
• node: Node of the resource action. The scope is global.

• server: Server of the resource action. The scope is global.

• waitTime: The time to wait between checks for the application to deploy.

Implementation bean

The com.ibm.wplc.deploy.tasks.impl.ClusterWaitForSyncToCompleteImpl class implements this task.

wplc-create-ear

Description and usage

Use this Ant task to deploy an EAR resource to the target Application or portal server.

Required parameters

The following parameters are required:

• appname: The name of the application for the given EAR file.

• earfile: The location of the EAR file to deploy.

Optional parameters

The following parameters are optional:

• cluster: Defines the cluster name. This value should not include spaces. If not set, the value defaults to the context defined in the EAR file's application.xml file.

• classloadermode: Sets the class-loader delegation mode, also known as the class loader order. This value determines whether a class loader delegates the loading of classes to the parent class loader. The following values are supported:

  • PARENT_FIRST: Causes the class loader to delegate the loading of classes to its parent class loader before attempting to load the class from its local class path. This value is the default for the class-loader policy and for standard JVM class loaders.

  • PARENT_LAST: Causes the class loader to attempt to load classes from its local class path before delegating the class loading to its parent. Using this policy, an application class loader can override and provide its own version of a class that exists in the parent class loader.

• startingweight: Sets the starting weight for the application. The starting weight specifies the order in which applications are started when the server starts. The application with the lowest starting weight is started first.

• server: The name of the application server for WebSphere Portal.
• node: The name of the WAS node.

• cell: The name of the WAS cell.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task. Used to pass any attribute associated with the resource action.

• name: The name of the attribute.

• value: The value of the attribute.

option - Not all available EAR deployment options are supported by the wplc-create-ear syntax as attributes. The option element passes additional information to the underlying framework inside the WsAdmin profile. This feature is similar to how other parameters are passed into the WsAdmin script file. However, in this situation, the full set of options are assembled into a string corresponding to the syntax of the scripting language.

Parameters that are included as attributes on the task should not be coded as options. Use the corresponding attribute to avoid redundancy and to prevent runtime exception during the task parsing.

The syntax of the nested option element allows for the following three formats: keyword only, keyword/value pairing, or keyword with value list.

• key: The name of the option

• value: The value of the option. If no value attribute is present and the option does not contain one or more nested value elements, then it is assumes that this key does not take a value.

If a keyword can take a list of values, then a single nested value element is used for each value in the list.

pairing, or keyword with value list formats. . This table describes how to use the keyword only, keyword/value pairing, or keyword

Parameter type	Example (using AdminApp syntax)	Option element syntax
Keyword only	-nodeployejb	<option key="nodeployejb"/>
Keyword with simple value	-custom value	<option key="custom" value="value"/>
Keyword with list of values	-MapresrefToEJB {{value1} {value2} {value3}}	<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>

Implementation bean

The com.ibm.wplc.deploy.tasks.EarCreate class implements this task.

wplc-edit-ear

Description and usage

Use this Ant task to edit the attributes of the target application.

Required parameters

The following parameter is required:

• appname: The name of the application for the given EAR file.

Parameters specified as nested Elements

option - Not all available EAR deployment options are supported by the wplc-create-ear syntax as attributes. The option element passes additional information to the underlying framework inside the WsAdmin profile. This feature is similar to how other parameters are passed into the WsAdmin script file. However, in this situation, the full set of options are assembled into a string corresponding to the syntax of the scripting language.

Parameters that are included as attributes on the task should not be coded as options. Use the corresponding attribute to avoid redundancy and to prevent runtime exception during the task parsing.

The syntax of the nested option element allows for the following three formats: keyword only, keyword/value pairing, or keyword with value list.

• key: The name of the option

• value: The value of the option. If no value attribute is present and the option does not contain one or more nested value elements, then it is assumes that this key does not take a value.

If a keyword can take a list of values, then a single nested value element is used for each value in the list.

pairing, or keyword with value list formats. . This table describes how to use the keyword only, keyword/value pairing, or keyword

Parameter type	Example (using AdminApp syntax)	Option element syntax
Keyword only	-nodeployejb	<option key="nodeployejb"/>
Keyword with simple value	-custom value	<option key="custom" value="value"/>
Keyword with list of values	-MapresrefToEJB {{value1} {value2} {value3}}	<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>

Implementation bean

The com.ibm.wplc.deploy.tasks.EarEdit class implements this task.

wplc-update-ear

Description and usage

Use this Ant task to update an existing deployed EAR file with a new or modified version.

Required parameters

The following parameters are required:

• appname: The name of the application for the given EAR file.

• earfile: The location of the EAR file to deploy.

Optional parameters

The following parameters are optional:

• classloadermode: Sets the class-loader delegation mode, also known as the class loader order. This value determines whether a class loader delegates the loading of classes to the parent class loader. The following values are supported:

  • PARENT_FIRST: Causes the class loader to delegate the loading of classes to its parent class loader before attempting to load the class from its local class path. This value is the default for the class-loader policy and for standard JVM class loaders.

  • PARENT_LAST: Causes the class loader to attempt to load classes from its local class path before delegating the class loading to its parent. Using this policy, an application class loader can override and provide its own version of a class that exists in the parent class loader.

• startingweight: Sets the starting weight for the application. The starting weight specifies the order in which applications are started when the server starts. The application with the lowest starting weight is started first.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task. Used to pass any attribute associated with the resource action.

• name: The name of the attribute.

• value: The value of the attribute.

option - Not all available EAR deployment options are supported by the wplc-create-ear syntax as attributes. The option element passes additional information to the underlying framework inside the WsAdmin profile. This feature is similar to how other parameters are passed into the WsAdmin script file. However, in this situation, the full set of options are assembled into a string corresponding to the syntax of the scripting language.

Parameters that are included as attributes on the task should not be coded as options. Use the corresponding attribute to avoid redundancy and to prevent runtime exception during the task parsing.

The syntax of the nested option element allows for the following three formats: keyword only, keyword/value pairing, or keyword with value list.

• key: The name of the option

• value: The value of the option. If no value attribute is present and the option does not contain one or more nested value elements, then it is assumes that this key does not take a value.

If a keyword can take a list of values, then a single nested value element is used for each value in the list.

pairing, or keyword with value list formats. . This table describes how to use the keyword only, keyword/value pairing, or keyword

Parameter type	Example (using AdminApp syntax)	Option element syntax
Keyword only	-nodeployejb	<option key="nodeployejb"/>
Keyword with simple value	-custom value	<option key="custom" value="value"/>
Keyword with list of values	-MapresrefToEJB {{value1} {value2} {value3}}	<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>

Implementation bean

The com.ibm.wplc.deploy.tasks.EarUpdate class implements this task.

wplc-modify-ear

Description and usage

Use this Ant task to modify a previously deployed EAR resource to the target application or Portal server instance.

Required parameters

The following parameters are required:

• appname: The name of the application for the given EAR file.

Optional parameters

The following parameters are optional:

• classloadermode: Sets the class-loader delegation mode, also known as the class loader order. Whether a class loader delegates the loading classes to the parent class loader. The following values are supported:

  • PARENT_FIRST: Causes the class loader to delegate the loading of classes to its parent class loader before attempting to load the class from its local class path. This value is the default for the class-loader policy and for standard JVM class loaders.

  • PARENT_LAST: Causes the class loader to attempt to load classes from its local class path before delegating the class loading to its parent. Using this policy, an application class loader can override and provide its own version of a class that exists in the parent class loader.

• startingweight: Set the starting weight for the application. The starting weight specifies the order in which applications are started when the server starts. The application with the lowest starting weight is started first.

• server: The name of the WebSphere Portal server.
• node: The name of the WAS node.

• cell: The name of the WAS cell.

Parameters specified as nested Elements

attribute - a generic attribute for this resource. Users can use this attribute to specify any additional name-value pairs that are not already covered by the wplc task.

• name: The name of the attribute.

• value: The value of the attribute.

option - Not all available EAR deployment options are supported by the wplc-create-ear syntax as attributes. The option element passes additional information to the underlying framework inside the WsAdmin profile. This feature is similar to how other parameters are passed into the WsAdmin script file. However, in this situation, the full set of options are assembled into a string corresponding to the syntax of the scripting language.

Parameters that are included as attributes on the task should not be coded as options. Use the corresponding attribute to avoid redundancy and to prevent runtime exception during the task parsing.

The syntax of the nested option element allows for the following three formats: keyword only, keyword/value pairing, or keyword with value list.

• key: The name of the option

• value: The value of the option. If no value attribute is present and the option does not contain one or more nested value elements, then it is assumes that this key does not take a value.

If a keyword can take a list of values, then a single nested value element is used for each value in the list.

pairing, or keyword with value list formats. . This table describes how to use the keyword only, keyword/value pairing, or keyword

Parameter type	Example (using AdminApp syntax)	Option element syntax
Keyword only	-nodeployejb	<option key="nodeployejb"/>
Keyword with simple value	-custom value	<option key="custom" value="value"/>
Keyword with list of values	-MapresrefToEJB {{value1} {value2} {value3}}	<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>

Implementation bean

The com.ibm.wplc.deploy.tasks.EarModify class implements this task.

wplc-update-file-in-ear

Description and usage

Use this Ant task to update a file in the deployed ear.

Required parameters

The following parameters are required:

• appname: The name of the application for the given EAR file.

• classloadermode: Sets the class-loader delegation mode, also known as the class loader order. This value determines whether a class loader delegates the loading of classes to the parent class loader. The following values are supported:

  • PARENT_FIRST: Causes the class loader to delegate the loading of classes to its parent class loader before attempting to load the class from its local class path. This value is the default for the class-loader policy and for standard JVM class loaders.

  • PARENT_LAST: Causes the class loader to attempt to load classes from its local class path before delegating the class loading to its parent. Using this policy, an application class loader can override and provide its own version of a class that exists in the parent class loader.

  • startingweight: Sets the starting weight for the application. The starting weight specifies the order in which applications are started when the server starts. The application with the lowest starting weight is started first.

Parameters specified as nested Elements

option - Not all available EAR deployment options are supported by the wplc-create-ear syntax as attributes. The option element passes additional information to the underlying framework inside the WsAdmin profile. This feature is similar to how other parameters are passed into the WsAdmin script file. However, in this situation, the full set of options are assembled into a string corresponding to the syntax of the scripting language.

Parameterm that are included as attributes on the task should not be coded as options. Use the corresponding attribute to avoid redundancy and to prevent runtime exception during the task parsing.

The syntax of the nested option element allows for the following three formats: keyword only, keyword/value pairing, or keyword with value list.

• key: The name of the option

• value: The value of the option. If no value attribute is present and the option does not contain one or more nested value elements, then it is assumes that this key does not take a value.

If a keyword can take a list of values, then a single nested value element is used for each value in the list.

Add the following two <option> keys:

• An option element with a key of contents points to the location on disk of the file to update option key="contents" value="locationOfFileOnDisk"/>.

• An option element with a key of contenturi points to the location inside of an .ear file of the file to update option key="contenturi" value="locationOfFileInEar"/>

Implementation bean

The com.ibm.wplc.deploy.tasks.EarCreate class implements this task.

wplc-remove-ear

Description and usage

Use this Ant task to remove or uninstall an EAR resource from the target application or Portal server instance.

Required parameters

The following parameter is required:

• appname: The name of the application for the given EAR file.

Implementation bean

The com.ibm.wplc.deploy.tasks.EarRemove class implements this task.

Parent: Develop advanced solution applications