SetCurEnv: задать имя системы

Директива #setCurEnv на время компиляции переключает имя системы с текущего на указанное в директиве. Это позволяет автоматически подцеплять необходимые ресурсы на стадии компиляции программы.

Директива должна находиться в самом начале кода vip-программы.

<имя-системы> - ресурсы, зарегистрированные в репозитарии для данной системы становятся доступными компилятору. Система должна присутствовать в репозитарии с непустым корректным путем.

<путь> - путь на систему. Путь должен существовать, в нем должны находиться требуемые ресурсы, их содержание должно быть корректным. В противном случае возможен аварийный выход из программы.

Если параметр <путь> задан, то при каждом перемещении системы необходимо править исходники программы. Поэтому данным параметром следует пользоваться осторожно.

Указанное имя системы действует в течение всего сеанса компиляции до его замены очередной директивой #setCurEnv. Если в тексте очередного компилируемого модуля данная конструкция отсутствует, то имя системы автоматически не переключается.

Если директива #setCurEnv перекрывает имя системы, указанное через пользовательский интерфейс либо через командную строку, на новое, то компилятор выдаст ошибку. Если же эти имена совпадают, то сообщения об ошибке не будет. Если в директиве задан путь, то сообщение об ошибке не выдается, если совпадает и имя системы и путь на нее.

Аналогично, при повторном переключении выдается ошибка, если имя новой системы и /или путь на нее отличаются от старых.