<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="create-connector-security-map-1">
<refmeta><refentrytitle>create-connector-security-map</refentrytitle><manvolnum>
1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="creates or modifies a security map for the specified connector connection pool">
creates a security map for the specified connector connection pool &mdash;
create-connector-security-map</primary></indexterm><indexterm><primary sortas="template">
create-connector-security-map</primary></indexterm><refname>create-connector-security-map
</refname><refpurpose>creates a security map for the specified connector connection
pool</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-connector-security-map</command>&synopsis-common;
<arg choice="plain">&Dash;&Dash;poolname <replaceable>connector_connection_pool_name
</replaceable></arg><arg>&Dash;&Dash;principals <replaceable>principal_name1
</replaceable><option role="nodash"><optional>, <replaceable>principal_name2
</replaceable></optional>* </option>| <?Pub _newline>&Dash;&Dash;usergroups <replaceable>
user_group1</replaceable><option role="nodash"><optional>, <replaceable>user_group2
</replaceable></optional>*</option></arg><arg choice="plain">&Dash;&Dash;mappedusername  <replaceable>
username </replaceable></arg><arg choice="req"><replaceable>security_map_name
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Use this command to create a security map for the specified connector
connection pool. If the security map is not present, a new one is created.
Also, use this command to map the caller identity of the application (principal
or user group) to a suitable EIS principal in container-managed transaction-based
scenarios. One or more named security maps may be associated with a connector
connection pool. The connector security map configuration supports the use
of the wild card asterisk (*) to indicate all users or all user groups.</para>
<para>For this command to succeed, you must have first created a connector
connection pool using the <command>create-connector-connection-pool</command>
command. </para>
<para>The enterprise information system (EIS) is any system that holds the
data of an organization. It can be a mainfr<?Pub Caret>ame, a messaging system,
a database system, or an application.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>This option is deprecated in this release.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;poolname</option></term>
<listitem><para>Specifies the name of the connector connection pool to which
the security map belongs.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;principals</option></term>
<listitem><para>Specifies a list of backend EIS principals. More than one
principal can be specified using a comma separated list. Use either the <option
role="nodash">&Dash;&Dash;principals</option> or <option role="nodash">&Dash;&Dash;usergroups
</option> options, but not both.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;usergroups</option></term>
<listitem><para>Specifies a list of backend EIS user group. More than one
usergroups can be specified using a comma separated list. </para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;mappedusername</option></term>
<listitem><para> This property specifies the EIS username.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>security_map_name</replaceable></term><listitem>
<para> name of the security map to be created or updated.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using <command>create-connector-security-map</command> command</title>
<para>It is assumed that the connector pool has already been created using
the <command>create-connector-pool</command> command.</para>
<screen>asadmin> <userinput>create-connector-security-map --user admin 
--passwordfile pwd_file.txt --poolname connector-pool1 --principals principal1, principal2 --mappedusername backend-username securityMap1
</userinput>
Command create-connector-security-map executed successfully</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para> command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para> error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="delete-connector-security-map-1"><citerefentry><refentrytitle>
delete-connector-security-map</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-connector-security-maps-1"><citerefentry><refentrytitle>list-connector-security-maps
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="update-connector-security-map-1"><citerefentry>
<refentrytitle>update-connector-security-map</refentrytitle><manvolnum>1</manvolnum>
</citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000006007>
