asadmin-create-http-listener(1AS)				   User Commands				 asadmin-create-http-listener(1AS)

NAME

       asadmin-create-http-listener, create-http-listener - adds a new HTTP listener socket

SYNOPSIS

       create-http-listener --user admin_user [--password admin_password] [--host localhost] [--port 4848] [--secure|-s] [--passwordfile filename]
       --listeneraddress address [--terse=false]  [--echo=false]  [--interactive=true]	--listenerport	listener_port  --defaultvs  virtual_server
       --servername server_name [--acceptorthreads acceptor_threads] [--securityenabled=false] [--enabled=true]listener_ID

       Creates the HTTP listener. This command is supported in remote mode only.

OPTIONS

       --user		       authorized domain application server administrative username.

       --password	       password to administer the domain application server.

       --host		       machine name where the domain application server is running.

       --port		       port number of the domain application server listening for administration requests.

       --secure 	       if true, uses SSL/TLS to communicate with the domain application server.

       --passwordfile	       file containing the domain application server password.

       --terse		       indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-
			       formatted data for consumption by a script. Default is false.

       --echo		       setting to true will echo the command line statement on the standard output. Default is false.

       --interactive	       if set to true (default), only the required password options are prompted.

       --listeneraddress       IP address of the listener address.

       --listenerport	       port number to create the listen socket on. Legal values are 1-65535. On UNIX,  creating  sockets  that	listen	on
			       ports 1-1024 requires superuser privileges. Configuring an SSL listen socket to listen on port 443 is recommended.

       --defaultvs	       ID attribute of the default virtual server for this particular connection group.

       --servername	       tells  the  server  what  to put in the host name section of any URLs it sends to the client. This affects URLs the
			       server automatically generates; it doesn't affect the URLs for directories and files stored  in	the  server.  This
			       name  should be the alias name if your server uses an alias. If a colon and port number is appended, that port will
			       be used in URLs that the server sends to the client.

       --acceptorthreads       number of acceptor threads for the listen socket. The recommended value is the number of processors in the machine.

       --securityenabled       determines whether the HTTP listener runs SSL. You can turn SSL2 or SSL3 ON or OFF and set  ciphers  using  an  SSL
			       element.  The  security	setting  globally  enables  or disables SSL by making certificates available to the server
			       instance.

       --enabled	       determines if the resource is enabled at runtime.

OPERANDS

       listener_id	       listener ID of the HTTP listener.

       Example 1: Using create-http-listener

       asadmin> create-http-listener --user admin1 --password adminadmin1
       --host pigeon --port 5001 --listeneraddress 0.0.0.0
       --listenerport 7272 --defaultvs server --servername pigeon.red.iplanet.com
       --acceptorthreads 2 --securityenabled=false --enabled=false sampleListener
       Command create-http-listener executed successfully

       Where: sampleListener is the HTTP listener created.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-delete-http-listener(1AS), asadmin-list-http-listeners(1AS)

J2EE 1.4 SDK							     &release					 asadmin-create-http-listener(1AS)