Resolving API calls from z/OS clients statically

Resolve the zRule Execution Server for z/OS API calls in your z/OS® application (COBOL or PL/I application) by including an API stub in your load module.

About this task

zRule Execution Server for z/OS provides API stubs to enable the binder to resolve the external library calls for the HBRCONN, HBRRULE, and HBRDISC APIs. Include the necessary API stub from the ++HBRHLQ++.SHBRLOAD dataset:
  • For a batch application, HBRBSTUB
  • For a CICS® application, HBRCSTUB
  • For an IMS application, HBRISTUB.
Note: The NOHGPR compiler option must be used with PL/I applications for zRule Execution Server for z/OS or Rule Execution Server.

Procedure

  • To bind a batch application:

    The following statements demonstrate how to include the HBRBSTUB API stub for a batch application:

    
    //BIND  EXEC PGM=IEWL,PARM=('MAP,LIST,LET,RENT')
    //SYSUT1   DD DSN=&&SYSUT1,SPACE=(CYL,(1,1))           
    //SYSPRINT DD SYSOUT=*                                 
    //HBRLIB   DD  DSN=++HBRHLQ++.SHBRLOAD
    //USERLIB  DD  DSN=USER.BATCH.LOAD
    //SYSLMOD  DD DISP=SHR,DSN=USER.BATCH.LOAD
    //SYSLIN   DD *
     INCLUDE HBRLIB(HBRBSTUB)
     INCLUDE USERLIB(USERPROG)
     NAME USERPROG(R)  
    
  • To bind a CICS application:

    The following statements demonstrate how to include the HBRCSTUB API stub for a CICS application:

    
    //BIND  EXEC PGM=IEWL,PARM=('MAP,LIST,LET,RENT')
    //SYSUT1   DD DSN=&&SYSUT1,SPACE=(CYL,(1,1))           
    //SYSPRINT DD SYSOUT=*                                 
    //HBRLIB   DD  DSN=++HBRHLQ++.SHBRCICS
    //USERLIB  DD  DSN=USER.CICS.LOAD
    //SYSLMOD  DD DISP=SHR,DSN=USER.CICS.LOAD
    //SYSLIN   DD *
     INCLUDE HBRLIB(HBRCSTUB)
     INCLUDE USERLIB(USERPROG)
     NAME USERPROG(R)  
    
  • To bind an IMS application:

    The following statements demonstrate how to include the HBRISTUB API stub for an IMS application:

    //BIND EXEC PGM=IEWL,PARM=('MAP,LIST,LET,RENT')
    //SYSUT1 DD DSN=&&SYSUT1,SPACE=(CYL,(1,1))  
    //SYSPRINT DD SYSOUT=*  
    //HBRLIB DD DSN=++HBRHLQ++.SHBRLOAD 
    //USERLIB DD DSN=USER.BATCH.LOAD 
    //SYSLMOD DD DISP=SHR,DSN=USER.BATCH.LOAD 
    //SYSLIN DD *  
     INCLUDE HBRLIB(HBRISTUB)  
     INCLUDE USERLIB(USERPROG)  
     NAME USERPROG(R)