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