TRN_JOIN - Concatenate transformations

Description:

Concatenate two transformations to produce a combined transformation which is stored as a new component in an existing HDS structure. The combined transformation may also be assigned to a temporary HDS object if required.

Invocation:

CALL TRN_JOIN( LOCTR1, LOCTR2, ELOC, NAME, LOCTR, STATUS )

Arguments:

LOCTR1 = C$_{LOC}$

Locator to the first transformation.

LOCTR2 = C$_{LOC}$

Locator to the second transformation.

ELOC = C$_{LOC}$

Locator to an enclosing structure to contain the new object.

NAME = C$_{NAM}$

HDS name of the new structure component to be created.

LOCTR = C$_{LOC}$

Locator to the newly created transformation.

STATUS = I

Inherited error status.

Notes:

• If the enclosing structure locator ELOC is supplied as a blank string, then a temporary transformation will be created. The NAME argument is then not used and may also be blank.

• Before two transformations may be concatenated, the following conditions must apply:
  • The number of output variables from the first transformation must match the number of input variables to the second transformation.

  • The transformations must have at least one mapping (forward or inverse) in common.