Transfer

This function is used to transfer data from one area to another. This function copies values of an n-dimensional block of cells, defined by the symbols written within the TRANSFER syntax, to an n-dimensional block of cells in the same or in a different DataArea.

When using this function, you must define at least one dimension using the CalculationBlock function. You must also define a symbol from each dimension in the Transfer statement syntax.

This function will transfer only those symbols to which the user has access.

A

|_A1 ==> Priority= 1

|_A2 ==> Priority= 2

|_A3 ==> Priority= 3

B

|_B1 ==> Priority= 1

|_B2 ==> Priority= 2

|_B3 ==> Priority= 3

Note: The TRANSFER function takes symbol priority into account. For example, in the following hierarchy structure example, data is transferred from symbol A1 to symbol B1 because of the corresponding priority levels.
For more information on symbol priority, see the “Longview Application Administrator Guide”.

TRANSFER SymName0[Structure] | COMMON, SymName1[Structure] | COMMON, ...,SymNameN[Structure] | COMMON TO SymName0[Structure] | COMMON, SymName1[Structure] | COMMON, ..., SymNameN[Structure] | COMMON FROM "DataAreaName"        

where:

The first section of the Transfer statement defines the source DataArea. The second section (after the TO) defines the target DataArea.

• SymName0 is a symbol from the first dimension of the DataArea (i.e. ACCOUNTS).
• SymName1 is a symbol from the second dimension of the DataArea (i.e. TIMEPER).
• SymNameN is a symbol from the Nth dimension of the DataArea (all other dimension symbols by dimension order).
• [Structure] is an optional parameter that defines the level of symbols within the symbol parent structure. For more information, see “Symbol hierarchies”.
• COMMON is an optional parameter to be used instead of defining the dimension symbol and/or Structure. When the dimension DataArea is the same for both source and target, COMMON can be used to define all symbols for that dimension in the DataArea.

Note: COMMON must be used for both the dimension source and target areas.

Syntax using temporary symbols

If the temporary symbols belong to a different DataArea than the one associated with the Model, you must enclose them in double quotation marks, such as:

TRANSFER "TempSymGet" COMMON,COMMON,COMMON,COMMON,COMMON,COMMON,COMMON TO DIM0SET,COMMON,COMMON,COMMON,COMMON,COMMON,COMMON,COMMON FROM "GetData"    

where:

• TempSymGet is a temporary symbol in the GetData DataArea.

Note: If temporary symbols belong to the current DataArea (associated with the Model) the double quotation marks should not be used.

Caution: Database symbols should not be enclosed in double quotation marks; doing so will result in a syntax error.

The following is executed in a Procedure Document:
 
RUN MODEL FORCPY.lvmod ON FORDATA
The following is executed in the FORCPY Model Document:
 
CalculationBlock (ACCOUNTS)
 
TRANSFER BALSHEET#99,F0701,COMMON,COMMON,CCAD,Dim5Set TO BALSHEET#99,F0702,COMMON,COMMON,CCAD,Dim5Set
 
End CalculationBlock
 
In this example, the Transfer function moves F0701 to F0702 within the same DataArea (FORDATA).

The following is executed in a Procedure Document:

RUN MODEL ACTTOFOR.lvmod ON FORDATA
The following is executed in the ACTTOFOR Model Document:

CalculationBlock (ACCOUNTS)

TRANSFER BALSHEET#99,A0701,COMMON,COMMON,CCAD,Dim5Set TO BALSHEET#99,F0701,COMMON,COMMON,CCAD,Dim5Set FROM "ACTDATA"

End CalculationBlock

In this example, the Transfer function moves A0701 from the ACTData area to F0701 in the FORDATA area.

The following is executed in a Procedure Document:
 
RUN MODEL FORCPY.lvmod ON FORDATA
 
The associated datalink Document would include the base dimensions and reference to the schedule and schedule symbols:
 
SCHEDULE ICSTANDARD
OFFSET Total###
 
The following is executed in the FORCPY.lvmod file:
CalculationBlock (ACCOUNTS)
 
TRANSFER BALSHEET#99,F0701,COMMON,COMMON,CCAD,Dim5Set, Total###TO
BALSHEET#99,F0702,COMMON,COMMON,CCAD,Dim5Set, Total###
 
End CalculationBlock
 
In this example, the Transfer function moves schedule data from F0701 to F0702 within the same DataArea (FORDATA).