9 216 SET_FOR_HEAVY_USAGE

LANSA Technical

9.216 SET_FOR_HEAVY_USAGE

Þ Note: Built-In Function Rules.

Sets a function for heavy usage mode

For use with

LANSA for i

YES

Visual LANSA for Windows

NO

Visual LANSA for Linux

NO

 

 

Arguments

No Argument Values.

Return Values

No Return Values.

Technical Notes

  • This Built-In Function allows a function to dynamically change from heavy usage to light usage (and vice-versa). For example:

     if (*jobmode = B)

        use SET_FOR_HEAVY_USAGE 

     else 

        use SET_FOR_LIGHT_USAGE 

     endif

 

  • At every entry or (re)entry the heavy/light usage option is set by the calling parent process, or adopted from a *DIRECT caller, so at every invocation you should positively (re)set the usage option.
  • This Built-In Function executes very quickly and imposes little overhead.
  • Changing a "light usage" function to have a "heavy usage" capability may be more complex than simply adding a use of the SET_FOR_HEAVY_USAGE Built-In Function. Since a heavy usage function's variables and lists retain their values between invocations, more complex entry and/or exit logic may be required.