3.2.4.1 Catalog Version Negotiation

Before making any calls to the server, a COMA server MUST ensure that it has performed catalog version negotiation, by checking the value of the negotiated catalog version for the session, as specified in section 3.2.1.1, with the following exceptions.

Exception	Notes
ICatalogSession::InitializeSession	Used for catalog version negotiation.
ICatalogSession::GetServerInformation	Used for capability negotiation.
ICatalog64BitSupport::SupportsMultipleBitness	Used for capability negotiation.
ICatalog64BitSupport::Initialize64BitQueryCellSupport	Used for capability negotiation.
IImport2::SetPartition	Sets the import target partition identifier, as specified in section 3.1.1.5.
ICatalogUtils::ValidateUser	Used to validate a user account name and password.
ICatalogUtils::WaitForEndWrites	Used to synchronize with the server.
ICatalogUtils2::IsSafeToDelete	Used to determine if a file is safe to delete.
ICatalogUtils2::FlushPartitionCache	Used to flush the server's local cache of partition user information.
ICatalogUtils2::EnumerateSRPLevels	Used to get a list of software restriction policy levels supported by the server.
ICatalogUtils2::GetComponentVersions	Used to get a list of component configurations for a component.
ICapabilitySupport::Start	Used to control instance load balancing.
ICapabilitySupport::Stop	Used to control instance load balancing.
ICapabilitySupport::IsInstalled	Used to control instance load balancing.
ICapabilitySupport::IsRunning	Used to control instance load balancing.
IContainerControl::CreateContainer	Used to obtain information about and control instance containers.
IContainerControl::ShutdownContainers	Used to obtain information about and control instance containers.
IContainerControl::RefreshComponents	Used to obtain information about and control instance containers.
IContainerControl2::ShutdownContainer	Used to obtain information about and control instance containers.
IContainerControl2::PauseContainer	Used to obtain information about and control instance containers.
IContainerControl2::ResumeContainer	Used to obtain information about and control instance containers.
IContainerControl2::IsContainerPaused	Used to obtain information about and control instance containers.
IContainerControl2::GetRunningContainers	Used to obtain information about and control instance containers.
IContainerControl2::GetContainerIDFromProcessID	Used to obtain information about and control instance containers.
IContainerControl2::RecycleContainer	Used to obtain information about and control instance containers.
IContainerControl2::GetContainerIDFromConglomerationID	Used to obtain information about and control instance containers.
IReplicationUtil::CreateShare	Specific to replication.
IReplicationUtil::CreateEmptyDir	Specific to replication.
IReplicationUtil::RemoveShare	Specific to replication.
IReplicationUtil::BeginReplicationAsTarget	Specific to replication.
IReplicationUtil::QueryConglomerationPassword	Specific to replication.
IReplicationUtil::CreateReplicationDir	Specific to replication.

Catalog version negotiation is described in more detail in section 3.1.4.1. On successful completion, the client MUST set the negotiated catalog version for the session in its per-session state.

Each COMA client supports an implementation-specific range of catalog versions.<355> However, not all possible supported ranges are recommended.

For the client, maximum interoperability is provided by supporting multiple catalog versions. In particular, supporting both catalog versions 4.00 and 5.00 enables configuration of servers that support catalog version 4.00 only, and enables configuration of multiple-partition support on servers that support catalog version 5.00.

In summary, a client's supported range of catalog versions SHOULD be one of the following combinations.

Versions	Comments
3.00
3.00, 4.00	Not recommended for clients that configure multiple partitions on a server.<356>
3.00, 4.00, 5.00
4.00	Not recommended for clients that configure multiple partitions on a server.
4.00, 5.00