1#!F-adobe-helvetica-medium-r-normal--18*
2#!N
3#!N  #!Rgetloc GetLocal
4#!N #!N Category #!N #!N  #!Lcatflow,dxall755 h Flow Control  #!EL  #!N #!N Function #!N #!N
5Retrieves an object from the cache. State is not maintained between
6executions of any macros containing GetLocal. #!N #!N Syntax #!N #!N
7 #!F-adobe-times-bold-r-normal--18*   object, link #!EF = GetLocal(  #!F-adobe-times-bold-r-normal--18*   object, reset #!EF );
8#!N #!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type
9TAB Default TAB Description #!EF #!N TAB object TAB object TAB
10none TAB object to be output if nothing has #!N TAB
11- TAB - TAB - TAB been set #!N TAB reset
12TAB flag TAB 0 TAB 0: the object cached by SetLocal
13#!N TAB - TAB - TAB - TAB (if there is
14one) is passed to #!N TAB - TAB - TAB -
15TAB output #!N TAB - TAB - TAB - TAB 1:
16object (not the cached object) #!N TAB - TAB - TAB
17- TAB is passed to output. #!N TAB - TAB -
18TAB - TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N
19TAB Name TAB Type TAB Description #!EF #!N TAB object TAB
20object TAB retrieved object #!N TAB link TAB string TAB link
21to corresponding SetLocal module #!N TAB - TAB - TAB #!EF
22#!N #!N Functional Details #!N #!N GetLocal works with SetLocal to
23place objects in and retrieve them from the cache. GetLocal differs
24from GetGlobal in that GetLocal and SetLocal are used when the
25state maintained by the Get/Set pair should be reset when a
26macro containing these modules is reexecuted. In contrast, GetGlobal and SetGlobal
27will maintain state when the macro is reexecuted. Note that for
28a single execution of a macro (for example, throughout the execution
29of an entire loop), state is of course maintained by both
30GetLocal and GetGlobal. #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*
31object #!EF #!EF #!I50 #!N specifies the object to be output
32by GetLocal if nothing has been placed in the cache (e.g.,
33as on the first execution of a visual program) or if
34 #!F-adobe-times-bold-r-normal--18*   reset #!EF = 1. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   reset
35#!EF #!EF #!I50 #!N causes the module to output  #!F-adobe-times-bold-r-normal--18*   object
36#!EF . If this parameter is set to 0 (zero), GetLocal
37retrieves the last object placed in the cache by SetLocal (if
38there is one). Otherwise, the module passes  #!F-adobe-times-bold-r-normal--18*   object #!EF to
39the output. #!I0 #!N #!N #!N #!N The  #!F-adobe-times-bold-r-normal--18*   link #!EF
40output is to be connected to the  #!F-adobe-times-bold-r-normal--18*   link #!EF input
41of the corresponding SetLocal module. GetLocal should always be used with
42SetLocal, not with SetGlobal. SetLocal must be executed on the same
43machine as GetLocal (i.e., it cannot be distributed to a different
44machine). #!N #!N It is not necessary to use the First
45tool to provide input to the  #!F-adobe-times-bold-r-normal--18*   reset #!EF parameter of
46GetLocal inside a macro, since this is done automatically whenever the
47macro is reexecuted. #!N #!N A detailed description of the behavior
48and use of the GetLocal, GetGlobal, SetLocal, and SetGlobal modules can
49be found in  #!Lstates,dxall269 h Preserving Explicit State  #!EL  in IBM Visualization Data Explorer User's Guide.
50#!N #!N Example Visual Programs #!N #!N #!CForestGreen #!N  #!F-adobe-courier-bold-r-normal--18*   #!N
51Accumulate.net #!N Bounce.net #!N SimpleGetSetLoop.net #!EF #!N #!N #!EC #!N #!N
52See Also #!N #!N  #!Lodone,dxall828 h Done  #!EL  ,  #!Lofirst,dxall850 h First  #!EL  ,  #!Lsetloc,dxall941 h SetLocal  #!EL  ,  #!Lgetglo,dxall854 h GetGlobal  #!EL
53,  #!Lsetglo,dxall940 h SetGlobal  #!EL  ,  #!Lreset,dxall926 h Reset  #!EL  #!N #!N  #!Lxmod,dxall263 h Data Explorer Execution Model  #!EL  in IBM Visualization Data
54Explorer User's Guide. #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N
55#!N  #!Lglyph,dxall856 h Glyph  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N
56