Web services Health Check "STC 'WSEWSSTC' is not correctly defined to ENF"

Products

• Endevor

Issue/Introduction

Endevor Web services new install and the Health Check fails with:

Check that the ENF service using hostname 'ABCD' has a definition for Endevor STC 'WSEWSSTC' in the SPNPARMS DD.

Health Check results for defined configurations:

Config	STC Job Name	CCI Host Name	Description	Status
ENDEVOR	WSEWSSTC	ABCD	Endevor 18.1	Failed
ENF (CAISPAWN) service available, but STC 'WSEWSSTC' is not correctly defined to ENF. Check that the ENF service using hostname 'ABCD' has a definition for Endevor STC 'WSEWSSTC' in the SPNPARMS DD.

The ENF SPNPARMS CAICCI definition is as follows:

********************************************************************            
ENDEVOR        SERVICE SERVER_NAME=MVS_START_SERVER,                            
                   DEALLOCATE=TERMINATE,                                        
                   LOST_CLIENT=DEALLOCATE,                                      
                   MAX#_SERVICES=100,                                           
                   MAX#_CLIENTS=1,                                              
                   MAX#_PROCESSES=100,                                          
                   SERVICE_UNAVAILABLE=START_SERVICE,                           
                   START=SPAWN_ONLY,                                            
                   SIGNON/NOPASSCHK=SERVICE                                     
                                                                 
********************************************************************            
**                                                                              
* CCI PROCESS STATEMENTS FOR CA ENDEVOR SCM WEB SERVICES                        
**                                                                              
********************************************************************            
               PROCESS PROCESS_TYPE=MVS_STC,                                    
                   PROCNAME=WSEWSSTC,PARM='BC1PAPI0'                            
               PROCESS PROCESS_TYPE=MVS_STC,PROCNAME=WSEWSSTC,PARM='BC1PAPI0'   
********************************************************************  

Here is a snippet from the ENF showing the spawn service as active:

15.56.04 STC22005  CAS9757I - CAICCI Spawn Manager now active                 
15.56.04 STC22005  CAS9641I - CAICCI Communication Manager now active         
15.56.10 STC22005  CAS9612I - CAICCI Host Application Table APPLID not defined
15.56.13 STC22005  CAS9767I - CAICCI Spawn Server now active                  
15.56.13 STC22005  CAS9626I - CAICCI Subsystem is operational                 

Environment

Endevor Web Services

Cause

The service definition with label ENDEVOR does not match the PROCNAME WSEWSSTC.
NOTE: All 3 parameters ENDEVOR.cfg JobName, ENF definition file label and PROCNAME should match. 

Resolution

Change the service definition label so it matches the PROCNAME i.e.

********************************************************************            
WSEWSSTC        SERVICE SERVER_NAME=MVS_START_SERVER,                            
                   DEALLOCATE=TERMINATE,                                        
                   LOST_CLIENT=DEALLOCATE,                                      
                   MAX#_SERVICES=100,                                           
                   MAX#_CLIENTS=1,                                              
                   MAX#_PROCESSES=100,                                          
                   SERVICE_UNAVAILABLE=START_SERVICE,                           
                   START=SPAWN_ONLY,                                            
                   SIGNON/NOPASSCHK=SERVICE                                     
                                                                 
********************************************************************            
**                                                                              
* CCI PROCESS STATEMENTS FOR CA ENDEVOR SCM WEB SERVICES                        
**                                                                              
********************************************************************            
               PROCESS PROCESS_TYPE=MVS_STC,                                    
                   PROCNAME=WSEWSSTC,PARM='BC1PAPI0'                            
               PROCESS PROCESS_TYPE=MVS_STC,PROCNAME=WSEWSSTC,PARM='BC1PAPI0'  
********************************************************************  


Then recycle both ENF and Tomcat. Upon starting Tomcat, ENF will also spawn WSEWSSTC.

Additional Information

In the past the sample CAICCI definition member CSIQOPTN(WSEWSCCI) had ENDEVOR as the label so in this scenario it was likely that old version was being used. It was later updated to have WSEWSSTC as the label.

Relevant Endevor 19.0 documentation page: Configure REST API and SOAP API (Web Services) > Enable the Web Services Backend STC
*****
Define the Started Task for Web Services
Web Services uses started tasks that are started by the CAICCI SPAWN facility to communicate with the Endevor API. Define these tasks to the spawn facility by adding a new spawn parameter member (ndvspawn) to the ENF procedure for CAICCI services. The ndvspawn parameter value specifies the name of a new member in the CCI options library, based on the WSEWSCCI sample in CSIQOPTN, which adds the spawn parameters for the WSEWSSTC started task.
*****


Additional note:
If ENF still can't submit WSEWSSTC, check the following techdocs page section for "Enable authorized users to initiate WSEWSSTC correctly as a started task" which redirects to "Security Software Customization for Web Services"
Endevor 19.0 documentation page: Configure REST API and SOAP API (Web Services) > Set Up Web Services Security


Related article 28758: Endevor Web Service fails to start with rc=12 and EWS0422E with SRC="23"