BQRunAt - функционал bq.sh для запуска внешних команд при старте/останове брокера БД

Версия: bq.sh ver. 4.6.2 TT#: ???

Обеспечение возможности запуска настраиваемых shell-команд в привязке к событиям старта и останова брокера БД. Предусмотрено до пяти команд, выполняющихся непосредственно перед моментом запуска брокера, столько же после успешного запуска и такое же количество команд, выполняющихся до и после останова брокера.

Все управление функционалом реализуется путем установки переменных окружения (обычно в запускающем скрипте). Предусмотрены следующие переменные:

    BQRunAtEnabled=yes   # включение функционала BQRunAt

  BQRunAtStart{05,04,03,02,01}=<команда/скрипт shell>	  # ПЕРЕД стартом
  BQRunAtStart{1,2,3,4,5}=<команда/скрипт shell>	       # ПОСЛЕ старта
 
  BQRunAtStop{5,4,3,2,1}=<команда/скрипт shell>	       # ПЕРЕД остановом
  BQRunAtStop{01,02,03,04,05}=<команда/скрипт shell>	  # ПОСЛЕ останова

  BQRunAtUUser={<unix-user>,.} # unix-user для выполнения всех команд BQRunAt
     «bis»  - значение по умолчанию
     «.»    - текущий пользователь (под которым выполняется bq.sh в данный момент)
 
  BQRunAt{Start|Stop}<NN>UUser={<unix-user>,.}
      # unix-user для выполнения конкретной команды BQRunAt{Start|Stop}<<NN>

BQRunAt{Start|Stop}<NN>Verbosе={0,1,2,3}        # уровень сообщений
   0 – сообщение отсутствует
   1 – выводится UUser и имя соответствующей переменной (BQRunAt…)
	2  - UUser, имя переменной и первое слово заданной команды
      3 – UUser, имя переменной и вся команда целиком (с аргументами)
      по умолчанию: 2

Для включения функционала необходимо установить переменную окружения BQRunAtEnabled=yes. Любое другое значение BQRunAtEnabled, в т.ч. пустое или неопределенное, отключает функционал.

Команды, которые необходимо привязать к событию старта брокера БД, задаются переменными вида BQRunAtStartNN, где NN – числовое значение, определяющее порядок выполнения заданной команды. Аналогично, переменные BQRunAtStopNN задают команды, привязанные к событию останова брокера БД. Если NN начинается на ‘0’, то соответствующая команда выполняется при остановленном брокере БД. Если NN состоит из одной цифры от 1 до 5, то данная команда будет выполняться при запущенном брокере БД. Значение NN определяет приоритет команды: чем оно по модулю меньше, тем ближе к событию старта/останова будет выполняться команда. Т.е., команды со значениями 01 и 1 будут ближе по времени к этим событиям, чем команды 05 и 5.

Таким образом, последовательность выполнения команд будет следующая:

BQRunAtStart05
BQRunAtStart04
BQRunAtStart03
BQRunAtStart02
BQRunAtStart01
<старт брокера БД>
<старт всех включенных batch-процессов>
<старт всех заданных логин-брокеров (as,ws,ns)>
<старт служебных процессов (APW,BIW,AIW,WDOG)>
BQRunAtStart1
BQRunAtStart2
BQRunAtStart3
BQRunAtStart4
BQRunAtStart5

Важно: блок BQRunAtStart[1-5] выполняется только в случае успешного старта брокера БД.

BQRunAtStop5
BQRunAtStop4
BQRunAtStop3
BQRunAtStop2
BQRunAtStop1
<останов брокера БД>
BQRunAtStop01
BQRunAtStop02
BQRunAtStop03
BQRunAtStop04
BQRunAtStop05

Важно: Все команды BQRunAtStopNN выполняются вне зависимости от успешности выполнения команды останова брокера БД.

Никаких пауз или ожиданий при выполнении команд BQRunAt не производится. Команды выполняются в среде, установленной скриптом bq.sh, то есть все основные переменные определены и доступны. Также следует учитывать, что в PATH к этому моменту будут добавлены каталоги $DLC/bin и $BQ/bin, что позволяет во многих случаях не указывать полный путь при настройке команд BQRunAt.

При использовании подстановок shell-переменных в настойке команд BQRunAt следует учитывать, что неэкранированные переменные подставляются в момент определения BQRunAt, а экранированные – в момент выполнения. Например, запись:

  BQRunAtStart3=”$PROEXE $BQDB -pf $BQPF –p my-procedure.p”

не приведет к желаемому результату, т.к. переменная PROEXE определяется в самом bq.sh и на момент задания BQRunAtStart3 еще не доступна. Подстановка же переменных BQDB и BQPF будет успешной, если определение BQRunAtStart3 идет в запускающем скрипте после определения этих переменных. Для описанного применения следует использовать такую запись:

  BQRunAtStart3=”\$PROEXE $BQDB -pf $BQPF –p my-procedure.p”

Или такую:

  BQRunAtStart3=’$PROEXE $BQDB -pf $BQPF –p my-procedure.p’

Во втором и третьем случае все переменные указанной команды подставляются только в момент запуска BQRunAtStart3.

Все команды выполняются с полномочиями, определяемыми переменной BQRunAtUUser, в которой указывается имя unix-пользователя.