Сообщения об ошибках и решение проблем

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

Сообщения об ошибках

Ошибки распределения памяти
Адаптер прекращает обработку, когда сталкивается с сообщением об ошибке распределения памяти.
BSE:_ermAlloc: ERROR: malloc FAILED: size 60
Эти сообщения указывают на прекращение работы из-за ошибки распределения памяти.
  • ERR: zSecRacfSearch: Entry creation returned failure
  • ERR: zSecRacfSearch: reconciliation ABORTED
В журнал адаптера записывается следующее конечное сообщение об ошибке:
ERR: FATAL memory error encountered, shutting down now
Ошибки распределения памяти или malloc часто возникают из-за нехватки размера кучи среды языка (Language Environment, LE) z/OS. Если произойдут ошибки malloc, используйте для адаптера указанные ниже параметры. Добавьте эти параметры в сценарий запуска адаптера, который находится в папке домашний_каталог_чтения_записи/bin:
RPTOPTS(ON),RPTSTG(ON)
экспортировать (export)
_CEE_RUNOPTS='HEAP(80K,8K,ANYWHERE,,1K,1K),AN(1450K,4K,ANY,FREE),AL(ON),
HEAPPOOLS(ON,8,8,16,16,24,17,32,3,56,8,72,3,136,4,296,7,480,3,848,4,
2080,4104,)'

RPTOPTS(ON),RPTSTG(ON) - необязательный параметр. Добавьте его, только если вы хотите включить запись диагностических данных в STC адаптера.

Если команды RACF выполняются с использованием вызываемой службы R_Admin IRRSEQ00, все ошибки, которые возвращает RACF, записываются в журнал адаптера. Если выполнить команду невозможно, адаптер запишет код возврата SAF, код возврата RACF и коды причин RACF в журнал адаптера, как показано в следующем примере:
ERR:15/05/01 11:48:47 issueRadmin: safRC = 8, racfRC = 8 racfReason = 24, 
returning rc =5

В этом примере у ADAPTERID или SURROGATID нет разрешения на доступ ко всем необходимым профилям, описанным в разделеКонфигурирование доступа. Дополнительную информацию о кодах возврата и кодах причин смотрите в разделе z/OS Security Server RACF Callable Services в Центре знаний z/OS.

Минимальное число символов в ключе конфигурации agentCfg
Ключ конфигурации не должен содержать менее 5 символов. В противном случае при использовании agentCfg для конфигурирования активного адаптера появится следующее сообщение:

Ключ конфигурации слишком короткий - минимум 5 символов. Операция прекращается...

После этого обработка agentCfg прервется.

Инициализация файла реестра
Инициализация файла реестра для следующих сценариев записывается в журнал syslog z/OS во время инициализации адаптера.
  1. Файл реестра, сконфигурированный в сценарии оболочки, который используется для запуска адаптера, не существует. В этом случае создается новый файл реестра, и в системный журнал записываются следующие сообщения:
    zSecRacfAgent: Registry file specified by environment
    REGISTRY is’<домашний_каталог_чтения_записи>/data/<имя_адаптера>.dat’
    zSecRacfAgent : REGISTRY does not exist
    zSecRacfAgent: Creating a new registry file
  2. Файл реестра существует, но не получить к нему доступ невозможно (например, неправильные разрешения на доступ к файлу). В этом случае адаптер прервет инициализацию и в системный журнал (syslog) будут записаны следующие сообщения:
    zSecRacfAgent: Registry files pecified by environment
    REGISTRY is’<домашний_каталог_чтения_записи>/data/<имя_адаптера>.dat’
    zSecRacfAgent : FATAL ERROR: REGISTRY file open error: EDC5111I Permission
    denied.
    zSecRacfAgent: can’t continue without access to the
    registry file r a c fAg e n t : exiting process
  3. Реестр существует, но адаптер не может получить доступ к той части, которая относится к пути. В этом случае адаптер прервет инициализацию и в системный журнал (syslog) будут записаны следующие сообщения:
    zSecRacfAgent: Registry file specified by environment
    REGISTRY is’<домашний_каталог_чтения_записи>/data/<имя_адаптера>.dat’
    zSecRacfAgent : FATAL ERROR: REGISTRY file stat error:
    EDC5111I Permission denied.
    zSecRacfAgent: can’t continue without access to the
    registry file zSecRacfAgent : exiting process
  4. Реестр существует, но он не задан в сценарии оболочки, который используется для запуска адаптера. В этом случае создается новый файл реестра в каталоге /tmp, и в системный журнал записываются следующие сообщения:
    zSecRacfAgent: WARNING no REGISTRY file specified by the
    environment zSecRacfAgent: Creating a new registry file
    zSecRacfAgent : Registry to be created
    is’/tmp/<имя_адаптера>.dat’
Параметры максимального числа потоков для операций адаптера
При инициализации адаптера для всех операций адаптера (поиск, изменение, добавление, удаление) назначается максимальное число потоков по умолчанию, равное трем. При инициализации адаптера для всех операций адаптера назначается минимальное число потоков по умолчанию, равное одному, так как для выполнения операции требуется хотя бы один поток. Теперь адаптер записывает в журнал адаптера отладочные сообщения, касающиеся числа потоков, которые в настоящий момент все еще доступны для выполнения новых операций. Это позволяет лучше понять, какие задержки, связанные с доступностью потоков, возможны при обработке.
Запуск адаптера в режиме консоли
Для отладки запустите адаптер непосредственно с консоли. Все сообщения, записываемые в системный журнал или в журнал адаптера, появятся на консоли, с которой вы запустили адаптер. Чтобы запустить адаптер в режиме консоли, запустите все команды экспорта, сконфигурированные в сценарии оболочки, который используется для запуска адаптера. Эта задача позволяет сделать так, чтобы адаптеру были доступны все библиотеки. Введите следующую команду, чтобы запустить адаптер:
/<домашний_каталог_только_чтения_адаптера/lpp/bin/zSecRacfAgent -name <имя_адаптера> -registry
<домашний_каталог_чтения_записи_адаптера>/data/<имя_адаптера>.dat -console
CKGRACF returns rc 20
CKG740I 20 Для выполнения CKGRACF нужна авторизация APF. Смотрите раздел ID пользователя RACF.
CKGRACF returns rc 8
CKG604I 08 Отказано в доступе UPDATE к командному ресурсу XFACILIT CKG.CMD.CMD.EX.PERMIT для команды в строке PARM.

CKG107I 08 Команда завершилась с кодом результата 8.

CKG111I 08 Наибольший код результата - 8.

Смотрите раздел ID пользователя RACF.

Сообщения сервера

В следующей таблице содержатся предупреждения или ошибки, которые адаптер возвращает серверу.
Табл. 1. Сообщения об ошибках и предупреждениях и действия по их устранению
Сообщение об ошибке или предупреждение Дополнительные предупреждения, сообщения или информация Действия по устранению ошибки
Сообщение об ошибке адаптера: не удалось задать среду защиты для SURROGAT. Журнал адаптера: ERR:14/07/31 10:42:31 zSecRacfSearch: не удалось создать pthread_security_ np(). errno2=0BE800D8: EDC5139I Операция не разрешена Разрешите доступ на чтение (READ) для IGIAGNT на BPX.SERVER в CLASS FACILITY
zSecRacfSearch: не удалось создать поток RECOJOB Системный журнал z/OS может выдать сообщение INSUFFICIENT AUTHORITY Убедитесь, что у RACF ID и SURROGAT ID адаптера есть доступ к каталогу данных READWRITE с правом чтения и записи.
Не удалось задать среду защиты для пользователя SURROGAT Неприменимо Разрешите доступ для чтения (READ) для IGIAGNT на BPX.SRV.<SURROGATID> в CLASS SURROGAT
zSecRacfSearch: не удалось создать поток RECOJOB Журнал DETAILAdapter: tsoCmd: результат - IKJ56644I НЕТ ДЕЙСТВИТЕЛЬНОГО TSO USERID, ИСПОЛЬЗУЮТСЯ АТРИБУТЫ ПОЛЬЗОВАТЕЛЯ DEF AUL T Убедитесь, что у ID адаптера есть действительный TSO USERID.
CTGIMU107W Не удается установить соединение с указанной службой. Проверьте информацию о службе и повторите попытку. Произошла ошибка ввода-вывода при отправке требования. Ошибка: Отказ в соединении: connect Убедитесь, что служба адаптера работает. Дополнительную информацию о том, как запустить службу адаптера, смотрите в разделе Перезапуск службы адаптера.
  Адаптер возвратил состояние ошибки для требования привязки. Код состояния: сообщение об ошибке недопустимых учетных данных адаптера: Аутентификация завершилась неудачно Убедитесь, что ID аутентификации адаптера и пароль совпадают с установленными значениями. Смотрите окно параметров, связанных с адаптером, в разделе Запуск диалогового окна ISPF.
  Произошла ошибка ввода-вывода при отправке требования. Ошибка: com.ibm.daml.jndi. JSSESocketConnection .HANDSHAKE_FAILED: Если включена поддержка SSL, проверьте конфигурацию. Смотрите раздел Конфигурирование аутентификации SSL. В журнале адаптера содержатся сведения о сертификатах, загруженных во время инициализации.
CTGIMD812E Произошла ошибка при обработке ответного сообщения адаптера. Произошла следующая ошибка: Ошибка: Преждевременный конец файла.   Убедитесь, что служба адаптера работает. Дополнительную информацию о запуске службы адаптера смотрите в разделе Перезапуск службы адаптера
tsoCmd: результат - ВАШ АДМИНИСТРАТОР TSO ДОЛЖЕН РАЗРЕШИТЬ ИСПОЛЬЗОВАНИЕ ЭТОЙ КОМАНДЫ Неприменимо. Разрешите доступ для чтения (READ) для IGIAGNT на JCL в CLASS TSOAUTH

Например: PE JCL CLASS(TSOAUTH) ID(IGIAGNT) ACCESS(READ)SETROPTS RACLIST(TSOAUTH) REFRESH

tsoCmd: Задание RECOJOB не передано tsoCmd: результат: <строка результата>

zSecRacfSearch: не удалось инициировать reco_open

Убедитесь, что строка результата является стандартным сообщением TSO, заданным в SYS1.MSGENU(IKJSCHEN).

Если реализуется пользовательский обработчик, который возвращает нестандартное сообщение, исключите задание согласования из этого обработчика.

LDAP: код ошибки 92   Увеличьте размер журнала транзакций.

Смотрите раздел Размер журнала транзакций DB2.

*BPXI040I PROCESS LIMIT MAXPROCUSER HAS REACHED XX % OF ITS CURRENT CAPACITY OF XX FOR PID=XXX IN JOB ISIAGNT  

Увеличьте число процессов, доступных для adapterid.