asadmin-create-connector-security-map(1AS)			   User Commands			asadmin-create-connector-security-map(1AS)

NAME

       asadmin-create-connector-security-map, create-connector-security-map - creates a security map for the named connector connection pool

SYNOPSIS

       create-connector-security-map  --user admin_user [--password admin_password] [--host localhost] [--port 4848] [--secure|-s] [--passwordfile
       filename] [--terse=false] [--echo=false] [--interactive=true] --poolname connector_connection_pool_name --principals principal-name[, prin-
       cipal-name]*|--usergroups user-group[, user-group]* --mappedusername user_name [--mappedpassword password] mapname

       Creates	a  security  map  for the named connector connection pool. If the security map is not present, one is created. You must have first
       created a connector connection pool using the create-connector-connection-pool command. The enterprise information  system  is  any  system
       which holds the information. It can be a mainframe, a messaging system, a database system, or even an application.

       The --principals option and --usergroups option are mutually exclusive; only one should be used.

       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.

       --poolname	       connector connection pool name.

       --principals	       a comma separated list of J2EE principals.

       --usergroups	       a comma separated list of J2EE usergroups.

       --mappedusername        the enterprise information system username.

       --mappedpassword        the enterprise information system password.

OPERANDS

       mapname		       name of the security map to be created.

       Example 1: Using create-connector-security-map

       It is assumed that the connector pool has already been created using the create-connector-pool command.

       asadmin> create-connector-security-map --user admin --password adminadmin
       poolname connector-pool1 --principals principal1,principal2
       --usergroups usergroup1,usergroup2 --mappedusername backend-username
       --mappedpassword backend-password securityMap1
       Command create-connector-security-map executed successfully

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-delete-connector-security-map(1AS), asadmin-list-connector-security-maps(1), asadmin-update-connector-security-map(1AS)

J2EE 1.4 SDK							    March 2004				asadmin-create-connector-security-map(1AS)