<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<!--Arbortext, Inc., 1988-2007, v.4002-->
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="update-connector-security-map-1">
<!-- @(#)update-connector-security-map.1 1.10 07/04/25 SMI; -->
<refmeta><refentrytitle>update-connector-security-map</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>update-connector-security-map</primary></indexterm><indexterm><primary>creates or modifies a security map for the specified connector connection pool</primary></indexterm>
<refname>update-connector-security-map </refname><refpurpose>creates or modifies a security map for the specified connector connection pool</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>update-connector-security-map</command> &synopsis-common; <option role="double-dash">poolname</option> <replaceable>connector_connection_pool_name</replaceable>
 [ <option role="double-dash">addprincipals</option> <replaceable>principal_name1</replaceable>[, <replaceable>principal_name1</replaceable>]*| <option role="double-dash">addusergroups</option> <replaceable>user_group1</replaceable>[,<replaceable>user_group2</replaceable>] ]
 [<option role="double-dash">removeprincipals</option> <replaceable>principal_name1</replaceable>[,<replaceable>principal_name2</replaceable>]*]
 [<option role="double-dash">removeusergroups</option> <replaceable>user_group1</replaceable>[, <replaceable>user_group2</replaceable>]* ]
 [<option role="double-dash">mappedusername</option>  <replaceable>username </replaceable>] <replaceable>security_map_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Use this command to modify a security map for the specified connector connection pool. </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 dats of the enterprise. organization. It can be a mainframe, a messaging system, a database system, or an application.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target </option></term>
<listitem><para>This option is deprecated.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">poolname</option></term>
<listitem><para>Specifies the name of the connector connection pool to which the security map that is to be updated or created belongs.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">addprincipals</option></term>
<listitem><para>Specifies a comma-separated list of EIS-specific principals to be added. Use either the <option role="double-dash">addprincipals</option> or <option role="double-dash">addusergroups</option> options, but not both at the same time.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">addusergroups</option></term>
<listitem><para>Specifies a comma-separated list of EIS user groups to be added. Use either the <option role="double-dash">addprincipals</option> or <option role="double-dash">addusergroups</option> options, but not both at the same time.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">removeprincipals</option></term>
<listitem><para>Specifies a comma-separated list of EIS-specific principals to be removed.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">removeusergroups</option></term>
<listitem><para>Specifies a comma-separated list of EIS user groups to be removed. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">mappedusername</option></term>
<listitem><para>Specifies the EIS username.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></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 role="examples"><title></title>
<example><title>Using the <command>update-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>update-connector-security-map --user admin --passwordfile password.txt --poolname connector-pool1 --addprincipals principal1, principal2 securityMap1</userinput>
Command update-connector-security-map executed successfully</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></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 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="delete-connector-security-map-1">delete-connector-security-map(1)</olink>, <olink targetdoc="asrefman" targetptr="list-connector-security-maps-1">list-connector-security-maps(1)</olink>, <olink targetdoc="asrefman" targetptr="create-connector-security-map-1">create-connector-security-map(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000006196 0>
