wn_give_focus_c (ul_wnlib)

	status.i4.v = wn_give_focus_c(screen.i4.v)

	This routine makes a request to give focus to a graphics window
	of the calling program.

	screen		graphics screen to receive focus
			(WN_SCREEN_1 -> graphics screen #1 (This is the same
					as GXPA_1 for a PA and is the only
					acceptable value to use for an SA.),
			 WN_SCREEN_2 -> graphics screen #2 (This is the same
					as GXPA_1 for a PA and should never
					be used for an SA.)

	This function returns status values as follows:

	CBS_OK			focus request successfully made
	CBS_INVARG		invalid screen value passed
	CBS_NOTENB		invalid calling environment

	This function requires the following include files:

	ul_wnlib_h:wnlib_h, cbslib_h, acnet_errors_h

	Related functions:

	wn_has_focus_c, wn_wait_for_focus_c

	C usage:

	int	status;
	int	screen = WN_SCREEN_1;

	status = wn_give_focus_c(screen);