user_password

	status.i4.v = user_password(user_name.i1a.r [,no_term.i4.v])

	This routine allows an application to screen its use.  It prompts
	the user for a password.  The programmer sets the user name in
	the call to this routine.  It should be called as the first 
	routine in the program intialization.  If the password query
	fails, the program execution is terminated.

	The password expected is to be set by the 'conpwd' utility. 'conpwd'
       is available as a command line program on any Linux console.

	user_name	null terminated user name string
			(up to USER_NAME_LEN characters plus null)
	[no_term]	failure handling code
			(TRUE -> do not exit the program on password entry
				 failure,
			 FALSE -> exit the program on password entry
				  failure (default))

	This function returns status values as follows:

	TRUE			password was successfully entered
	FALSE			password was not successfully entered

	This function requires the following include files:

	cbslib_h

	Related functions:

	user_validation_c, dialog_setup_c, window_restore_hint_c,
	set_validated_user_name_timeout_c, retrieve_validated_user_name,
	destroy_validated_user_name, get_personal_user_name_c

	C/C++ usage:

	static const char	user_name[] = "smith";
	int	status;
	int	no_term = FALSE;

	status = user_password(user_name,no_term);