RGM names fall into the following categories:
Resource group names
Resource type names
Resource names
Property names
Enumeration literal names
Except for resource type names, all names must comply with these rules:
Names must be in ASCII.
Names must start with a letter.
Names can contain uppercase and lowercase letters, digits, dashes (-), and underscores (_).
The maximum number of characters that you can use in a name is 255.
The format of the complete name of a resource type depends on the resource type, as follows:
If the resource type's resource type registration (RTR) file contains the #$upgrade directive, the format is as follows:
vendor-id.base-rt-name:rt-version
If the resource type's RTR file does not contain the #$upgrade directive, the format is as follows:
vendor-id.base-rt-name
A period separates vendor-id and base-rt-name. A colon separates base-rt-name and rt-version.
The variable elements in this format are as follows:
Specifies the vendor ID prefix, which is the value of the Vendor_id resource type property in the RTR file. If you are developing a resource type, choose a vendor ID prefix that uniquely identifies the vendor, such as your company's stock ticker symbol.
Specifies the base resource type name, which is the value of the Resource_type resource type property in the RTR file.
Specifies the version suffix, which is the value of the RT_version resource type property in the RTR file. The version suffix is only part of the complete resource type name if the RTR file contains the #$upgrade directive.
For more information, see Resource Type Properties.
Example 1-1 Complete Name of a Resource Type With the #$upgrade DirectiveThis example shows the complete name of a resource type for which properties in the RTR file are set, as follows:
Vendor_id=ORCL
Resource_type=sample
RT_version=2.0
The complete name of the resource type that is defined by this RTR file is as follows:
ORCL.sample:2.0Example 1-2 Complete Name of a Resource Type Without the #$upgrade Directive
This example shows the complete name of a resource type for which properties in the RTR file are set, as follows:
Vendor_id=ORCL
Resource_type=abc
The complete name of the resource type that is defined by this RTR file is as follows:
ORCL.abc