ACCESS Statement

Allows the states of various data elements to be changed. Can be used only within Embedded Basic subroutines.

Syntax

ACCESS(data-element) = value

Syntax Elements

data-element is a number specifying the data element to be referenced.

Operation

If the ACCESS statement is called from an illegal environment, it raises the following run time error:

[B160] Program progname.  Line number.

ACCESS(n) is not supported in this environment.

Data Elements

Only the following data elements can be changed:

Key:

The Trigger, English and Other columns show in which calling environments the ACCESS statement is valid. The Other column covers circumstances where a dictionary subroutine is called from a conversion environment other than English (for example, from DataBasic using the ICONV or OCONV function). Use the ACCESS function (elements 23 and 32) to determine the calling environment.

The following characters have special meanings:

v Legal in this environment.

X Illegal in this environment.

All unlisted elements are illegal.

ACCESS(34)

The ACCESS(34) statement allows you to delete the next conversion code to prevent it being processed. This is necessary when an Embedded Basic subroutine has been written to replace a user exit migrated from another MultiValue system that passes parameters separated by value marks. For example, in:

U5555vm45

if user exit 5555 is replaced with an Embedded Basic subroutine, this would call the ACCESS(34) function to fetch the parameter "45". However, before returning, the subroutine must use the ACCESS(34) statement to delete this parameter to prevent it being processed as a normal conversion code.