Datacom/AD with Common Services/ENF external Multi-User Facility (called MUF) will not shut down.
search cancel

Datacom/AD with Common Services/ENF external Multi-User Facility (called MUF) will not shut down.

book

Article ID: 18815

calendar_today

Updated On:

Products

Datacom DATACOM - AD COMMON SERVICES FOR Z/OS Common Services

Issue/Introduction

Datacom/AD with Common Services/ENF, using the MUF as a separate task external to ENF and the MUF will not shut down.

Resolution

Normally, the Common Services/ENF Multi-User Facility (called MUF) is run within the ENF address space through the use of the ENFIMUF proc and the "IMUF" statement in the ENFPARMS file. In this circumstance, shutting down ENF will also shut down the MUF.

However, in cases where the MUF is run standalone, or externally to the CA ENF task, management of the MUF must be handled separately from ENF. In this traditional MUF configuration, the applications using the MUF must end before the MUF can be shut down. In many cases, it is possible to issue the command to shut down the MUF (/F mufname,EOJ), and when the last application task has disconnected, the MUF will complete its termination processing.

In the case of the ENF processing with the MUF, issuing the EOJ command prior to ending ENF will cause the MUF to wait for ENF to complete its processing. Unfortunately, one of the last pieces of work done by ENF involves database work, so you could have a situation where the MUF is waiting for ENF to finish, and ENF is waiting for the MUF to be available so it can finish.

In the scenario where the EOJ command is issued before ENF has ended, you will see something like this on a Console Status (/F mufname,STATUS):

DB01311I - STATUS
DB01327I - MULTI-USER EOJ IN PROCESS, TASKS - ATTACHED-----1, AVAILABLE---249
DB01328I - TIME I/O JOBNAME R-UNIT TASK CMD-DBID-TBL SEQ STATUS
DB01330I - ENF 56448 1 NOT ACTIVE

The normal response would be to issue the command to end ENF (/P enfname). This would result in messages like these:

CAS9337I - DBC/API initialized successfully.
CAS9349I - DBC entering quiesce mode due to DB drain detect
CAS9214I - CA-ENF Command: SPL,CLOSE
CAS9368E - Error processing command : SPL / function : LOAD RC = 00000012
CAS9337I - DBC/API initialized successfully.
CAS9349I - DBC entering quiesce mode due to DB drain detect
CAS9337I - DBC/API initialized successfully.

In this situation, you need to "turn off" the EOJ command for the MUF so that ENF can complete its processing. To do this, issue the EOJOFF command to the MUF (/F mufname,EOJOFF), and once the ENF task has ended, you can once again issue the EOJ command to the MUF.

Additional Information