A Location element is used to store platform-dependent location information; for example, file paths, database access, or Filegroup information. The Pack Type specifies a valid Data Source, External Pack Details, Filegroup, or Path for the files of a generated system on the target host computer.
A Location element can only be added at the Model level and cannot contain any members. A Location object is a named element and can be added, removed, or updated as can any other element.
After adding a Location element to a model, you should configure the Location for a particular target platform.
To set the configuration properties for a Location, perform the following:
Click Class View on the View menu to open the Class View window.
Right-click the Location element and select Properties.
The Location Property Pages window appears.
Select a configuration from the Configuration list.
Select a platform for deployment from the Platform list.
Specify the Pack Type (for Windows) or Pack Name (for MCP) properties depending on the platform that you select.
For MCP platform, specify the following property.
Pack Name – Specifies a unique name to define a storage area on the host for the system components.
For Windows platform, specify the following property.
Pack Type – Specifies a valid Data Source, External Pack Details, Filegroup, or Path. Select either one of the options from the Pack Type list.
Data Source – Specifies the connection information to connect to an external database. An appropriate error message is displayed for entries that are invalid for any of the data source configuration properties. The user needs to select either one of the options from the data source type list.
Data Source Type – Specifies the type of data source to connect from the various data source types such as, EAE OS 2200 database tables, EAE RDML schema files, OS 2200 Extract files, or OLTP view files.
Note: The EAE OS 2200 and <inherit from parent or default> options refers to the External Persistent Classes.
The following table specifies the configurations for EAE OS 2200, <inherits from parents or default>, and OS 2200 Extract file Data Sources types:
|
Configuration Property |
Description |
|---|---|
| External System | Specifies the name of the deployed EAE system. Note: This property is not applicable for OS 2200 Extract file data source type. |
| External Host | Specifies the IP address or the name of the external host. Notes:
|
| Port Number | Specifies the TCIP port number to connect to the external HDBA host server. The port number must be in between 1 and 65,535 inclusive. Note: This property is not applicable for OS 2200 Extract file data source type. |
| Authentication Method | Specifies the method used to authorize access to the external database table.
Note: This property is not applicable for OS 2200 Extract file data source type. |
| User Id | Specifies the registered user id that can access the host server. The User Id can be:
The user id must not begin with an underscore or numeral. |
| Password | Specifies the password required for the authorized user id on the host server. The password can be:
A password must not contain a comma (,) and slash (/). The password is obfuscated. |
| Auxiliary Information | Specifies a user-defined connection string if you have selected the ByAuxiliaryInfo option from the Authentication Method list. Note: This property is not applicable for OS 2200 Extract file data source type. |
The following table specifies the configurations for the OS 2200 Extract File Data Source types:
|
Configuration Property |
Description |
|---|---|
| External Host | Specifies the name of the host as configured in the Clear Path Forward Application Integration Services (CPF AIS). |
| User Id | Specifies the registered user id that can access the host server. The User Id can be:
The user id must not begin with an underscore or numeral. |
| Password | Specifies the password required for the authorized user id on the host server. The password can be:
A password must not contain a comma (,) and slash (/). The password is obfuscated. |
External Pack Details – Specifies the properties for physical host pack details to identify the extract file placement.
The following table specifies the configurations for the External Pack Details Pack type:
|
Configuration |
Property |
|---|---|
| Access control record name(ACR) | Specifies the file access permissions and also identifies your access permission. Contact OS 2200 System Administrator for more information. Note: The length of this field cannot exceed 6 characters. |
| Fixed Storage Pack | Specifies whether Fixed Mass Storage is used on OS 2200. Note: If the property is set to false, you can customize the Pack Id’s information. By default, this property is set to false. If the property is set to true, Fixed Mass Storage is used. |
| OS 2200 Pack Settings | Specifies the disk equipment type and names for up to eight removable Packs. Click the OS 2200 Pack settings and select Edit to view the OS 2200 Pack Setting window. You can manually enter the disk equipment type and Pack Ids in the space provided. Note: The length of the Pack Id should not exceed 6 characters. |
| Host connection information | Specifies the connection information needed to connect to OS 2200. Click the Host connection information and select Edit, and then select the Location option. The Location Selection window appears. You can manually select the location and click Ok. |
Filegroup – Specifies the SQL Server database filegroup in the Database Filegroup property.
Path – Specifies the path in the Path Name property where the pack is stored on the disk.
Click Apply, and then click OK to save and close the Properties window.
The Properties window, if open, displays the properties of the selected location. See Location Properties for properties related to the Location element.