websphere application server for z/os v6 - · pdf file name ibm websphere application server...

Click here to load reader

Post on 14-Jun-2020

6 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

  • WebSphere Application Server for z/OS

    WOLA Quick Start Guide

    A step-by-step guide to setting up and using WOLA Version Date: August 16, 2013

    See "Document Change History" on page 80 for a description of the changes in this version of the document

    IBM Advanced Technical Skills Gaithersburg, MD

    WP101490 at ibm.com/support/techdocs

    © IBM Corporation 2013

  • WP101490 - WOLA Quick Start Guide

    The WAS z/OS team in ATS consists of John Hutchinson, Mike Kearney, Mike Loos, Louis Wilen, Lee-Win Tai and Don Bagwell.

    Glenn Fisher manages the team.

    Mike Cox, Distinguished Engineer, serves as technical consultant to all our activities.

    Special thanks to Jim Mulvey, Tim Kaczynski and David Follis of the WAS z/OS development organization.

    And thanks for John Cowel of IBM Technical Sales for his help with the CICS sequential terminal section, as well as Leigh Compton of

    ATS CICS support for her overall assistance with CICS.

    © 2013, IBM Corporation Americas Advanced Technical Skills - 2 -

    WP101490 at ibm.com/support/techdocs Version Date: Friday, August 16, 2013

  • WP101490 - WOLA Quick Start Guide

    Table of Contents Overview ............................................................................................................................................... 5

    Objective of this document............................................................................................................................5 Assumptions and prerequisites to using this guide.......................................................................................5 WOLA and Version 7....................................................................................................................................5 Sources of information referred to by this guide...........................................................................................5

    WebSphere Application Server for z/OS Information Center............................................................................5 IBM Advanced Technical Skills Techdocs Site.................................................................................................5

    Preparing to Use WOLA - Preliminary Setup.......................................................................................6 FYI: Overview of the process........................................................................................................................6 Capture the version and fixpack level of WAS installation............................................................................6 Copy WOLA samples to a sample data set..................................................................................................6 Copy WOLA modules to a load library data set............................................................................................7 Check contents of sample and module data sets.........................................................................................7 Create cell-level WOLA "enable adapter" environment variable..................................................................8 Create cell-level WOLA "identity propagate" environment variable..............................................................8 Stop and restart the entire cell......................................................................................................................9 Install the ola.rar resource adapter and create a connection factory............................................................9 Install sample EAR file................................................................................................................................11 Status checkpoint........................................................................................................................................13

    Enabling WOLA in CICS Region and Initial Validation ....................................................................14 FYI: Overview of the process......................................................................................................................14 Customize sample CSDUPDAT member and submit.................................................................................14 Customize sample DFHPLTOL member and submit..................................................................................14 Customize sample OLAMAP and OLAUTIL members and submit............................................................15 Customize sample OLACB01 member and submit....................................................................................15 Update CICS region SIP member...............................................................................................................16 Update the CICS region JCL and concatenate to the DFHRPL DD...........................................................16 Review the WAS z/OS server CBIND profile for CICS region ID access...................................................16 Stop and restart the CICS region and verify WOLA components...............................................................17 Log into CICS region and use BBOC to start the Link Server Task and register into server.....................17 Other BBOC commands issued in CICS terminal session.........................................................................18 Status checkpoint........................................................................................................................................19

    WOLA and CICS Usage Scenarios.....................................................................................................20 Issue BBOC START_SRVR to start the link server task and register into WAS z/OS...............................20 Outbound WAS into CICS with OLACB01 as target service......................................................................20 Inbound CICS into WAS using OLAUTIL 3270 application in CICS...........................................................21 Outbound WAS into CICS using ATS Java application..............................................................................22 Optional - Propagation of Userid from WAS into CICS...............................................................................24

    WAS z/OS Version 7 and application with Basic Auth enabled.......................................................................29 Optional - Use the CICS Channels and Containers sample OLACB02......................................................32 Optional - Link Server start with BBOACPL2 PLT and INITPARM.............................................................35 Optional - Link Server start with BBOACPL3 PLT......................................................................................35 Optional - Link Server start with Sequential Terminal.................................................................................36 Optional - "Development Mode" ... Distributed WAS using Proxy EJB into CICS......................................36

    Overview......................................................................................................................................................... 36 Determine security settings for WAS z/OS......................................................................................................37 Determine security settings for distributed WAS, and enable if necessary.....................................................37 Assumed starting point for WAS z/OS environment........................................................................................39 Install Proxy EJB in WAS z/OS.......................................................................................................................40 Download and install ola.rar in distributed WAS environment.........................................................................41 Download and install the OLASample2 sample application............................................................................42 Configure custom properties on JCA connection factory................................................................................42 Configure security settings on both distributed and z/OS................................................................................44 Restart WAS on both distributed and z/OS.....................................................................................................47

    © 2013, IBM Corporation Americas Advanced Technical Skills - 3 -

    WP101490 at ibm.com/support/techdocs Version Date: Friday, August 16, 2013

  • WP101490 - WOLA Quick Start Guide

    Validate proxy function up to WAS z/OS and into CICS..................................................................................48 Alternative authentication - client certificate....................................................................................................49

    Status checkpoint........................................................................................................................................57 WOLA and Batch Usage Scenarios ...................................................................................................58

    Pull COBOL samples from WP101490 Techdoc........................................................................................58 Review the SAF CBIND profile for batch job ID access.............................................................................58 Review contents of EXER2B job.................................................................................................................59 Customize, Compile and run EXER2B....................................................................................

View more