Partition deletion supported by command line and XML Provisioning



Problem


Unified Messaging partitions can be deleted through mcit, the command line and XML provisioning, however, there is no documentation for deletion through command line and XML Provisioning deletion. Also, a workaround is required for deletion to work through XML Provisioning.

Resolving the problem


Unified Messaging partition deletion is supported via the command line and via XML Provisioning. These methods to delete a partition should only be used for partitions created with the addPartition command or with the XML Provisioning interface, and should NOT be used to delete partitions created with mcit.

Deleting a partition using the delPartition command:


Use the delPartition command to delete a partition. It can be found in $CUR_DIR/ca/IMC_Admin_dir/utils.


The syntax of delPartition is:


  delPartition -u partition -v partition_name


For example to delete a partition named IC_crew:


  delPartition -u partition -v IC_crew


The alternative (but now deprecated) syntax of delPartition is:


  delPartition -u department -v partition_name


Example:


  delPartition -u department -v IC_crew


Deleting a partition using the XML Provisioning interface:


This message allows a partition to be deleted within Unified Messaging. A single message may contain one or more partitions to be deleted and each is considered a separate transaction.



Example DeletePartition request message to Unified Messaging


<?xml version="1.0" encoding="UTF-8" ?>
<ProvisioningRequest xmlns="http://www.ibm.com">

    <MessageHeader>

        <MessageId>12345</MessageId>

        <Security userId="id" password="pw"/>

        <Sender name="YourCompany"/>

        <TimeStamp> 2002-08-12T12:00:00</TimeStamp>

        <MessageType version="1.0">DeletePartition</MessageType>

    </MessageHeader>

    <MessageBody>

        <DeletePartition>

        <Attribute name="partition" value="Sales"/>

        </DeletePartition>

        <DeletePartition>

        <Attribute name="department" value="Sales"/>

        </DeletePartition>

    </MessageBody>
</ProvisioningRequest>


Example DeletePartition response message from Unified Messaging


<?xml version="1.0" encoding="UTF-8" ?>
<ProvisioningResponse>

    <MessageHeader>

        <MessageId>12345</MessageId>

        <Security userId="id" password="pw"/>

        <Sender name="MC"/>

        <TimeStamp> 2002-08-12T12:00:00</TimeStamp>

        <MessageType version="1.0">DeletePartitionResponse</MessageType>

    </MessageHeader>

    <MessageBody>

        <Successes>

            <Partition name="Sales" description="Sales Description"/>

        </Successes>

        <Errors>

            <ErrorRecord>

                <ErrorCode>RP002</ErrorCode>

                <ErrorMessage>Partition already exists</ErrorMessage>

                <DeletePartition>

                    <Attribute name="department" value="Sales"/>

                </DeletePartition>

            </ErrorRecord>

        </Errors>

    </MessageBody>
</ProvisioningResponse>



Error codes and messages



Error CodeMessage
RP001Invalid partition name
RP002Partition not found
RP003This Partition is being used by some other object
RP004Failed to delete partition due to internal Unified Messaging error


Note:

The default XML Schema Description (as of fixlevel 4.2.0.156) has a error in the definition of the DeletePartition type where it expects two parameters instead of one. To fix this, open the $CUR_DIR/ca/IMC_XMLProvisioning_dir/XML_Provisioning_Interface_Schema.xsd file in your preferred text editor, and change the definition for "DeletePartitionType" (by default, this should begin on line 451 of the file) so that the element definition's minOccurs and maxOccurs parameters are “1” instead of “2”.