Set up IMS with Java for a Java message processing (JMP) application

Overview

The IMS Java workflow can configure the environment for a JMP using the IBM® z/OS® Management Facility (z/OSMF)

The IMS Java workflow will configure the environment with these steps:

• Create a symbolic link for the Universal Drivers C library (DFSCLIBU).
• Create a JMP Region jcl needed to run the application.
• Create three IMS proclib members needed for the JMP.
  • DFSJVMEV - Specify the JVM used by the JMP.
  • DFSJVMMS - Specify the classpath
  • DFSJVMAP - Map the PSB name to the application main method
• Define the program and transaction for the IMS application.
• Start the program, transaction, and JMP region

Pre-requisites

• An SMP/E installation of IMS is done and the IMS load libraries are available.
• Identify the z/OS system parameters
• IMS SVC modules are installed on the system
• The Common Service Layer must be started.
• z/OSMF must be started. Both the angel and server z/OSMF address spaces must be started.

Security requirements

To run the workflow, you need the following authority:

• RACF read authority on SMP/E installed IMS libraries
• RACF update authority on the high level qualifiers (HLQs) you are using for the IMS instance libraries
• Authority to ADD/DELETE APF authorizations

Repository structure

The repository includes the following files:

• zosmf/ :
  • deployJavaToIMS.xml
    • This is the file that is used to configure Java. You should not modify this workflow XML file.
  • deployJavaNoDbToIMS.xml
    • This file is used to configure Java with a program that does not have a database component. You should not modify this workflow XML file.
  • java_workflow_variables.properties
    • This properties file contains variable key / value pairs that are referenced in the workflows. Edit the java_workflow_variables.properties file to specify the system specific information.
• proclib/ : Three sample DFSJVMxx PROCLIB members needed for the JMP region.
  • DFSJVMEV - Member for specifying the JVM used by the JMP.
  • DFSJVMMS - Member for specifying the classpath.
  • DFSJVMAP - Member for mapping the PSB name to the Java class with the application main method.
• jcl/ : Sample JCL for creating a program and transaction and starting the JMP region.
  • CREPGM - Create IMS program that does not use a database.
  • CREPGMDB - Create IMS program that uses a database.
  • CRETRAN - Create IMS transaction.
  • IMDOJMP - JCL for starting the JMP region
  • QRYPGM - Used to query the status of the transaction and program.
  • SIMLINK - Member for mapping the PSB name to the Java class with the application main method
  • STAPGM - Sample JCL to start the JMP region
  • STATRAN - Sample JCL to start the JMP region
  • IMDOJMP - Sample JCL to start the JMP region

Installation

• FTP the deployJavaToIMS.xml workflow and the java_workflow_variables.properties files to USS on the z/OS host in binary mode.
• The files need to be made visible to the z/OSMF application. Do this by changing the access permissions of the files using the chmod command
• Example chmod commands:

chmod 644 deployJavaToIMS.xml

• Or if the files are in a folder with the name of workflows:

chmod -R 644 workflows

To run the workflow using the z/OSMF web interface

1. Log into the IBM z/OS Management Facility web interface
2. Select "Workflows" from the left menu
3. Select the "Actions" drop down menu
4. Select "Create Workflow"
5. In the Create Workflow dialog, specify:
   • Workflow definition file:
   • Workflow variable input file:
   • System:
6. Select "Next"
7. Select “Assign all steps to owner user ID” if you are going to run all of the workflow steps with the current user ID.
8. Select "Finish"
9. Right-click on the first action and select "Perform"

For more information about running a workflow see Create a workflow

Troubleshooting

• IZUWF0105E Workflow property file file-name is either not found or cannot be accessed

  • Typically this error comes from the file not existing at the path given, or the file exists, and chmod needs to be done on this file.

• If there is no "Workflows" menu option in the z/OSMF web interface configure the IZUPRMxx member in the SYS.PARMLIB specifying the WORKLOAD_MGMT in the PLUGINS statement. For more information see creating a IZUPRMxx in the IBM Knowledge Center.

  • Example:

  PLUGINS(INCIDENT_LOG
  COMMSERVER_CFG CAPACITY_PROV SOFTWARE_MGMT ISPF
  RESOURCE_MON
  WORKLOAD_MGMT)

z/OSMF documentation

Visit the IBM Knowledge Center for more information on IBM z/OS Management Facility