How to check the status of a sink machine that is down


Technique

Product: FOCUS
Release: 7709
Primary OS: z/OS
Solution Date:

Problem

How to check the status of a sink machine (SU, Simultaneous Usage, FOCUS Database Server).

Solution

If a database is updated via the Simultaneous Usage (SU) machine and the SU process is not running, then an error will be generated and the procedure will end. Checking to see if the SU is up will allow the procedure to try again before completely ending.

The status of the SU job can be determined by using the command:

? SU FOCSU

Then check the variable &RETCODE. Please note that FOCSU is the DDNAME of the SU communications dataset for the SU task. &RETCODE will have the following values:

0 - SU is up and has users attached

8 - SU is up with no users attached

16 - SU is not up

Logic can then be added to the FOCEXEC or procedure to loop a certain number of times if the SU task is not up before giving up to allow the SU job to be restarted.