Configuring the Listener PROC

About this task

The basic listener sample:
//IAYLSTNR PROC TCPIP=TCPIP,PORT=46000,MAXTASK=20,PROGRAM=IAYCONN,  
//HOSTCP=00037,CLNTCP=00850                               
//LISTEN EXEC PGM=IAYLISPR,                                         
//PARM='&TCPIP,&PORT,&MAXTASK,&PROGRAM,N,&HOSTCP,&CLNTCP,N',
//REGION=0M,TIME=NOLIMIT  
//STEPLIB DD DSN=IAYV143.MVS110.LOADLIB,DISP=SHR <-- the agents loadlib
//CPEOUT DD SYSOUT=X,HOLD=YES
//IAYOUT DD SYSOUT=X,HOLD=YES
//IAYERR DD SYSOUT=X,HOLD=YES
//CPEOUTRS DD SYSOUT=X,HOLD=YES
//CPEOUTRQ DD SYSOUT=X,HOLD=YES
//CPESNAP DD SYSOUT=X,HOLD=YES
//SYSPRINT DD SYSOUT=X,HOLD=YES
//SYSUDUMP DD DUMMY
// PEND

Edit the listen PROC and modify the following in the STEPLIB card:

Procedure

  1. Change the default address space name for TCP/IP if it differs at your site.
  2. Decide on a communication port number for the listener by editing the PORT parameter in the PROC card. Note that an equivalent setup might also be done by using the IBM® AD Build Configuration that is installed on the Windows system to correspond to the same the port. The port number might be unique and not used by other software. Any number can be selected.
  3. Define the maximum number of tasks that can run in parallel (number of parallel requests from the PC server). Usually 5 - 10 might be enough.
  4. Make sure that REGION and TIME parameters are set as in the listener sample.
    Note:
    • The REGION=0M parameter grants the AD Connect for Mainframe started task enough user storage for certain operations that require it.
    • The TIME=NOLIMIT parameter ensures that the AD Connect for Mainframe started task does not abend on a system code S522 after exceeding the maximum wait time during periods of no client activity.
  5. Accordingly, if IBM AD Connect for Mainframe’s load library name would be changed as requested by your site standards, modify the STEPLIB card.
  6. Define a new RACF® user ID to assign to the IBM AD Connect for Mainframe started task. The RACF user ID must have an OMVS segment to allow the started task to use TCP/IP services on z/OS®. For more background on this requirement, refer to the following links:
    The new user ID must have appropriate access to all datasets referenced in the started task procedure JCL. After the user ID is defined, associate it with the started task procedure by using the following two RACF commands:
    RDEFINE STARTED ADPROC.* STDATA(USER(AD_STC_USERID))
    SETROPTS RACLIST(STARTED) REFRESH
    
    Note:
    • The ADPROC parameter is the member name that is assigned to the AD started task procedure JCL.
    • The AD_STC_USERID parameter is the new RACF user ID defined for its use.
  7. For each IBM subsystem or SCM tool that is listed below, make the suggested change if you intend to use IBM AD Connect for Mainframe to retrieve data from this source.
    1. For Db2®Db2, add the following to the STEPLIB card:
      // DD DSN=DSN910.SDSNLOAD,DISP=SHR <-- it should be changed if local load lib name is different at your site.
    2. For IMS, add the following to the STEPLIB card:
      // DD DSN=IMS910.SDFSRESL,DISP=SHR <-- it should be changed if local load lib name is different at your site.
    3. For CICS® CSD, add the following to the STEPLIB card:
      // DD DSN=DFH320.CICS.SDFHLOAD,DISP=SHR <-- it should be changed if local load lib name is different at your site.
    4. For MQ, add the following to the STEPLIB card:
      // DD DSN=CSQ700.SCSQAUTH,DISP=SHR <-- it shoud be changed if local load lib name is different at your site.
      // DD DSN=CSQ700.SCSQLOAD,DISP=SHR <-- it shoud be changed if local load lib name is different at your site.
    5. For CA Endevor, add the following to the STEPLIB card, where hlq is the high-level qualifier for Endevor:
      // DD DSN=hlq.ENDEVOR.AUTHLIB,DISP=SHR

      In addition, add the following DD cards (two cards per task, up to MAXTASK specified in the JOB card, with a different temporary file name per DD card). The DD cards might be numbered from 01 to nn to match the number of tasks defined in MAXTASK, modifying the numbers given below in red.

      //* <-- FOR ENDEVOR - one DD for each task (from the MAXTASK parameter)
      //* the number is running from 001 to nnn which is the MAXTASK number
      //APIEX001 DD DSN=&&IAYIN01,SPACE=(3040,(40,40),,,ROUND),
      // DISP=(NEW,DELETE,DELETE),UNIT=SYSDA,
      // DCB=(BLKSIZE=20484,LRECL=2048,RECFM=VB)
      //* <-- FOR ENDEVOR - one DD for each task (from the MAXTASK parameter)
      //APIMS001 DD DSN=&&IAYOUT01,SPACE=(3040,(40,40),,,ROUND),
      // DISP=(NEW,DELETE,DELETE),UNIT=SYSDA,
      // DCB=(BLKSIZE=13300,LRECL=133,RECFM=FB)
    6. For CA7, add the following to the STEPLIB card:
      // DD DSN=CA7.loadlib,DISP=SHR <-- it should be changed to site CA7 load lib name
  8. When CA7 configuration is set to be used in batch mode – via dataset (so not in memory), add the following DD cards (+ card per task, up to MAXTASK specified in the JOB card):
    //IAYINTR DD SYSOUT=(*,INTRDR)
    //* Create as many IAYINTnn according to the number of MAXTASK parameter
    //IAYINTnn DD SYSOUT=(*,INTRDR)
  9. To connect to a local IBM Workload Scheduler (IWS, previously known as TWS) controller address space that is running on the same LPAR using a local subsystem interface, add the following DD Cards:
    1. //EQQMLIB DD DISP=SHR,DSN=TWS851.SEQQMSG0  it might be changed if the TWS Message Library has a different name on your site. If an user library is defined for TWS messages, it might come first and the two libraries names might be concatenated.
    2. //EQQDUMP DD DISP=SHR,DSN=IAY.USER.TWS.EQQDUMP. Create a dataset called IAY.USER.TWS.EQQDUMP with record format VBA, record length 84 and block size 3120. Allocation might be just few tracks.
    3. //EQQMLGnn DD DISP=SHR,DSN=IAY.USER.TWS.MLOG.TASKnn. Create datasets that are called IAY.USER.TWS.MLOG.TASKnn as sequential files with record format VBA, record length 125 and block size 1632, where nn goes from 01 to the number of tasks specified in MAXTASK.
    To connect to a remote IWS controller address space that is running on another LPAR in your sysplex or in a remote z/OS instance, see Enabling TCP/IP Connection to a Remote IWS Controller Address Space.
  10. For TWS, add the following to the STEPLIB card:
    // DD DSN=TWSnnn.SEQQLMD0,DISP=SHR <-- it should be changed if local load lib name is different at your site
  11. For ChangeMan ZMF, add the following DD cards (two cards per task, up to MAXTASK specified in the JOB card. The files might be preallocated before the started task starts):
    //* Create as many XMLINnn according to the number of MAXTASK parameter
    //XMLIN01 DD DISP=SHR,DSN=IAY.CHGMAN.XMLIN01 <--FOR CHANGEMAN
    //* Create as many XMLOUTnn according to the number of MAXTASK parameter
    //XMLOUT01 DD DISP=SHR,DSN=IAY.CHGMAN.XMLOUT01 <--FOR CHANGEMAN
    //IAYINTR DD SYSOUT=(*,INTRDR)
    //* Create as many IAYINTnn according to the number of MAXTASK parameter
    //IAYINTnn DD SYSOUT=(*,INTRDR)
  12. For Adabas, add the following DD card (+ card per task up to MAXTASK specified in the JOB card. The files might be preallocated before the started task starts):
    //IAYDR0nn DD DISP=SHR,DSN=IAYV142.NATURAL.DB.TASKnn
    //* Create as many EZDR0nn according to the number of MAXTASK parameter. DSN can be any name
  13. For Natural, add the following DD cards (+ card per task, up to MAXTASK specified in the JOB card. The files might be preallocated before the started task starts):
    //IAYINTR DD SYSOUT=(*,INTRDR)
    //* Create as many IAYINTnn according to the number of MAXTASK parameter
    //IAYINTnn DD SYSOUT=(*,INTRDR)
    //IAYCA0nn DD DISP=SHR,DSN=IAYV142.NATURAL.LB.TASKnn
    //* Create as many IAYCA0nn according to the number of MAXTASK parameter. DSN can be any name
    //IAYCB0nn DD DISP=SHR,DSN=IAYV142.NATURAL.MM.TASKnn
    //* Create as many IAYCB0nn according to the number of MAXTASK parameter. DSN can be any name