OSExitCmd [4] $SSW_SMEI_UCSD/obsolete/for/os/vms/os_vms.f
[Previous] [Next]
 NAME:
	OSExitCmd
 PURPOSE:
	Terminate program execution. Set an exit code for external use.
 CATEGORY:
	Machine-dependent functions: VMS
 CALLING SEQUENCE:
	subroutine OSExitCmd(Cmd,iCode)
 INPUTS:
	Cmd	character*(*)	shell command passed to lib$do_command
	iCode	integer		error code passed to EXIT function
 OUTPUTS:
	(none)
 CALLS: ***
	LIB$DO_COMMAND
 CALLED BY:
	Say, sprint
 PROCEDURE:
 >	Calls system functions lib$do_command and EXIT
 >	The lib$do_command terminates the program and executes the cDo command
	at the level of calling procedure. Probably the execution of cDo
	determines the error status in this case, NOT iCode. ????
 >	If the cDo string is empty or the lib$do_command fails to terminate the
	program, then the error code iCode is passed to EXIT.
 MODIFICATION HISTORY:
	SEP-1999, Paul Hick (UCSD/CASS; pphick@ucsd.edu); Added documentation