GETPUI.SBR and SETPUI.SBR

The GETPUI xcall subroutine is designed to be used with an ESP screen to 
allow a program to GET a field's POPUP'ITEM value.

The SETPUI xcall subroutine is designed to be used with an ESP screen to 
allow a program to SET a field's POPUP'ITEM value.

Usually this function is accessed by the expression handler for an ESP
screen via the function POPUP'ITEM(F??) where ?? is the field number or 
For instance an ESP screen field expression could be as follows:
      
Field Expression:
IF(POPUP'ITEM(F1)=1, SKIP(F2), ALLOW(F2))

This expression would evaluate to:
If the popup item for field one is the first item then SKIP field 2 
else
ALLOW field 2

There are times when you may want a basic program to GET or SET the
POPUP'ITEM value of a particular field. To this end we now have 
GETPUI and SETPUI xcall subroutines.

Usage:

       XCALL GETPUI, SCREEN, FIELD, VALUE

Where:
	SCREEN = the ESP screen Fetched into the basic program using
                 XCALL FETCH subroutine
	
        FIELD  = the number of the field to GET the POPUP'ITEM value.

	VALUE  = The variable to receive the POPUP'ITEM value.

For Example:

	XCALL GETPUI, SCREEN1, 1, POPUP'VALUE

    will Get the POPUP'ITEM value of field 1.


Usage:

       XCALL SETPUI, SCREEN, FIELD, VALUE

Where:
	SCREEN = the ESP screen Fetched into the basic program using
                 XCALL FETCH subroutine
	
        FIELD  = the number of the field to SET the POPUP'ITEM value.

	VALUE  = The variable that contains the new POPUP'ITEM value.

For Example:

	POPUP'VALUE = 3
	XCALL SETPUI, SCREEN1, 1, POPUP'VALUE

    will SET the POPUP'ITEM value of field 1 to the third POPUP'ITEM.


For BASIC examples see the file HIDSKP.BAS in the ESP account on the
AMUS Network. ALSO get the following:

	SKPFLD.SBR - SKIP or ALLOW field.
	HIDFLD.SBR - HIDE or SHOW field.
	GETPUI.SBR - GET POPUP'ITEM value.
	SETPUI.SBR - SET POPUP'ITEM value.
	HIDSKP.BAS - BASIC program that demonstrates usage.
	HIDSKP.SCR - ESP Screen used with HIDSKP.BAS

Any comments or suggestions should be sent to GR/AM on the AMUS Network.