Indicate Generic Point

Synopsis

GPOS/'message', x,y,z, response

Description

The following allows three coordinate values to be obtained via the Point Subfunction menu. For more information on the Point Subfunction menu, refer to the Gateway Online Help manual.

CAUTION: We do not recommend using the asterisk character (*) in menu prompts or menu options.

The GPOS statement works with the Back, OK, and Cancel options. If Back is chosen during program execution while the GPOS statement is pending, the value of 1 to be assigned to the response variable. Cancel causes 2 to be assigned. OK causes 3 to be assigned. The value of 4 is not used, and may not be used.

Once the position is defined, the value of 5 is assigned to the response variable and program execution continues.

Below is a list of response values assigned to the response variable:

Response

Assignment

Back

1

Cancel

2

OK

3

Not used

4

Position Defined

5

Parameters

Parameter

Description

'message'

A string which represents the title of the menu you want to display. The string can contain up to 40 characters.

x,y,z

Three variables which are assigned the coordinate values obtained from the generic point menu.

response

A variable which is assigned a numerical value based on the user response.

Parameter	Description
'message'	A string which represents the title of the menu you want to display. The string can contain up to 40 characters.
x,y,z	Three variables which are assigned the coordinate values obtained from the generic point menu.
response	A variable which is assigned a numerical value based on the user response.