appclient(1M)						    Application Server Utility						     appclient(1M)

NAME

       appclient  - launches the Application Client Container and invokes the client application packaged in the application JAR file

SYNOPSIS

       appclient  -client  client_application_jar [-mainclass client_application_main_classname|-name display_name] [-xml sun-acc.xml file] [-tex-
       tauth] [-user username] [-password password]

       Use the appclient command to launch the application client container and invoke a client application that is packaged in an application JAR
       file.  The  application	client jar file is psecified and created during deployment either by the deploytool or by using the asadmin deploy
       command.

       The application client container is a set of java classes, libraries and other files that are required to execute a first-tier  application
       client program on a Java Virtual Machine (JVM). The application client container communicates with the Application Server using RMI-IIOP.

       The  client.jar	that  is  retrieved  after deploying an application , should be passed with the -client option while running the appclient
       utility. The -mainclass and -name options are optional for a single client application. For multiple client  applications  use  either  the
       -classname option or the- name option.

       -client		       required;  the  name and location for the client application jar file. The application client JAR file is specified
			       and created during deployment, either by the deploytool or by the asadmin deploy command.

       -mainclass	       optional; the full classname of the main client application main() method that will be invoked by  the  Application
			       Client Container. Used for a single client application. By default, uses the class specified in the client jar. The
			       class name must be the full name. For example, com.sun.test.AppClient

       -name		       optional; the display name for the client application. Used for multiple client applications. By default, the  dis-
			       play  name  is  specified  in  the  client  jar application-client.xml file which is identified by the display-name
			       attribute.

       -xml		       optional if using the default domain and instance, otherwise it is required; identifies the name  and  location	of
			       the  client  configuration  XML	file.  If  not	specified,  defaults  to the value of $AS_ACC_CONFIG identified in
			       asenv.conf file.

       -textauth	       optional; used to specify using text format authentication when authentication is needed.

       Example 1: Using the appclient command

       appclient -client appserv/bin/myclientapp.jar
       -mainclass com.sun.test.TestAppClient -xml sun-acc.xml scott sample

       Where: appserv/bin/myclientapp.jar is the full path for the client application .jar file, com.sun.text.TestAppClient is the full Java pack-
       age  name  of  the  main  client application, scott and sample are arguments to pass to the application, and sun-acc.xml is the name of the
       client configuration XML file. If sun-acc.xml is not in the current directory, you must give the absolute path location; otherwise the rel-
       ative path is used.  The relative path is relative to the directory where the command is being executed.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Unstable			   |
       +-----------------------------+-----------------------------+

       package-appclient(1M), asadmin(1M)

Sun Java System Application Server				    March 2004							     appclient(1M)