cjtestres (execute resource connection test)

Organization of this page

Format
Function
Arguments
Input examples
Return values
Notes

Format

For data source and mails

cjtestres [server-name] [-nameserver provider-URL] 
     -type {datasource|mail} 
     -resname display-name [-resname display-name ...]

For the resource adapter to be deployed and used as a J2EE resource adapter

cjtestres [server-name] [-nameserver provider-URL]
     -type rar
     -resname display-name [-resname display-name ...]

For the resource adapter to be included and used in an application

cjtestres [server-name] [-nameserver provider-URL]
     -name application-name -type rar
     -resname display-name [-resname display-name ...]

To Page Top

Function

This command executes a connection test on a J2EE resource adapter, mail, or data source.

If there are multiple connection definitions in a resource adapter, this command performs the connection test for all the connection definitions. The connection test is executed for all the connection definitions, even if an error occurs in one of the connection definitions.

Note that you cannot execute the connection test for Inbound resource adapters.

To Page Top

Arguments

server-name

Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.

-nameserver provider-URL

Specifies the access protocol for the CORBA Naming Service, the name of the host running the CORBA Naming Service, and the port number being used by the host. These items are specified in the following format:

protocol-name: : host-name: port-number

For details on the specification items, see 2.1.2 Provider URL.

-name application-name

Specifies the application name when performing the connection test for the resource adapters contained in the application.

-type {datasource|mail|rar}

Specifies the type of resource for which a connection test is to be executed:

datasource: Data source file
mail: Mail
rar: RAR file

-resname display-name

Specifies the display name of the data source file, mail, or RAR file for which a connection test is to be executed. This option can be specified multiple times.

To Page Top

Input examples

For a data source

cjtestres -type datasource -resname Myds1

For mail

cjtestres -type mail -resname Mymail1

For the resource adapter to be deployed and used as a J2EE resource adapter

cjtestres -type rar -resname Myrar1

For the resource adapter to be included and used in an application

cjtestres -name App1 -type rar -resname Myrar1

To Page Top

Return values

0:: The command terminated normally.
1:: The command terminated abnormally.
2:: The command could not be executed because of an exclusion error.
3:: A timeout occurred.
9:: The command could not be executed because there are no administrator privileges (in Windows).

To Page Top

Notes

When you specify a server name in the command arguments, you must specify it immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (for example, you cannot specify display-name -resname); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver display-name -resname provider-URL).
When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).

To Page Top