7.1.1 Formats of parameters

Organization of this subsection

(1) Format of environment setting parameters

The following shows the format of environment setting parameters:

[Figure] ₀#-adsh_conf₁parameter₁value

Specify a parameter following #-adsh_conf on one line.
Specify nothing after the parameter value.
If a parameter value contains a space, enclose the entire value in double quotation marks ("). No other escape character is permitted.

The following shows the format of the export parameter:

[Figure] ₀export₁environment-variable-name=environment-variable-value

In the export parameter, specify one environment variable per line.
The only environment variable that can be referenced is PATH.

For example, the following specification sets in the NEWHOME environment variable the character string ${HOME} as is, not the contents of the HOME environment variable,:
```
  export NEWHOME=${HOME}
```
To specify a value containing a space, enclose the value in double quotation marks (") or single quotation marks (').
A backslash (\) is treated as an escape character (a backslash enclosed in single quotation marks (') is treated as a normal character).

The following shows the format of the conditional parameters:

₀#-adsh_conf₁ [phost_start | lhost_start₁ host-name]
environment-setting-parameter-or-export-parameter
     :
₀#-adsh_conf₁ [phost_end | lhost_end]

You can specify multiple environment setting parameters or export parameters.
To specify export and environment setting parameters that are to be valid only on the physical host or only on a specified logical host, you must enclose them within conditional parameters specified on the preceding and following lines.
Specify nothing after a parameter value.
You can specify multiple conditional parameters. However, nesting conditional parameters is not permitted (see example 2).

Example 1: Specifying multiple conditional parameters

#-adsh_conf phost_start
export HOME=/home/phost
#-adsh_conf phost_end
 
#-adsh_conf phost_start
export TEMP=/tmp
#-adsh_conf phost_end

Example 2: Nesting conditional parameters (results in an error)

#-adsh_conf phost_start
export HOME=/home/phost
#-adsh_conf phost_start
export TEMP=/tmp
#-adsh_conf phost_end
#-adsh_conf phost_end