The Parameters section lists the application’s parameters, with the format:
The description entry has a notation scheme to indicate normally defaulted parameters, i.e. those for which there will be no prompt. For such parameters a matching pair of square brackets ([]) terminates the description. The content between the brackets mean
[]
[,]
[
default]
[default]
There is also a Usage entry. This shows how the application is invoked from the command line. It lists
the positional parameters in order followed by any prompted keyword parameters using a
“KEYWORD=?”
syntax. Defaulted keyword parameters do not appear. Positional parameters
that are normally defaulted are indicated by being enclosed in square brackets. Keyword
(i.e. not positional) parameters are needed where the number of parameters are large, and
usually occur because they depend on the value of another parameter. An example should
clarify.
IN, OUT, COMP, and RECLEN are all positional parameters. Only IN, and OUT would be
prompted if not given on the command line. The remaining parameter, NOPEREC, depends on
the value of another parameter (it is FIXED), and will be prompted for when FIXED is
TRUE
.
The Examples section shows how to run the application from the command line. More often you’ll enter the command name and just some of the parameters, and be prompted for the rest.
Examples give command lines as accepted by the tasks themselves. From the UNIX shell,
metacharacters (notably [
, ]
and "
) must be escaped or enclosed in single quotes. For example: