Implementing secondary authids with ACF2 supplied exits for DB2 [email protected] and [email protected] abend S0C1 after LU00294.

Products

• ACF2
• ACF2 - DB2 Option
• ACF2 - z/OS
• ACF2 - MISC

Issue/Introduction

Relinking the ACF2 for z/OS provided exits for DB2 - [email protected] and [email protected] to implement secondary authid processing now gets an S0C1 abend after LU00294  

Note that [email protected] and [email protected] are linked as [email protected] and [email protected]

Environment

Release:
Component: ACF2DB

Resolution

The source for these two exits can be found in CAX1MAC0 library supplied with the base ACF2 for z/OS product, not with the ACF2 for DB2 product. Within this source there are a lot of comments. These comments include details for assembling and linking the modules. Please make sure that you have not missed any csects that need to be included.

For [email protected]

*                                                             
* ASSEMBLY INSTRUCTIONS                                       
*                                                             
* THE CA ACF2 SAMPLE CONNECTION AUTHORIZATION EXIT MUST BE    
* ASSEMBLED USING YOUR DB2 MACRO LIBRARY AND THE OBJECT       
* PLACED INTO THE CAI.ACF2.ACFOBJ LIBRARY FOR THE LINKAGE     
* EDITOR STEP THAT FOLLOWS.                                   
*                                                             
* //ASM      EXEC PGM=IEV90,REGION=0M,PARM='DECK'             
* //SYSUT1   DD UNIT=SYSDA,SPACE=(1700,(600,100))             
* //SYSPRINT DD SYSOUT=*                                      
* //SYSLIB   DD DSN=CAI.CAX1MAC0,DISP=SHR                     
* //         DD DSN=DSN220.SDSNMACS,DISP=SHR  << DB2 MACRO LIB
* //         DD DSN=SYS1.MACLIB,DISP=SHR                      
* //         DD DSN=SYS1.MODGEN,DISP=SHR                      
* //SYSIN    DD DIAP=SHR,DSN=CAI.AAX1MAC0([email protected])           
* //SYSPUNCH DD DISP=SHR,DSN=CAI.ACF2.ACFOBJ([email protected])        
*                                                             
* LINKAGE EDITOR INSTRUCTIONS                                 
*                                                             
* THE CA ACF2 SAMPLE CONNECTION AUTHORIZATION EXIT MUST       
* BE LINKED INTO THE DB2 DSNEXIT LIBRARY WITH A MODULE        
* NAME OF [email protected] THE FOLLOWING SAMPLE JCL CAN BE USED      
* AS A GUIDE TO LINK THE CA ACF2 SAMPLE EXIT.                 
*                                                             
* //LINK  EXEC PGM=IEWL,PARM='LET,LIST,XREF,NCAL,RENT,REUS'   
* //SYSPRINT  DD SYSOUT=*                                     
* //SYSLMOD   DD DSN=DSN220.DSNEXIT,DISP=SHR                  
* //SYSUT1    DD UNIT=SYSDA,SPACE=(TRK,(10,10))               
* //ACFOBJ    DD DSN=CAI.ACF2.ACFOBJ,DISP=SHR                 
* //ACFMOD    DD DSN=CAI.AAX1MOD0,DISP=SHR                    
* //          DD DSN=CAI.AAX1MOD1,DISP=SHR                    
* //SYSLIN    DD *                                            
*  INCLUDE ACFOBJ([email protected])                                   
*  INCLUDE ACFMOD(ACF$GCVT)                                   
*  INCLUDE ACFMOD(ACF$FGCB)                                   
*  INCLUDE ACFMOD(ACF00SSL)                                   
*  INCLUDE ACFMOD(CMCTABLE)                                   
*  INCLUDE ACFMOD(SAFFBSCH)  
*  INCLUDE ACFMOD(SAFFBSC6)          needed after LU00294
*  INCLUDE ACFMOD(SAFFFSCN)     
*  MODE    AMODE(31),RMODE(ANY) 
*  ENTRY   [email protected]             
*  NAME    [email protected](R)          
* /*                            
*                                               

For [email protected]

*                                                             
* ASSEMBLY INSTRUCTIONS                                       
*                                                             
* THE CA ACF2 SAMPLE SIGNON AUTHORIZATION EXIT MUST BE        
* ASSEMBLED USING YOUR DB2 MACRO LIBRARY AND THE OBJECT       
* PLACED INTO THE CAI.ACF2.ACFOBJ LIBRARY FOR THE LINKAGE     
* EDITOR STEP THAT FOLLOWS.                                   
*                                                             
* //ASM      EXEC PGM=IEV90,REGION=0M,PARM='DECK'             
* //SYSUT1   DD UNIT=SYSDA,SPACE=(1700,(600,100))             
* //SYSPRINT DD SYSOUT=*                                      
* //SYSLIB   DD DSN=CAI.CAX1MAC0,DISP=SHR                     
* //         DD DSN=DSN220.SDSNMACS,DISP=SHR  << DB2 MACRO LIB
* //         DD DSN=SYS1.MACLIB,DISP=SHR                      
* //         DD DSN=SYS1.MODGEN,DISP=SHR                      
* //SYSIN    DD DIAP=SHR,DSN=CAI.AAX1MAC0([email protected])           
* //SYSPUNCH DD DISP=SHR,DSN=CAI.ACF2.ACFOBJ([email protected])        
*                                                             
* LINKAGE EDITOR INSTRUCTIONS                                 
*                                                             
* THE CA ACF2 SAMPLE SIGNON AUTHORIZATION EXIT MUST           
* BE LINKED INTO THE DB2 DSNEXIT LIBRARY WITH A MODULE        
* NAME OF [email protected] THE FOLLOWING SAMPLE JCL CAN BE USED      
* AS A GUIDE TO LINK THE CA ACF2 SAMPLE EXIT.               
*                                                           
* //LINK  EXEC PGM=IEWL,PARM='LET,LIST,XREF,NCAL,RENT,REUS' 
* //SYSPRINT  DD SYSOUT=*                                   
* //SYSLMOD   DD DSN=DSN220.DSNEXIT,DISP=SHR                
* //SYSUT1    DD UNIT=SYSDA,SPACE=(TRK,(10,10))             
* //ACFOBJ    DD DSN=CAI.ACF2.ACFOBJ,DISP=SHR               
* //ACFMOD    DD DSN=CAI.AAX1MOD0,DISP=SHR                  
* //          DD DSN=CAI.AAX1MOD1,DISP=SHR                  
* //SYSLIN    DD *                                          
*  INCLUDE ACFOBJ([email protected])                                 
*  INCLUDE ACFMOD(ACF$GCVT)                                 
*  INCLUDE ACFMOD(ACF00SSL)                                 
*  INCLUDE ACFMOD(CMCTABLE)                                 
*  INCLUDE ACFMOD(SAFFBSCH)    
*  INCLUDE ACFMOD(SAFFBSCH6)  Needed after LU00294                             
*  INCLUDE ACFMOD(SAFFFSCN)                                 
*  MODE    AMODE(31),RMODE(ANY)                             
*  ENTRY   [email protected]                                         
*  NAME    [email protected](R)                                      
* /*                                                        

 

Additional Information

Note that [email protected] and [email protected] are linked as [email protected] and [email protected]

also note: If only a relink is being done and the reassembly of [email protected] or [email protected] is not being performed, 
The relink statements should be

//SYSLIN    DD * 
  INCLUDE ACFMOD(ACF$GCVT) 
  INCLUDE ACFMOD(ACF00SSL)                                 
  INCLUDE ACFMOD(CMCTABLE)                        
  INCLUDE ACFMOD(SAFFBSCH)    
  INCLUDE ACFMOD(SAFFBSCH6)                         Needed after LU00294 
  INCLUDE ACFMOD(SAFFFSCN)      
  INCLUDE DSNEXIT([email protected])                        
  MODE    AMODE(31),RMODE(ANY)   
  ENTRY   [email protected]                                        
  NAME    [email protected](R)                     

 //SYSLIN    DD *                                            
  INCLUDE ACFMOD(ACF$GCVT)                                 
  INCLUDE ACFMOD(ACF$FGCB)                                   
  INCLUDE ACFMOD(ACF00SSL)                                   
  INCLUDE ACFMOD(CMCTABLE)                                   
  INCLUDE ACFMOD(SAFFBSCH)  
  INCLUDE ACFMOD(SAFFBSC6)          needed after LU00294
  INCLUDE ACFMOD(SAFFFSCN)     
  INCLUDE DSNEXIT([email protected])
  MODE    AMODE(31),RMODE(ANY) 
  ENTRY   [email protected]             
   NAME    [email protected](R)