DFSJBP procedure

The DFSJBP procedure starts a Java™ non-message-driven dependent region that resembles a non-message-driven BMP region (for example, similar procedure parameters and z/OS® TCB structure).

The DFSJBP procedure resides in the IMS PROCLIB data set as a standard IMS system definition-supplied procedure and can be invoked as the IMSBATCH procedure is invoked.

The procedure shown in Procedure to start a JBP region starts a JBP region.

Usage

The DFSJVMAP member of the IMS PROCLIB data set can be used with a DFSJBP procedure. DFSJVMAP maps all the 8-byte or less uppercase Java application names (specified to IMS) to the true OMVS path name for the .class file associated with that Java application. For more information, see DFSJVMAP member of the IMS PROCLIB data set.

Parameters

The following parameters are valid for the DFSJBP procedure.

  • AGN=
  • ALTID=
  • APARM=
  • CKPTID=
  • CPUTIME=
  • CSSLIB=
  • DIRCA=
  • ENVIRON=
  • IMSID=
  • JVM=
  • JVMOPMAS=
  • LOCKMAX=
  • MBR=
  • NBA=
  • NODE1=
  • NODE2=
  • OBA=
  • OPT=
  • OUT=
  • PARDLI=
  • PREINIT=
  • PRLD=
  • PSB=
  • RGN=
  • SCEERUN=
  • SOUT=
  • SPIE=
  • SSM=
  • STIMER=
  • SYS2=
  • TEST=

See Parameter descriptions for IMS procedures for parameter descriptions.

DD statements

The following DD statements are valid for the DFSJBP procedure.

  • DFSDB2AF DD
  • DFSESL DD (optional)
  • JAVAERR DD
  • JAVAOUT DD
  • PROCLIB DD
  • STDENV DD
  • STDIN DD
  • STEPLIB DD
  • SYSUDUMP DD

See DD statements for IMS procedures for descriptions.

Restrictions

  • Only a Java application can be scheduled in this region.
  • The JVMOPMAS=<member name> sets the name of the member of the IMS PROCLIB data set that contains the JVM options for the master JVM, and is required. However, when the //STDENV DD statement is used, this parameter is ignored.
  • The ENVIRON= parameter, which specifies the name of the PROCLIB member that contains the environment settings, is a required parameter. However, when the //STDENV DD statement is used, this parameter is ignored.
  • The existing IN= parameters on the IMSBATCH procedure are not supported on the DFSJBP procedure.
  • For access to Db2 for z/OS, the Db2 Resource Recovery Services attachment facility (RRSAF) remains the default connection method. The SSM= parameter is required if the external subsystem attach facility (ESAF) is the connection method to an external subsystem such as Db2 for z/OS.
  • Do not switch to JVM=64 if your Java application invokes either COBOL or PL/I. The Language Environment does not support COBOL and PL/I interoperability in a 64-bit addressing mode. For more information, see Language environments.

Procedure to start a JBP region

//JBPJOB   JOB 1,IMS,MSGLEVEL=1,PRTY=11,CLASS=K,MSGCLASS=A,REGION=56K
//       EXEC DFSJBP,
//            IMSID=



//       PROC MBR=TEMPNAME,PSB=,JVMOPMAS=,OUT=,
//            OPT=N,SPIE=0,TEST=0,DIRCA=000,
//            STIMER=,CKPTID=,PARDLI=,
//            CPUTIME=,NBA=,OBA=,IMSID=,AGN=,
//            PREINIT=,RGN=56K,SOUT=A,
//            SYS2=,ALTID=,APARM=,ENVIRON=,LOCKMAX=,
//            PRLD=,SSM=,JVM=31
//*
//JBPRGN EXEC PGM=DFSRRC00,REGION=&RGN,
//            PARM=(JBP,&MBR,&PSB,&JVMOPMAS,&OUT,
//            &OPT&SPIE&TEST&DIRCA,
//            &STIMER,&CKPTID,&PARDLI,&CPUTIME,
//            &NBA,&OBA,&IMSID,&AGN,
//            &PREINIT,&ALTID,
//            '&APARM',&ENVIRON,&LOCKMAX,
//            &PRLD,&SSM,&JVM)
//STEPLIB  DD DSN=IMS.&SYS2.SDFSJLIB,DISP=SHR
//         DD DSN=IMS.&SYS2.SDFSRESL,DISP=SHR
//         DD DSN=IMS.&SYS2.PGMLIB,DISP=SHR
//         DD DSN=CEE.SCEERUN,DISP=SHR
//         DD DSN=SYS1.CSSLIB,DISP=SHR
//PROCLIB  DD DSN=IMS.&SYS2.PROCLIB,DISP=SHR
//SYSUDUMP DD SYSOUT=&SOUT,
//         DCB=(LRECL=121,RECFM=VBA,BLKSIZE=3129),
//         SPACE=(125,(2500,100),RLSE,,ROUND)

Sample procedure to start a JBP region with JVM=3164

//JBPJOB   JOB 1,IMS,MSGLEVEL=1,PRTY=11,CLASS=K,MSGCLASS=A,REGION=56K
//       EXEC DFSJBP,
//            IMSID=
//       PROC MBR=TEMPNAME,PSB=,JVMOPMAS=,OUT=,
//            OPT=N,SPIE=0,TEST=0,DIRCA=000,
//            STIMER=,CKPTID=,PARDLI=,
//            CPUTIME=,NBA=,OBA=,IMSID=,AGN=,
//            PREINIT=,RGN=56K,SOUT=A,
//            SYS2=,ALTID=,APARM=,ENVIRON=,LOCKMAX=,
//            PRLD=,SSM=,JVM=3164
//*
//JBPRGN EXEC PGM=DFSRRC00,REGION=&RGN,
//            PARM=(JBP,&MBR,&PSB,&JVMOPMAS,&OUT,
//            &OPT&SPIE&TEST&DIRCA,
//            &STIMER,&CKPTID,&PARDLI,&CPUTIME,
//            &NBA,&OBA,&IMSID,&AGN,
//            &PREINIT,&ALTID,
//            '&APARM',&ENVIRON,&LOCKMAX,
//            &PRLD,&SSM,&JVM)
//STEPLIB  DD DSN=IMS.&SYS2.SDFSJLIB,DISP=SHR
//         DD DSN=IMS.&SYS2.SDFSRESL,DISP=SHR
//         DD DSN=IMS.&SYS2.PGMLIB,DISP=SHR
//         DD DSN=CEE.SCEERUN,DISP=SHR
//         DD DSN=SYS1.CSSLIB,DISP=SHR
//PROCLIB  DD DSN=IMS.&SYS2.PROCLIB,DISP=SHR
//SYSUDUMP DD SYSOUT=&SOUT,
//         DCB=(LRECL=121,RECFM=VBA,BLKSIZE=3129),
//         SPACE=(125,(2500,100),RLSE,,ROUND)