CLOCK ENV

The ENV keyword retrieves a specific environment setting or the next setting within the environment table depending upon the contents of the receiving variable as follows:

1. If the variable is null, the first entry in the environment table is retrieved.

2. If the string variable contains an environment table keyword (such as COMSPEC, PATH, etc.), the data for that specific entry is retrieved. The keyword is case sensitive and no conversion is done. The entire keyword must be given. The OVER flag is set if no match is found, and cleared if a match is found. The EOS flag is set if the environment information is truncated to fit the variable.

3. If the variable contains an environment table keyword (as above), followed by an equal (=) sign, it retrieves the next entry in the environment table. The OVER flag is set if the end of the environment table is found, and cleared if the end of the environment table is not found. The EOS flag is set if the environment information is truncated to fit the variable.

4. PLBSERVE and clients support the 'CLOCK ENV' instruction. By adding a leading '!' character to the requested environment keyword, the CLOCK ENV instruction retrieves the keyword data from the client workstation.

5. The ENV keyword is not supported when using the PLBCE runtime.

See Also: Example Code, CLOCK, System Interface Instructions