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.
- 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'.
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.
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