Замечания по выпуску

37.1 db2ArchiveLog (новый API)

db2ArchiveLog

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

Авторизация

Одни из следующих:

• sysadm
• sysctrl
• sysmaint
• dbadm

Необходимое соединение

Этот API автоматически устанавливает соединение с указанной базой данных. Если соединение с указанной базой данных уже существует, API возвращает ошибку.

Файл включения API

db2ApiDf.h

Синтаксис API C

/* Файл: db2ApiDf.h */
/* API:  архивировать активный журнал */
SQL_API_RC SQL_API_FN
   db2ArchiveLog (
      db2Uint32 version,
      void *pDB2ArchiveLogStruct,
      struct sqlca * pSqlca);
 
typedef struct
{
   char                *piDatabaseAlias;
   char                *piUserName;
   char                *piPassword;
   db2Uint16           iAllNodeFlag;
   db2Uint16           iNumNodes;
   SQL_PDB_NODE_TYPE   *piNodeList;
   db2Uint32           iOptions;
} db2ArchiveLogStruct

Общий синтаксис API

/* Файл: db2ApiDf.h */
/* API:  архивировать активный журнал */
SQL_API_RC SQL_API_FN
   db2gArchiveLog (
      db2Uint32 version,
      void *pDB2ArchiveLogStruct,
      struct sqlca * pSqlca);
 
typedef struct
{
   db2Uint32           iAliasLen;
   db2Uint32           iUserNameLen;
   db2Uint32           iPasswordLen;
   char                *piDatabaseAlias;
   char                *piUserName;
   char                *piPassword;
   db2Uint16           iAllNodeFlag;
   db2Uint16           iNumNodes;
   SQL_PDB_NODE_TYPE   *piNodeList;  
   db2Uint32           iOptions;
} db2ArchiveLogStruct

Параметры API

version

Входной. Задает уровень версии и выпуска для переменной, передаваемой во втором параметре, pDB2ArchiveLogStruct.

pDB2ArchiveLogStruct

Входной. Указатель на структуру db2ArchiveLogStruct.

pSqlca

Выходной. Указатель на структуру sqlca.

iAliasLen

Входной. 4-байтное целое без знака, равное длине (в байтах) алиаса базы данных.

iUserNameLen

4-байтное целое без знака, задающее длину в байтах имени пользователя. Если имя пользователя не используется, имеет значение 0.

iPasswordLen

Входной. 4-байтное целое без знака, задающее длину в байтах пароля. Задайте равным нулю, если пароль не используется.

piDatabaseAlias

Входной. Строка, содержащая алиас (как он внесен в системный каталог баз данных) базы данных, для которой надо архивировать активный журнал.

piUserName

Входной. Строка, содержащая имя пользователя для попытки соединения.

piPassword

Входной. Строка, содержащая пароль для попытки соединения.

iAllNodeFlag

Только для MPP. Входной. Флаг, указывающий, надо ли применять операцию ко всем узлам, перечисленным в файле db2nodes.cfg. Допустимые значения:

DB2ARCHIVELOG_NODE_LIST

Применяется на узлах из переданного в параметре piNodeList списка.

DB2ARCHIVELOG_ALL_NODES

Применяется на всех узлах. piNodeList должен иметь значение NULL. Это значение по умолчанию.

DB2ARCHIVELOG_ALL_EXCEPT

Применяется на всех узлах, кроме узлов из переданного в параметре piNodeList списка.

iNumNodes

Только для MPP. Входной. Задает число узлов в списке piNodeList.

piNodeList

Только для MPP. Входной. Указатель на массив номеров узлов, на которых выполняется операция архивирования журнала.

iOptions

Входной. Зарезервирован для будущего использования.