The UKO Agent includes self-tests that can be executed to verify correct setup of the UKO Agent and UKO repository database.
The following self-tests are run by the UKO Agent and will check that the UKO Agent:
- Is allowed to call the required ICSF services
- Is configured to allow a (specified) client RACF/SAF user ID to log on
This additional self-test JCL is submitted by the user ID for whom the database access test should be done.
Once all tests pass without errors, the setup and configuration of the UKO Agent and UKO repository database is complete.
The UKO Agent splits its self-tests into different tests. Each test is activated using a parameter in the UKO Agent's option data set. These parameters are described in detail in the KMGPARM options reference.
To instruct the UKO Agent to run the self-tests, set the following parameters in the UKO Agent's option data set:
&SELFTEST-CSFmust be set to
&SELFTEST-CLIENTmust be set to the user id that should be tested. Note that this is NOT the user id of the UKO Agent started task.
Restarting the UKO Agent will run the self-tests and the result will be available in the UKO Agent job log output. Each self-test can be rerun on demand, using modify commands, as described in UKO Agent operation.
Once all tests have completed successfully, the
&SELFTEST-\* parameters can be removed from the UKO Agent's options. This will stop the UKO Agent from running the self-tests every time it starts, and it will disable the corresponding
modify commands that runs the self-tests on demand.
These self-tests should be run for each UKO Agent, to verify that each UKO Agent has been configured correctly, and that the given user can log on to all UKO Agents.
&SELFTEST-CLIENT output will look like the following:
KMG839I <<< START TESTING CLIENT ACCESS FOR EKMFCLT - LOGON TO EKMF Agent OK - AUDITOFF ALLOWED BY TASK AND USER - LOGON AS BROWSER OK
Note: Only the first test needs to pass. The other tests are not required for UKO.
&SELFTEST-CSF output will look like the following:
KMG829I <<< START TESTING ACCESS TO CSFSERV RESOURCES KMG831I CSFENC OK KMG831I CSFCRC OK KMG831I CSFDEC OK KMG831I CSFIQF OK KMG831I CSFKDMR OK KMG831I CSFKDMW OK KMG831I CSFKDSL OK KMG831I CSFKIM OK KMG831I CSFKYT OK KMG831I CSFKYT2 OK KMG831I CSFMGN OK KMG831I CSFMVR OK KMG831I CSFKRR2 OK KMG831I CSFKRC2 OK KMG831I CSFKRW OK KMG831I CSFKRW2 OK KMG831I CSFKRD OK KMG831I CSFOWH OK KMG831I CSFPKG OK KMG831I CSFPKI OK KMG831I CSFPKX OK KMG831I CSFSYI OK KMG831I CSFSYI2 OK KMG831I CSFDSV OK KMG831I CSFPKRC OK KMG831I CSFPKRR OK KMG831I CSFPRR2 OK KMG831I CSFPKRW OK KMG831I CSFPKRD OK KMG831I CSFSYX OK KMG831I CSFDSG OK KMG831I CSFEDH OK KMG831I CSFRNGL OK KMG831I CSFSAD OK KMG831I CSFSAE OK KMG830I >>> END TESTING ACCESS TO CSFSERV RESOURCES