_CEE_ENVFILE_CONTINUATION

Defines the continuation character to be checked for when subsequent records are read from the file. _CEE_ENVFILE_CONTINUATION is defined within the file specified by the _CEE_ENVFILE or _CEE_ENVFILE_S environment variable. The continuation character used is the first character after the = and it must not be a space character, as determined by the isspace() macro.

When a continuation character is defined and a name=value sequence is found, where the last non-whitespace character matches the continuation character, the next line of the file is read and appended to value. If the last non-whitespace character of the updated value matches the continuation character, the next line of the file is read and appended to value. This continues until the last non-whitespace character does not match the continuation character and then the name and value pair are set into the environment.

In the following example, the continuation character is defined as \. With this in place, the STEPLIB keyword defined on the next line is defined to have a value that spans multiple lines. When queried by the application, the value of STEPLIB is CEE.SCEERUN2:CEE.SCEERUN:MY.LOADLIB.
_CEE_ENVFILE_CONTINUATION=\
STEPLIB=CEE.SCEERUN2:\
CEE.SCEERUN:\
MY.LOADLIB
Notes:
  1. If _CEE_ENVFILE_CONTINUATION is encountered when the file is read, it is only used to define the continuation character; _CEE_ENVFILE_CONTINUATION is not added to the environment.
  2. The name= portion of the name=value sequence cannot exceed one line.
  3. The length of the value is limited only by the memory available to read, concatenate the lines, and set the variable into the environment.