Previous Common Configuration Properties Next

Common Singleton Properties

These properties are used to specify the location for reading and writing the Singleton's IOR.

The method used to read and write the IOR file will depend on which properties have been completed.

Reading the IOR

The rules for reading the IOR are, in order of precedence:

    1. The IOR will be read from the location specified in the IOR URL property.
    2. If the IOR URL property is blank, the IOR will be read from the naming service specified in IOR Name Service, under the name specified in IOR Name Service Entry.
    3. If IOR Name Service Entry is blank, the IOR will be read from the location specified in the IOR File Name property.
Writing the IOR

The rules for writing the IOR are, in order of precedence:

    1. The IOR will be written to the location specified in the IOR File Name property.
    2. If IOR Name Service Entry is not blank the IOR will be written to the naming service specified in IOR Name Service, under the name specified in IOR Name Service Entry.

IOR Name Service

The name of the Naming Service which will be used to resolve the Singleton object. This defaults to NameService, which is the resolve name of the OpenFusion Naming Service, and should only be changed if the name service is being resolved using a different name.

Property Name

IOR.Server

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

IOR Name Service Entry

The naming service entry for the Singleton, in INS format (Interoperable Naming Service stringified name). This name will be written to the naming service specified in the IOR Name Service property.

Any intermediary naming context must already exist in the naming service. For example, to write Singleton "b" to the naming service as follows:

R/a/b

the context "a" must already exist.

This property has no default value, and if it is left blank the Singleton will not be written to the naming service.

Property Name

IOR.Name

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

IOR URL

The IOR URL property specifies the location of an Interoperable Object Reference (IOR) for the Service, using the Universal Resource Locator (URL) format. This information is used when a client attempts to resolve a reference to the Service.

Currently, only http and file URLs are supported.

This property defaults to:

file:/<install>/domains/<domain>/<node>/<service>/<singleton>/<singleton>.ior

where <install> is the OpenFusion CORBA Services installation path. See The Object Hierarchy for details of the domains directory structure.

The IOR URL can only be used when reading the IOR. The IOR cannot be written to a location specified in a URL; the IOR File Name property should be used instead.

Property Name

IOR.URL

Property Type

FIXED

Data Type

URL

Accessibility

READ/WRITE

Mandatory

NO

IOR File Name

The IOR File Name option specifies the name and location of the IOR file for the Singleton. This defaults to:

<install>/domains/<domain>/<node>/<service>/<singleton>/<singleton>.ior

where <install> is the OpenFusion CORBA Services installation path. See The Object Hierarchy for details of the domains directory structure.

Property Name

IOR.File

Property Type

FIXED

Data Type

FILE

Accessibility

READ/WRITE

Mandatory

NO

Resolve Name

The ORB Service name used to locate the Singleton using resolve_initial_references.

The Resolve Name of the Naming Service Singleton must be unique within the whole Domain.

ProcessSingletons do not have this property.

Property Name

ResolveName

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

YES



Previous Common Configuration Properties Next