DFSJMP procedure

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

The DFSJMP procedure resides in the IMS PROCLIB data set as a standard IMS System Definition-supplied procedure and can be invoked as DFSMPR would be invoked.

The procedure shown in Sample procedure to start a JMP region starts a JMP region.

Usage

The DFSJVMAP member of the IMS PROCLIB data set can be used with a DFSJMP 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 DFSJMP procedure.

  • AGN=
  • ALTID=
  • APARM=
  • CL1=, CL2=, CL3=, CL4=
  • CSSLIB=
  • ENVIRON=
  • IMSID=
  • JVM=
  • JVMOPMAS=
  • LOCKMAX=
  • MAXTHRD=
  • MINTHRD=
  • NBA=
  • NODE1=
  • NODE2=
  • OBA=
  • OPT=
  • OVLA=
  • PARDLI=
  • PCB=
  • PRLD=
  • PREINIT=
  • PWFI=
  • RGN=
  • SCEERUN
  • SOD=
  • SOUT=
  • SPIE=
  • SSM=
  • STIMER=
  • SYS2=
  • TLIM=
  • VALCK=

See Parameter descriptions for IMS procedures for descriptions.

DD statements

The following DD statements are valid for the DFSJMP 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

  • The JMP region can schedule only a Java application.
  • 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 specifies the name of the member of the IMS PROCLIB data set that contains the environment settings, and is required. However, when the //STDENV DD statement is used, this parameter is ignored.
  • The existing APPLFE=, DBLDL=, VSFX=, and VFREE= parameters on the DFSMPR procedure are not supported on the DFSJMP 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.
  • When the JVM= parameter is specified, all positional parameters that precede JVM= must be explicitly specified.

Sample procedure to start a JMP region

//       PROC SOUT=A,RGN=56K,SYS2=,
//            CL1=001,CL2=000,CL3=000,CL4=000,
//            OPT=N,OVLA=0,SPIE=0,VALCK=0,TLIM=00,
//            PCB=000,STIMER=,SOD=,
//            NBA=,OBA=,IMSID=,AGN=,
//            PREINIT=,ALTID=,PWFI=N,APARM=,
//            LOCKMAX=,ENVIRON=,
//            JVMOPMAS=,PRLD=,SSM=,PARDLI=,
//            MINTHRD=000,MAXTHRD=256,JVM=31
//*
//JMPRGN EXEC PGM=DFSRRC00,REGION=&RGN,
//            TIME=1440,DPRTY=(12,0),
//            PARM=(JMP,&CL1&CL2&CL3&CL4,
//            &OPT&OVLA&SPIE&VALCK&TLIM&PCB,
//            &STIMER,&SOD,&NBA,
//            &OBA,&IMSID,&AGN,&PREINIT,
//            &ALTID,&PWFI,'&APARM',&LOCKMAX,
//            &ENVIRON,,&JVMOPMAS,&PRLD,&SSM,&PARDLI,
//            &MINTHRD,&MAXTHRD,&JVM)
//*
//STEPLIB  DD DSN=IMS.&SYS2.PGMLIB,DISP=SHR
//         DD DSN=IMS.&SYS2.SDFSJLIB,DISP=SHR
//         DD DSN=IMS.&SYS2.SDFSRESL,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,BLKSIZE=3129,RECFM=VBA),
//         SPACE=(125,(2500,100),RLSE,,ROUND)

Sample procedure to start a JMP region with JVM=3164

//       PROC SOUT=A,RGN=56K,SYS2=,
//            CL1=001,CL2=000,CL3=000,CL4=000,
//            OPT=N,OVLA=0,SPIE=0,VALCK=0,TLIM=00,
//            PCB=000,STIMER=,SOD=,
//            NBA=,OBA=,IMSID=,AGN=,
//            PREINIT=,ALTID=,PWFI=N,APARM=,
//            LOCKMAX=,ENVIRON=,
//            JVMOPMAS=,PRLD=,SSM=,PARDLI=,
//            MINTHRD=000,MAXTHRD=256,JVM=3164
//*
//JMPRGN EXEC PGM=DFSRRC00,REGION=&RGN,
//            TIME=1440,DPRTY=(12,0),
//            PARM=(JMP,&CL1&CL2&CL3&CL4,
//            &OPT&OVLA&SPIE&VALCK&TLIM&PCB,
//            &STIMER,&SOD,&NBA,
//            &OBA,&IMSID,&AGN,&PREINIT,
//            &ALTID,&PWFI,'&APARM',&LOCKMAX,
//            &ENVIRON,,&JVMOPMAS,&PRLD,&SSM,&PARDLI,
//            &MINTHRD,&MAXTHRD,&JVM)
//*
//STEPLIB  DD DSN=IMS.&SYS2.PGMLIB,DISP=SHR
//         DD DSN=IMS.&SYS2.SDFSJLIB,DISP=SHR
//         DD DSN=IMS.&SYS2.SDFSRESL,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,BLKSIZE=3129,RECFM=VBA),
//         SPACE=(125,(2500,100),RLSE,,ROUND)