CALL LDAPS_MODIFY(lHandle, entryName, rc, modifyType1, attr1, numValues1 <, attr1Val1, ...attr1ValN> <..., modifyTypeN, attrN, numValuesN <, attrNVal1..., attrNValN>>);

1Handle: Numeric, input.
Specifies the connection handle returned by the LDAPS_OPEN CALL routine. The connection handle identifies the open connection to use when modifying the LDAP directory entry.
entryname: Character, input.
Names the directory entry to be modified.
rc: Numeric, output.
Receives a return code that indicates success or failure.
modifyType: Character, input.
Specifies the type of modification. Valid values are "ADD", "DELETE", and "REPLACE".
attr: Character, input.
Identifies the attribute to be modified.
numValues: Numeric, input.
Specifies the number of values to be modified for the specified attribute.
attrVal1, ...attrValN: Numeric or character, input.
Specifies zero or more attribute values, the number of which is specified by the numValues parameter.

Details

Zero or more attributes may be specified.

If the value of the modifyType parameter is DELETE and if the value of the numValues parameter is 0, then the entire attribute and all of its values are deleted.

If the value of the modifyType parameter is DELETE and if the value of the numValues parameter is 1 or greater, only the specified values will be deleted.

If the value of the modifyType parameter is REPLACE the existing attribute and all of its values are deleted and replaced with the specified attribute and its newly specified values.

Examples

The following example modifies the node associated with a distinguished name.

dn = "cn=alpair02.unx.com,o=Alphalite Airways,c=US";

attrName = "objectclass";
objValue = "SASDomain";

attrName2 = "node";
nodeValue = "oak.unx.com";

CALL LDAPS_MODIFY(lHandle, dn, rc, "ADD", attrName, 1, objValue, 
                  "DELETE", attrName2, 0);

The following example modifies a filter associated with an LDAP entry.

dn="sasSubscriberCn=JohnSmith,cn=sassubscribers,
sasComponent=sasPublishSubscribe,cn=SAS,o=Alphalite Airways,c=US";

attrName = "sasDescription";

attrName2 = "sasEntryInclusionFilter";
val = "gif";
val2 = "dataset";
htmlvalue = "html";

CALL LDAPS_MODIFY(lHandle, dn, rc, "DELETE", attrName, 0, "REPLACE",
                  attrName2, 3, val, val2, htmlvalue);