z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

Option
Example
Usage Note
Localization
Exit Values
Portability
Related Information
sh, tcsh
exec in the tcsh shell
In the tcsh shell, exec executes the specified command in place of the currrent
shell. See “tcsh — Invoke a C shell” on page 626.
–a name
The shell passes name as the zero’th argument (argv[0]) to command_line.
–a name can be used to replace the current shell with a new login shell, by
specifying name as a shell with a prefix of a dash (–).
To replace the current shell process with a new login shell (which will run the login
profiles), specify:
exec -a -sh /bin/sh
exec is a special built-in shell command.
exec uses the following localization environment variables:
v LANG
v LC_ALL
v LC_MESSAGES
v NLSPATH
See Appendix F for more information.
If you specify command_line, exec does not return to the shell. Instead, the shell
exits with the exit status of command_line or one of the following exit status values:
1–125 A redirection error occurred.
126 The command in command_line was found, but it was not an executable
utility.
127 The given command_line could not be run because the command could not
be found in the current PATH environment.
If you did not specify command_line, exec returns with an exit value of zero.
POSIX.2, X/Open Portability Guide, UNIX systems.
exec
Chapter 2. Shell command descriptions 261