How does the Endevor Multi-C1DEFLTS ENUXSITE (EN$DFTxx) work?

Products

• Endevor

Issue/Introduction

How does the Multi C1DEFLTS work?

Environment

Release : V18.1 with PTF SO12677 and V19.0 base.

Resolution

After PTF SO12677 is applied, the new ENUXSITE sample exit is available in iprfx.iqual.CSIQOPTN. The new ENUXSITE exit works by searching for a previously allocated DDNAME in the format EN$DFTxx. If a suitable DDNAME is found, ENUXSITE overlays the last two characters of the default C1DEFLTS table name with the characters (xx) from the DDNAME.

By default, there is a C1DEFLTS compiled and linked and this is the default named defaults table. To have more than one C1DEFLTS select a new name with the last 2 characters different than TS. If you select 01 then the new C1DEFLTS would be compiled and linked as C1DEFL01.

To select a C1DEFLTS called C1DEFL01, add this allocation to the Endevor login CLIST:

ALLOC FI(EN$DFT01) DUMMY SHR REU

Endevor then automatically selects an appropriate defaults table and propagates that table to any batch jobs that are submitted through the SCMM@LIB skeleton member. 

Batch jobs not generated by Endevor must have the DD allocation add to the JCL. 

//EN$DFT01 DD DUMMY

If no EN$DFTxx is allocated, then C1DEFLTS is used. 

 

Additional Information

Using ENUXSITE exit, Endevor Web Services can be configured to allow multiple users to utilize different C1DEFLTS against the same Endevor backend instance concurrently.

 

Using C1DEFLTS and C1DEFL01 as examples, follow the configuration steps below:

 

1. ENF Web Services Spawn Parameter File

Add the Web Services spawn parameter file name to the SPNPARMS DD in the ENF PROC JCL by adding these two lines:

// SPNPARn=ndvspawn,

// DD DISP=SHR,DSN=&OPTLIB(&SPNPARn)

 

The content for "ndvspawn" should contain two CCI definition sections for the web services.

***********************************************************************                                                                           
* CCI SERVICE STATEMENTS FOR EWS using C1DEFTLS                        
***********************************************************************      
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 ENDEVOR WEB SERVICES                         
*****************************************************************************  
               PROCESS PROCESS_TYPE=MVS_STC,                          
                   PROCNAME=WSEWSSTC,                                 
                   PARM='BC1PAPI0'                   
***********************************************************************      
* CCI SERVICE STATEMENTS FOR EWS using C1DEFTL01                       
***********************************************************************      
WSEWSST1       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 ENDEVOR WEB SERVICES                         
*****************************************************************************  
               PROCESS PROCESS_TYPE=MVS_STC,                          
                   PROCNAME=WSEWSST1,                                 
                   PARM='BC1PAPI0'          

 

 

2. Endevor Web Services Configuration Files

Located at $CATALINA_BASE/webapps/endevor/, you will need two configuration files, each pointing to a different JobName:

• Endevor.cfg: Uses JobName WSEWSSTC (pointing to C1DEFLTS).

• Endevor1.cfg: Uses JobName WSEWSST1 (pointing to C1DEFL01).

 

 

3. Endevor STC JCL (in PROCLIB)

• WSEWSSTC: Points to C1DEFLTS (use CSIQJCL(WSEWSSTC) as the sample).

• WSEWSST1: Points to C1DEFLT01. This is identical to WSEWSSTC, but requires the following additional line:

//EN$DFT01 DD DUMMY