Usando o Conteúdo do XAPLDIAG

O módulo de controle de acesso do RACF retorna um parâmetro, XAPLDIAG, que o Db2 e outros programas licenciados podem usar para capturar e obter informações de diagnóstico.

Quando o módulo de controle de acesso do RACF emitir a macro RACROUTE REQUEST=FASTAUTH para verificação de autorização, dependendo das opções de AUDITORIA usadas com a verificação, o módulo poderá registrar o código de retorno SAF resultante, o código de retorno do RACF e o código de razão do RACF no XAPLDIAG. Cada chamada do módulo de controle de acesso do RACF pode emitir múltiplas macros RACROUTE REQUEST=FASTAUTH, mas o módulo avalia cada código de retorno gerado e determina o único código de retorno correto a ser enviado ao Db2.

O módulo de controle de acesso do RACF pode armazenar até 20 conjuntos de códigos de retorno das macros RACROUTE REQUEST=FASTAUTH no XAPLDIAG, permitindo que os resultados de uma macro RACROUTE REQUEST=FASTAUTH específica seja determinado.

A lista de parâmetros XAPL pode ser capturada usando o registro de rastreio IFCID 314 do Db2. Além disso, o código de retorno e o código de razão correspondentes (EXPLRC1 e EXPLRC2) para falhas de autorização são capturados no registro de rastreio IFCID 140 do Db2.

O conteúdo do XAPLDIAG depende do código de retorno e do código de razão a partir do módulo de controle de acesso do RACF. Os códigos de retorno e de razão no XAPLDIAG estão na mesma ordem que a das verificações que são descritas na tabela de regras para cada privilégio. É possível usar essa ordem para determinar quais verificações falharam e quais verificações concederam acesso.

  • Se EXPLRC1=4 e ECPLRC2=14 (decimal), o ALESERV falhou e o módulo não fez nenhuma verificação de RACROUTE REQUEST=FASTAUTH. Nesse caso, a primeira palavra de XAPLDIAG contém o código de retorno de ALESERV diferente de zero.
  • Caso contrário, cada palavra de XAPLDIAG poderá conter um código de retorno do SAF, o código de retorno do RACF e o código de razão do RACF correspondente a um código de retorno diferente de zero a partir de uma macro RACROUTE REQUEST=FASTAUTH. As informações relacionadas aos códigos de retorno diferentes de zero são armazenadas no XAPLDIAG que iniciam com a primeira palavra até que as informações relacionadas a todos os códigos de retorno diferentes de zero tenham sido armazenados ou até que a área do XAPLDIAG tenha sido preenchida. O XAPLDIAG contém 20 palavras, permitindo que as informações relacionadas a 20 solicitações de FASTAUTH sejam armazenadas para uma chamada do módulo de controle de acesso do RACF. Se mais de 20 solicitações de FASTAUTH forem emitidas, apenas os primeiros 20 conjuntos de códigos de retorno serão armazenados.
A verificação de autorização DBADM para o privilégio CREATE VIEW pode resultar em mais de 20 solicitações de FASTAUTH porque uma solicitação CREATE VIEW pode fazer referência às tabelas ou a uma combinação de tabelas e visualizações, a partir de diversos bancos de dados. O Db2 passa os nomes de todos os bancos de dados referenciados na CREATE VIEW usando uma lista de bancos de dados apontada por XAPLDBSP. Se a verificação de autorização SYSCTRL ou SYSADM não conceder o privilégio CREATE VIEW e o campo XAPLCRVW indicar que DBACRVW está ativado, o módulo de controle de acesso do RACF verificará a autorização DBADM do usuário para cada banco de dados na lista. O resultado de cada verificação de DBADM é colocado no campo XAPLDBDA associado a cada banco de dados. O módulo de controle de acesso do RACF atualiza o XAPLDBDA com os seguintes códigos:
S
O acesso ao banco de dados é permitido.
N
O acesso ao banco de dados não é permitido.
U
O RACF não pôde retornar uma decisão. Isso ocorre quando a solicitação de FASTAUTH retorna um código de retorno de SAF de X'04'.
A lista de bancos de dados apontada para XAPLDBSP é composta por estruturas de informações do banco de dados de quatro palavras mapeadas pela macro XAPLDBS.
XAPLDBNP DS F     PTR TO NEXT DATABASE INFORMATION STRUC
XAPLDBNM DS CL8   DATABASE NAME
XAPLDBDA DS CL1   'Y' - IS DBADM
XAPLDBIM DS CL1   'Y' - IS AN IMPLICIT DATABASE
XAPLRSV5 DS CL2   RESERVED - UNUSED 

Embora as verificações de DBADM possam ser feitas para diversos bancos de dados, apenas os resultados das 20 primeiras solicitações de FASTAUTH são armazenadas no XAPLDIAG. Os resultados de toda a verificação de DBADM para cada banco de dados estão contidos na lista de parâmetros XAPL e ela está disponível usando o registro de rastreio IFCID 314 do Db2.

O módulo de controle de acesso do RACF trunca os códigos de retorno SAF e os códigos de retorno do RACF para um byte e o código de razão do RACF para dois bytes, antes de armazená-los no XAPLDIAG. O formato de cada palavra no XAPLDIAG é:
xxyyzzzz
em que:
xx
é o código de retorno do SAF de 1 byte
yy
é o código de retorno do RACF de 1 byte
zzzz
é o código de razão do RACF de 2 bytes