2.20.3 create-connector-resource

Synopsis

asadmin [asadmin-options] create-connector-resource [--help]
    --poolname connectorConnectionPoolName [--enabled={true|false}]
    [--description description] [--objecttype objecttype]
    [--target target] jndi_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-connector-resource subcommand registers the connector resource with the specified JNDI name.

This command is supported in remote mode only.

Precondition

DAS has to be in a running state.

Arguments

--help | -?

Displays the help text for the subcommand.

--poolname connectorConnectionPoolName

Specifies the name of the connection pool.

Type: String

The following values can be specified:

• Specify the name of the connection pool

Default value: N/A

--enabled={true|false}

Specifies whether the resource is enabled at runtime.

Type: Boolean

The following values can be specified:

• true

• false

Default value: true

--objecttype objecttype

Defines the type of connector resource.

Type: String

The following values can be specified:

• system-all

  A system resource for all server instances and the Domain Administration Server (DAS).

• system-admin

  A system resource only for the DAS.

• system-instance

  A system resource for all server instances only.

• user

  A user resource.

Default value: user

--description description

Displays the text providing details about the connector resource.

Type: String

The following values can be specified:

• Description in text

Default value: N/A

--target target

Specifies the ending location of the connector resources.

The resource is always created for the domain as a whole, but the resource-ref for the resource is only created for the specified --target. This means that although the resource is defined at the domain level, it is only available at the specified target level. Use the create-resource-ref subcommand to refer to the resource in multiple targets if required.

Type: String

The following values can be specified:

• server

  Creates the connector resource in the default server instance. This is the default value.

• domain

  Creates the connector resource in the domain.

• cluster_name

  Creates the connector resource in every server instance in the cluster.

• instance_name

  Creates the connector resource in the specified server instance.

Default value: server

jndi_name

Specifies the JNDI name of this connector resource.

Type: String

The following values can be specified:

• JNDI name

Default value: N/A

asadmin create-connector-resource  --target instance1 --poolname jms/qConnPool
--description "sample connector resource" jms/qConnFactory

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.