$Web Sel Check

<section begin="desc" />Check string against a global select element<section end="desc" />

$Web_Sel_Check validates that a string matches one of the options of a global select element. An overview of the $WEB_SEL_x functions is provided in $Web_Selp.

$Web_Sel_Check takes three arguments and returns a numeric result code; for some types of errors, the current User Language request is cancelled.

Syntax

<section begin="syntax" /> %RC = $Web_Sel_Check(global_name, selected_value, option_keywords) <section end="syntax" />

global_name	The name of the global select element containing the values to check against. The global select element with this name must have been created by $Web_Save_Sel. This is a required argument.
selected_value	A string which is checked to see if it is equal to one of the values in the options list. This a required argument.
option_keywords	A string of blank-separated keywords specifying special processing for this $function. Any of the following is valid: CANCHECK Cancel request if selected_value not found in select options list NOCAN Don't cancel request if global select element global_name not found This an optional argument.

Code	Meaning
0	Selected_value equal to one of the values in global select element global_name.
1	Global_name not a saved global select element, and NOCAN option specified.
2	Selected_value not equal to any of the values in global select element global_name, and CANCHECK option not specified.
	Any other error results in cancellation of the User Language request.

$WEB_SEL_CHECK return codes

The following statement will cancel the User Language request if the string 'DAY6' is not one of the values of the global select element 'DAYS.ESPERANTO':

%RC = $Web_Sel_Check('DAYS.ESPERANTO', 'DN6', 'CANCHECK')

See $Web_Selp for an extended example using other $WEB_SELx functions.