Using an alias for an accelerator

When you need a Db2 application to run on an accelerator in a different subsystem, you can use logical names, called aliases. Using aliases can help make the application portable so that you can run the application, without modification, on an accelerator in another subsystem. For example, you might have an application that runs initially on an accelerator in your test subsystem, and then later you want to run it in a production subsystem. Similarly, you might run an application in one production subsystem, but you also need to run the application on accelerators in multiple other production subsystems. In both cases, using an alias is an efficient way to make the application portable across accelerators in different subsystems.

Before you begin

Ensure that the physical name for the accelerator in a specific subsystem is already defined.

About this task

Defining an accelerator alias enables you to map a logical name (alias) to a physical accelerator name that is used in a specific subsystem. A Db2 application can then use that alias, which points to an accelerator in that subsystem. You can also set up multiple aliases to point to the same accelerator, if needed.

Restriction: You cannot define a chain of aliases for accelerators. That is, you cannot have one alias point to another alias, which points to yet another alias.

Procedure

To create an alias for an accelerator:

Create special rows in the SYSIBM.LOCATIONS communications database (CDB) table of one subsystem.

For example:

Begin general-use programming interface information.

INSERT INTO SYSIBM.LOCATIONS (LOCATION, LINKNAME, DBALIAS)
VALUES ('logical_system_accel_name', 'DSNACCELERATORALIAS',
'physical_system_accel_name')

End general-use programming interface information.

In this example:

logical_system_accel_name

Is the name of an accelerator in another Db2 subsystem, typically a production subsystem, where the accelerator is defined. A logical name is used only when you issue a CREATE TABLE...IN ACCELERATOR accel_name statement.

To ensure compatibility with the CURRENT ACCELERATOR special register and the ACCELERATOR bind options, logical names must not exceed eight characters and must consist of the characters A-Z and 0-9.

For example, if the name of the accelerator on your production system is PACCEL, and the name of the accelerator on your test system is TACCEL, create an alias in SYSIBM.LOCATIONS on your test system in which LOCATION = 'PACCEL' and DBALIAS= 'TACCEL'. By doing so, when you port an application that uses accelerator-only tables from your test environment to your production environment, the DDL will not need to be changed.

physical_system_accel_name

Is the real name of an accelerator or accelerators in this Db2 subsystem.

To specify multiple physical accelerators to be represented by an alias, separate each accelerator name with a blank space. You can specify a maximum of 14 accelerator names. Accelerator names must not exceed eight characters and must consist of the characters A-Z and 0-9.

Results

When Db2 processes the CREATE TABLE...IN ACCELERATOR logical_system_accel_name clause, Db2 first looks for the accelerator named logical_system_accel_name in that same subsystem. If an accelerator with that name does not exist in that subsystem, Db2 checks the SYSIBM.LOCATION table for the corresponding DSNACCELERATORALIAS value, which identifies the physical accelerator name in the that subsystem.