OUTFILE

Формат

{OUTFILE|OUTFIL}: [< спецификация файла >]|[CON]

Назначение

Спецификация выходного файла.

Описание

По умолчанию результаты выполнения команд и/или SQL-операторов inl выводит на экран видеотерминала пользователя (выходной файл по умолчанию). Для переназначения вывода используется команда OUTFILE:. Параметр < спецификация файла > задает местоположение и имя выходного текстового файла в формате соответствующей операционной системы, например, C:\linter\test\crt_table.tst.

Если в качестве выходного файла указано CON, то текущий выходной файл закрывается и вывод осуществляется на видеотерминал.

В выходной файл записываются:

  1. выборка данных select-запроса (в форматированном или неформатированном виде);

  2. заголовок выборки данных (определенный командой HEADER:);

  3. итоговая статистика.

Команда выполняется по следующим правилам:

  • устройство и каталог (каталоги), указанные в < спецификации файла > должны существовать на момент выполнения команды (автоматически не создаются);

  • если не указано местоположение выходного файла, он создается в текущем каталоге;

  • данные в выходной файл записываются в коде ASCII;

  • результаты выполнения SQL-оператора будут направляться в файл, определенный командой OUTFILE:, до тех пор, пока не будет произведено новое назначение выходного файла. При этом выходной файл, открытый предшествующей командой OUTFILE:, закроется и откроется новый специфицированный файл;

  • если в OUTFILE: указан файл, который уже существует, то выходные данные добавляются в этот файл;

  • комментарии, коды завершения и их диагностические сообщения всегда выдаются на экран видеотерминала;

  • команда OUTFILE: может быть введена как с терминала, так и из SQL-скрипта;

  • если параметр < спецификация файла > не указан, то в качестве выходного файла используется экран видеотерминала.

Примечания

  1. При запуске inl выходным файлом по умолчанию установлен экран видеотерминала.

  2. Узнать текущее имя выходного файла можно с помощью команды LIST.

Примеры

SQL >outfile:/usr/home/Fill.ans (в среде ОС UNIX)

;создание выходного файла в текущем каталоге
SQL >outfile:tst
…

;создание другого выходного файла в заданном каталоге
SQL >outfile:d:/linter/script/crt_db.sql
…
;перенаправление вывода на экран видеотерминала
SQL >outfile:con
…
;продолжение вывода в файл tst
SQL >outfile:tst
…