Agent verification

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-CSF must be set to ON.
• &SELFTEST-CLIENT must 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.

A typical &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.

A typical &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