WorkStack

From BR Wiki
Jump to navigation Jump to search

The WorkStack specification allows you to change the size of the work stack, which keeps track of temporary variables that are passed and localized during user- defined function calls, concatenations, or complex expressions.

Checking Values

The following environmental variables may be used to check your workstacks during a BR! session.

  • ENV$("STATUS.STACKS.WORKSTACK")
  • ENV$("STATUS.STACKS.WORKSTACK.MAX")
  • ENV$("STATUS.STACKS.WORKSTACK.USED")
  • ENV$("STATUS.STACKS.WORKSTACK.AVAILABLE")
  • ENV$("STATUS.STACKS.WORKSTACK.MAX_USAGE")

Syntax

Start-up Default

WorkStack 500000 (version 4.3+)

Parameter

"Integer" is a whole number that represents the number of bytes that the work stack may contain. It must be greater than 499 and may be arbitrarily high (e.g. up to 10 million bytes).

Technical Considerations

  1. WorkStack may be specified only in the BRConfig.sys file; it is not valid with Config.
  2. The amount of user memory available depends upon the amount of memory used by all the stacks together. Be sure to account for the sizes of the other stacks when you use the WorkStack specification.