SKPFLD.SBR


The SKPFLD xcall subroutine is designed to be used with an ESP screen to 
allow a program to set the SKIP or ALLOW status of an ESP screen field.

Usually this function is accessed by the expression handler for an ESP
screen via the function SKIP(F??) where ?? is the field number or 
ALLOW(F??) where ?? is the field number. 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 handle the SKIP and
ALLOW status of a particular field. To this end we now have SKPFLD.SBR.

Usage:

 XCALL SKPFLD, SCREEN, FLAG, FIELD {, FIELD {, FIELD (, ....}}

Where:
	SCREEN = the ESP screen Fetched into the basic program using
                 XCALL FETCH subroutine
	
	FLAG   =  TRUE (not-zero)  Will SKIP a field
	          FALSE (zero)     Will ALLOW a field.

        FIELD  = the number of the field to set SKIP or ALLOW status.


For Example:

	SKIP = 1
	XCALL SKPFLD, SCREEN1, SKIP, 4, 5, 6, 10

    will SKIP Fields 4, 5, 6, and 10 of the specified ESP screen.

	ALLOW = 0
	XCALL SKPFLD, SCREEN1, ALLOW, 4, 5, 6, 10

    will ALLOW fields 4, 5, 6, and 10 of the specified ESP screen.

This enables you to set or reset an ESP screen field's SKIP or ALLOW
status from a BASIC program even if the SKIP or ALLOW status of an
ESP screen fields expression value has set or reset the SKIP or ALLOW
status.

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.