Reference Guide › DSA Commands (DXserver Commands) › Commands Reference › set agreement Command—Create a DISP Agreement

set agreement Command—Create a DISP Agreement

This command has the following format:

set agreement id.version =
{
	initiator	= dsaname { supplier | consumer } 
	responder	= dsaname { anonymous | clear-password | ssl-auth }
	[relay		= dsaname { anonymous | clear-password | ssl-auth }]
	area		= DN
	[filter	= search-filter ]
	[attributes	= attribute-list ]
	[strategy	= onchange | frequency time type ]
};

• id.version

  The agreement identification and version numbers (for example, 1.2).

• initiator

  The DSA initiating the DISP update:

  • dsaname

    The name of the initiating DSA.

  • supplier

    Specifies that the initiating DSA is acting as a supplier.

  • consumer

    Specifies that the initiating DSA is acting as a consumer.

• responder

  The DSA receiving the DISP update.

  • dsaname

    The name of the responding DSA.

  • anonymous

    Specifies that the responding DSA can receive an anonymous connection.

  • clear-password

    Specifies that the responding DSA requires a user ID and password.

  • ssl-auth

    Specifies that the responding DSA requires a SSL authentication.

• relay

  (Optional) Specifies an intermediate DSA used to relay the DISP update:

  • dsaname

    Names the relay DSA.

  • anonymous

    Specifies that the relay DSA can receive an anonymous connection.

  • clear-password

    Specifies that the relay DSA requires a user ID and password.

  • ssl-auth

    Specifies that the relay DSA requires a SSL authentication.

• area = DN

  Specifies the distinguished name of the entry at the top of the subtree covered by this agreement.

• filter = search-filter

  (Optional) Specifies an X500 search filter that restricts the entries to be included in the DISP update.

• attributes = attribute-list

  (Optional) Specifies a comma-separated list of attributes to include or exclude from the DISP update.

• strategy

  (Optional) Enables automatic DISP updates, or specifies when the updates will take place:

  • onchange

    Enables automatic DISP updates.

  • frequency

    Specifies the update frequency. Use one of the following values: hourly, daily, weekly, or monthly.

  • time

    Specifies the time at which the update will occur. Use one of these formats: dd:hh:mm or hh:mm.

  • type

    Specifies the type of update. Use one of the following values: incremental or full.

Example: Create a DISP Agreement

set agreement 0.0 =
{

initiator = EAGLE supplier
responder = BACKUP anonymous
area      = <c AU><o Democorp>
strategy  = daily 03:00 incremental

};

Example: Create a Selective Shadowing Agreement

set agreement 2.1 =
{

initiator = EAGLE supplier
responder = BACKUP anonymous
area = <c AU><o Democorp>
filter = { attr = objectClass value = organizationalPerson }
attributes = { { exclude = title, description, telephoneNumber } }
strategy = on-change

};