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

sh
Options
and runs this file with the . command if it exists. You do not get an error message if
any of these files cannot be found.
You can use these profile files to customize your session with sh. For example,
your profile files can set options, create aliases, or define functions and variables.
If there is at least one argument on the sh command line, sh takes the first
argument as the name of a shell script to run. (The exception to this is when –s is
used.) Any additional arguments are assigned to the positional parameters; usually,
these serve as arguments to the shell script. See “Parameter Substitution” on page
559 for information about positional parameters. Also see set for information about
changing these parameters.
If sh finds the ENV environment variable set when it begins running (after profile
processing), sh runs the file named by the expansion of the value of this variable.
The shell accepts the following options on the command line:
–c cmdstring
Runs cmdstring as if it were an input line to the shell and then exits. This is
used by programs (for example, editors) that call the shell for a single
command. sh assigns arguments after cmdstring to the positional
parameters. If you specify cmd_name, special parameter 0 is set to this
string for use when running the commands in cmdstring.
–i Invokes an interactive shell, as opposed to running a script.With –i, the
shell catches and ignores keyboard interrupts. Without –i, an interrupt ends
the shell. For shells that read from the terminal, –i is the default.
–L Makes the shell a login shell, as described earlier. (A login shell is an
interactive shell.)
–r Invokes a restricted shell. (As noted earlier, you can also invoke a restricted
shell by usingthe name rsh). In a restricted shell, you cannot do the
following:
v Use the cd command
v Change the values of the variables ENV, PATH, or SHELL
v Use > or >> to redirect output; or specify command names containing /
These restrictions do not apply during execution of your profile files.
–s Reads commands from standard input (stdin) and assigns all arguments to
the positional parameters. Normally, if there is at least one argument to the
shell, the first such argument is the name of a file to be run.
–S Searches the directories in the environment variable PATH for a file
cmd_file that contains shell commands. The current working directory is not
searched before PATH.
If you do not give either the –c or –s option, but you do specify cmd_file, the shell
takes it as the name of a file that contains commands to be run. Special parameter
0 is set to this name.
If cmd_file contains a slash, the shell attempts to read that filename. If cmd_file
does not contain a slash, the following can occur:
v If –S is specified, the shell searches for the file in PATH. Only a file with
executable access permissions for the user will be found in the PATH search.
550 z/OS V1R9.0 UNIX System Services Command Reference