Enabling support for Liberty optimized local adapters in IMS

You must enable your IMS environment to receive inbound requests when you use WebSphere® optimized local adapters (WOLA).

Before you begin

Enable your Liberty server environment to use optimized local adapters. For more information, see Enabling the Liberty server environment to use optimized local adapters.

Procedure

  1. Create a subsystem member (SSM) in the IMS PROCLIB data set, or update the existing member. Include the following entry in this member for optimized local adapters: WOLA,BBOA,BBOAIEMT. You can change the first token, WOLA, in this entry to a unique four character string. This string is used to identify the subsystem in messages that are issued by IMS. For more information about how to make an SSM, see Defining your external subsystems to IMS.
  2. If necessary, add the SSM parameter to the IMS startup procedure (PROC). Ensure that the SSM parameter is set to point to the external subsystem IMS PROCLIB member created in step 1. For more information about how to set the SSM parameter, see Specifying the SSM= EXEC parameter.
  3. Create a data set to contain the load modules that are used to identify the optimized local adapters to the IMS External Subsystem Attach Facility (ESAF). This dataset must be in the LIBRARY format, and must also be APF-authorized.
  4. Copy the optimized local adapter ESAF modules to the dataset allocated in step 3, by using the following commands from the UNIX System Services (USS) shell: cp -Xv wlp/clients/zos/bboaiemt "//'$DSNAME'" and cp -Xv wlp/clients/zos/bboaiemi "//'$DSNAME'"
  5. Add the dataset that is allocated in step 3 to the STEPLIB and DFSESL DD concatenations in your IMS startup PROC. Also, add the dataset to the DFSESL DD concatenations in any Message Processing Region (MPR), Fast Path Region (IFP), or Batch Message Processing (BMP) regions that are using the optimized local adapters.
  6. Secure your optimized local adapter connections by creating CBIND profiles for z/OS.
    If you have CBIND enabled in System Authorization Facility (SAF), grant access to the clients that use the optimized local adapters APIs. The user ID on the current thread, or TCB in the IMS dependent region, needs to have READ access to the appropriate profiles in the CBIND class to create optimized local adapters connections. The user identity is associated with the current IMS task and its TCB, in multiple ways. For BMPs, by default the job user ID is used. For IFPs and MPPs, the SECURITY macro and the build security environment exit DFSBSEX0 can play a role in determining which user ID is associated with the TCB. For more information, see Securing optimized local adapters for inbound support on Liberty for z/OS.
  7. Restart the IMS region. IMS message DFS0801I indicates that a subsystem connection for the optimized local adapters is complete, using the string that was used in step 1. You can also use the string that was used in step 1 in the IMS command /DISPLAY SUBSYS WOLA, to show the optimized local adapters status.
  8. If you call existing IMS programs from WebSphere, enable the OTMA C/I SVC by running program DFSYSVI0. This program is provided by IMS, and enables the OTMA C/I SVC on your system.