z/VSE Connectors Introduction, Use Cases, and News

© 2017 IBM Corporation
z/VSE Connectors Introduction,
Use Cases, and News
Ingo Franzki
IBM z Systems – z/VSE – VM Workshop 2017

The following are trademarks of the International Business Machines Corporation in the United States, other countries, or both.
The following are trademarks or registered trademarks of other companies.
* All other products may be trademarks or registered trademarks of their respective companies.
Notes:
Performance is in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput that any user will
experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed.
Therefore, no assurance can be given that an individual user will achieve throughput improvements equivalent to the performance ratios stated here.
IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply.
All customer examples cited or described in this presentation are presented as illustrations of the manner in which some customers have used IBM products and the results they may have achieved. Actual
environmental costs and performance characteristics will vary depending on individual customer configurations and conditions.
This publication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject to change without
notice. Consult your local IBM business contact for information on the product or services available in your area.
All statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only.
Information about non-IBM products is obtained from the manufacturers of those products or their published announcements. IBM has not tested those products and cannot confirm the performance,
compatibility, or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
Prices subject to change without notice. Contact your IBM representative or Business Partner for the most current pricing in your geography.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel
Corporation or its subsidiaries in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.
IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency, which is now part of the Office of Government Commerce.
For a complete list of IBM Trademarks, see www.ibm.com/legal/copytrade.shtml:
*, AS/400®, e business(logo)®, DBE, ESCO, eServer, FICON, IBM®, IBM (logo)®, iSeries®, MVS, OS/390®, pSeries®, RS/6000®, S/30, VM/ESA®, VSE/ESA,
WebSphere®, xSeries®, z/OS®, zSeries®, z/VM®, System i, System i5, System p, System p5, System x, System z, System z9®, BladeCenter®
Not all common law marks used by IBM are listed on this page. Failure of a mark to appear does not mean that IBM does not use the mark nor does it mean that the product is not
actively marketed or is not significant within its relevant market.
Those trademarks followed by ® are registered trademarks of IBM in the United States; all others are trademarks or common law marks of IBM in the United States.
Trademarks

Notice Regarding Specialty Engines (e.g., zIIPs, zAAPs and IFLs):
Any information contained in this document regarding Specialty Engines ("SEs") and SE
eligible workloads provides only general descriptions of the types and portions of workloads
that are eligible for execution on Specialty Engines (e.g., zIIPs, zAAPs, and IFLs). IBM
authorizes customers to use IBM SE only to execute the processing of Eligible Workloads of
specific Programs expressly authorized by IBM as specified in the “Authorized Use Table for
IBM Machines” provided at
http://www.ibm.com/systems/support/machine_warranties/machine_code/aut.html (“AUT”).
No other workload processing is authorized for execution on an SE.
IBM offers SEs at a lower price than General Processors/Central Processors because
customers are authorized to use SEs only to process certain types and/or amounts of
workloads as specified by IBM in the AUT.

z/VSE Connectors - Introduction
The z/VSE Connectors started as a single function in VSE/ESA 2.5
Since then, it evolved over time
Its now more a technology than just a function
– consisting of many different features and functions
– supporting various connector solutions
VSE/ESA 2.5
Java-based Connector
• VSE Connector Server
& Client
• J2C Resource Adapter
for WAS
VSE/ESA 2.6
VSAM Redirector
• Real-time synchronization of
VSAM data with a database
JDBC Driver for VSAM
• SQL based access to VSAM
data
• Part of the Java-based
Connector
VTAPE Support
VSE/ESA 2.7
SOAP/Web Services
support
• VSE as Web Service
provider or consumer
VSE Script Connector
• non-Java access to
VSE programs and data
z/VSE 3.1 z/VSE 4.1 z/VSE 4.2 z/VSE 4.3 z/VSE 5.1 z/VSE 5.2 z/VSE 6.1
Misc enhancements of
existing Connectors
Enhancements for
VSAM Redirector
• VSAM Capture Exit
• New DBHandler
supports normalization
Added TSM support for
VTAPE
SOAP/Web Services security
• Transport Layer Security
• Message Layer Security
LDAP Sign-on support
• Signon using long, corporate
user-id
• Authenticate against an
LFDAP server
Fast Path to Linux on
System z (LFP)
• In z/VM environment
Enhancements of
existing Connectors
IPv6/VSE TCP/IP
Stack
Fast Path to Linux on
System z (LFP)
• In LPAR environment
IPv6 support in LFP
z/VSE z/VM IP Assist
(VIA)
Database Connector
(DBCLI)
IPv6 support in
connectors
Stacking Tape
Support
Channels & Containers
support in CICS TS 2.1
MQ Client Trigger Monitor
Remote Debug Interface
(as BETA)
z/VSE 6.2
REST Engine
SOAP Engine
supports C&C
DBCLI
Enhancements

TCP/IP for VSE
Java
z/VSE
Connector
Client
z/VSE Script
Server
z/VSE Navigator
Maptool
VSAM/JDBC
VSAM
Redirector
Server
z/VSE Print
TCP/IP
Config Tool
Keyman/VSE
Virtual Tape
Server
CICS
Transaction
Gateway
Web Service
(SOAP or REST)
DB2 Connect
WebSphere
MQ
DB2
DB2
z/VSE
Connector
Server
VSAM
Redirector
Client
Auto
FTP
Virtual Tape
CICS
Transaction
Server
Web Service
(SOAP or REST)
DB2 Server DB2 VSAM, DL/I
MQ Server
or Client
CICS
Web Support
VSAM DL/I
LIBR
Console
ICCF
POWER
TCP/IP
TCP/IP
TCP/IP
TCP/IP
TCP/IP
TCP/IP
TCP/IP + SNA
TCP/IP (HTTP/SOAP)
TCP/IP (DRDA)
TCP/IP
z/VSE Health
Checker
POWER
POWERAuto email
Auto LPR
DBCLI
ServerMS SQL
Oracle
JDBC DBCLI API
TCP/IP
MQ Client
Trigger Monitor
Rem. Dbg API Remote Dbg. Debug Tool
TCP/IP
Rational Developer
for System z
Plugin

z/VSE Connector & Tools - Downloads
Connector components
– Delivered as part of the
z/VSE system as WBOOKs
in PRD2.PROD
– Also available on the
z/VSE Homepage
http://ibm.com/zvse/downloads
Many ‘as-is’ tools are provided
for download
Information about the
Connector Components can
be found here:
http://ibm.com/zvse/products/connectors.html

Java-based Connector
Remote access to z/VSE data and programs from a Java program
– Real time access to VSAM, DL/1, LIBR, POWER, Console, Jobs, …
– From standalone Java programs
…or from web applications (servlets, JSPs, Mobile Apps etc.)
– Deployable as J2C Resource Adapter or JDBC Data Source into
J2EE web applications servers, such as:
• WebSphere Application Server
• IBM Mobile First Server
– Extendable via Plugins
Java
z/VSE
Connector
Client
Standalone Java
application
WAS
VSAM/JDBC
z/VSE
Connector
Server
VSAM DL/I
LIBR
Console
ICCF
POWER
TCP/IP
z/VSE
Java platform
Web
applica-
tion
Plugin
Mobile
First
Mobile
App

VSAM Redirector
Synchronization of VSAM data with a database
Real-time: VSAM Redirector Client/Server
– OWNER=VSAM:
• any INSERT, UPDATE or DELETE request is immediately replicated into the database
• Read requests go against the VSAM dataset on z/VSE
– OWNER=REDIRECTOR:
• All VSAM requests are sent to the database.
• No access to the VSAM dataset anymore (except OPEN / CLOSE).
Near real-time: VSAM Capture Exit
– Data changes are collected in a delta file or MQ queue
– Delta file is downloaded and applied to database from time to time
VSAM
Redirector
Server
Flat File
VSAM
Redirector
Client
(IESREDIR)
TCP/IP
z/VSEJava platform
VSAM
VSAM
VSAM
Capture
Exit
(IESVSCAP) Delta File
(or MQ queue)
Vendor Exit
Redirector
Delta
Loader
VSEConn.Server
VSEConn.Client
Apply
TCP/IP
Application
Generic
Exit
(IKQVEX01)
Config
HandlerHandler
Handler
Handler
Handler
Handler
DB2
Redirector
Loader
Load
Handler
Handler
Handler

z/VSE
z/VSE Script Connector
z/VSE Script Connector can be used to:
– Access z/VSE resources from distributed non-Java applications
– Call/Execute processes on distributed systems from z/VSE applications or Jobs
z/VSE
VSE Connector Server
LIBR POWER VSAM
Distributed System (Java)
VSE
Conn.
Client
VSE Script
Server
Script
Repository
VSE Script
Client
(Batch or CICS)
VSE Script
Client
(Windows DLL,
.Net/C# Class)
VSE Script
Client (Java)
MS Office
OpenOffice
(Non-
Java App)
Script
execute
script
External
Process
(running on
distributed
system)
call/execute
TCPIP
TCPIP
TCPIP

CICS Connectivity
CICS Web Support is the base of CICS connectivity
CICS
Transaction
Gateway
Web Service
(SOAP)
CICS
Transaction
Server
CICS
Application
CICSWebSupport
TCP/IP + SNA
TCP/IP (SOAP over HTTP)
z/VSERemote platform
VSE SOAP
Engine
CICS
Application
Application
3270/BMS
Application
HTTP / TCP/IP
generate
proxy code
or rules
XML
Parser
VSE REST
Engine
(z/VSE 6.2)
CICS
Application
JSON
Parser
RESTful
Web Service
TCP/IP (HTTP)
HTTP / TCP/IPCICS
Explorer

SOAP / Web Services support
Web Service-enable z/VSE CICS applications
– Provide existing CICS applications as Web Service to the outside world
• z/VSE as the SOAP server
– Use/call external Web Services from within z/VSE CICS applications
• z/VSE as the SOAP client
– CICS2WS Tool is used to generate proxy code or mapping rules
New with z/VSE 6.2:
– z/VSE SOAP Engine now supports
Channels & Containers
TCP/IP (SOAP over HTTP)
CICS
Transaction
Server
CICS
Application
CICSWebSupport
z/VSE
VSE SOAP
Engine
XML
Parser
generate
proxy code
or rules
SOAP
Web Service
Remote platform

z/VSE as SOAP Server
CICS
WebSupport
SOAP Server
(IESSOAPS)
XML Parser
SOAP
Decoder
(IESSOAPD)
SOAP Engine
Version 1
SOAP
Decoder
(IESOASRV)
SOAP Engine
Version 2
xPath
User Program
(SOAP-aware)
User Program
(COMMAREA
or Channels &
Containers)
Proxy
Code
(generated)
Mapping
Rules
(generated)
HTTP
urn:IESSOAPD:MYPROXY
urn:IESOASRV:MYRULES
CICS TS

z/VSE as SOAP Client
User Program
(SOAP-aware)
User Program
(COMMAREA
or Channels &
Containers)
Proxy
Code
(generated)
Mapping
Rules
(generated)
SOAP Encoder
(IESSOAPE)
SOAP Engine
Version 1
SOAP Encoder
(IESOACLN)
SOAP Engine
Version 2
xPath
HTTPClient
(IESHTTPC)
SOAP Client
(IESSOAPC)
XML Parser
HTTP
CICS TS

z/VSE 6.2: RESTful Web Services support
Use REST (Representational State Transfer) with CICS applications
– Provide existing CICS applications as RESTful Web Service to the outside world
• z/VSE as the REST server
– Use/call external RESTFul Web Services from within z/VSE CICS applications
• z/VSE as the REST client
– Payload can be:
• JSON (JavaScript Object Notation)
• XML
• Plain text
• Binary
• Form fields
• Multipart
RESTful
Web Service
CICS
Transaction
Server
CICS
Application
CICSWebSupport
TCP/IP (HTTP)
z/VSE
Remote platform
VSE REST
Engine
JSON
Parser
XML
Parser

What is REST (Representational State Transfer)?
Representational State Transfer (REST) is a software architecture style
consisting of guidelines and best practices for creating web services
– REST has gained widespread acceptance across the web as a
simpler alternative to SOAP and WSDL-based web services
RESTful systems typically communicate over the Hypertext Transfer Protocol (HTTP)
with the same HTTP verbs (GET, POST, PUT, DELETE, and so on) used by web browsers
The payload (message) transported by RESTful web services can be of various types (content types)
– Commonly used is JSON as well as XML, but it can also be plain text, or even binary data
A RESTful web service typically operates on a certain 'object' on a server
– The object is typically addressed through the URI (part of the URL), for example http://example.com/resource
Actions on such resources are typically denoted by the HTTP request types:
– GET would typically read the resource
– PUT would typically update/replace the resource
– POST would typically create the resource
– DELETE would typically delete the resource
RESTful web services are typically stateless
– Each request from any client contains all the information necessary to service the request
– The session state is therefore held in the client
As denoted by the term 'typically' in above descriptions, there is no hard requirement for any of the described properties

z/VSE 6.2: z/VSE as a REST Server
CICS
WebSupport
REST Server
(IESRESTS)
XML Parser
User Program
(the REST
service)
HTTP
JSON Parser
CICS TS
REST Parameter
Block (COMMAREA)

z/VSE 6.2: z/VSE as a REST Client
HTTPClient
(IESHTTPC)
REST Client
(IESRESTC)
XML Parser
User Program
(the REST
client program)
HTTP
JSON Parser
CICS TS
REST Parameter
Block (COMMAREA)

z/VSE Database Call Level Interface (DBCLI)
Allows z/VSE applications to access a relational database on
any suitable database server
– IBM DB2, IBM Informix, Oracle, MS SQL Server, MySQL, etc.
The database product must provide a JDBC driver that supports JDBC V3.0 or later
Utilize advanced database functions and use SQL statements provided by modern
database products
z/VSE Java capable
platform
(e.g. Linux on
System z)
Database Server
(may run on the
same system as
the DBCliServer)
TCP/IP or
Linux Fast Path
Batch or CICS
application
DBCLI API
DBCLI
Client
DBCliServer
JDBC V3
Driver
Database
(e.g. IBM DB2,
IBM Informix
Oracle,
MS SQL Server,
MySQL, ...)
TCP/IP
TCP/IP
or local
Programming
Languages:
COBOL
PL/1
C
HLASM
REXX (batch)
z/VSE 6.2:
REXX (CICS)

z/VSE applications accessing Databases
z/VSE
DB2 LUW
MySQL
Oracle
MS
SQL Server
DBCLI &
DRDA
with DB2
Federation
CICS or
batch
Application
DBCLI
DBCLI
DBCLI
DBCLI
And others ...

z/VSE 6.2: Interactive Query Tool for DBCLI

z/VSE 6.2: Batch Query Tool for DBCLI
* $$ JOB JNM=RUNDBCLI,DISP=D,CLASS=4
* $$ LST DISP=D,CLASS=Q,PRI=3
// JOB RUNDBCLI
// LIBDEF *,SEARCH=(PRD2.CONFIG,PRD1.BASE,PRD2.TCPIPC)
// EXEC IESDBCLB,PARM='SYMBOLS=YES ECHO=ON'
CONNECT SERVER=my.database.server.com DBNAME=SAMPLE
USER=db2user PASSWORD=password;
SELECT EMPNO,FIRSTNME,LASTNAME,SALARY,BONUS
FROM EMPLOYEE;
DISCONNECT;
/*
/&
// JOB RUNDBCLI
// LIBDEF *,SEARCH=(PRD2.CONFIG,PRD1.BASE,PRD2.TCPIPC)
// EXEC IESDBCLB,PARM='SYMBOLS=YES ECHO=ON'
1S54I PHASE IESDBCLB IS TO BE FETCHED FROM PRD1.BASE
DBCLI BATCH QUERY TOOL
CONNECT SERVER= my.database.server.com DBNAME=SAMPLE
USER=db2user PASSWORD=(PASSWORD SUPPRESSED);
INFO: CONNECTED TO SERVER 'my.database.server.com' DBNAME 'SAMPLE'.
INFO: DATABASE PRODUCT 'DB2/NT' VERSION 'SQL09075'
INFO: LAST RC=0
SELECT EMPNO,FIRSTNME,LASTNAME,SALARY,BONUS FROM EMPLOYEE;
INFO: STATEMENT HAS BEEN EXECUTED, IT PRODUCED THE FOLLOWING RESULT SET:
EMPNO FIRSTNME LASTNAME SALARY BONUS
CHAR(6) VARCHAR(12) VARCHAR(15) DECIMAL(9,2) DECIMAL(9,2)
------- ------------ --------------- ------------ ------------
000010 CHRISTINE HAAS 152750.00 1000.00
000020 MICHAEL THOMPSON 94250.00 800.00
000030 SALLY KWAN 98250.00 800.00
...
INFO: ROWCOUNT: 42
INFO: LAST RC=0
DISCONNECT;
INFO: DISCONNECT SUCCESSFULL.
INFO: LAST RC=0
1S55I LAST RETURN CODE WAS 0000
EOJ RUN MAX.RETURN CODE=0000

LDAP Sign-on Support
z/VSE Identity Management
LDAP
Directory
CICS Applications
and Batch Jobs
AdministratorUserUserUser
Manages Identities
User-IDs
Passwords
Groups
Access rights
Policies
Add, Change,
Delete, ...
AuthenticateAuthenticate
Authenticate
User
Sign-on
LDAPSign-on
User
mapping

z/VSE SNMP Monitoring Agent support
z/VSE Monitoring Agent enables customers to monitor z/VSE systems using
standard monitoring interfaces (SNMP V1)
– Available since z/VSE V4.3
– It also includes an open interface, which enables customers or vendors to use own programs
(plugins) to collect additional data
Data collected by the IBM provided plugins contains
– Information about the environment (e.g. Processor, LPAR and z/VM information)
– Number of partitions (static, dynamic, total, maximum)
– Partition priorities
– Number of CPUs (active, stopped, quiced)
– Paging (page ins, page outs)
– Performance counters overall and per CPU
– CPU address and status
– CPU time, NP time, spin time, allbound time
– Number of SVCs and dispatcher cycles
Plugin interface allows Vendors to provide additional monitoring data

Withdrawn from service since September 30, 2015
Note:
• z/VSE Applications don‘t have to be aware of MQ Server 2 and 3
• Decision which MQ Server Queue will host the messages is defined in channels between the MQ servers
z/VSE (CICS TS)
Queues
WebSphere MQ Server for
z/VSE
App 1 App 2
PUT GET
Trigger
WebSphere MQ Server 2
Queues
Queues
Server to
Server
channel
Server to
Server
channel
WebSphere MQ Server for z/VSE V3.0
Trigger Monitor

z/VSE (CICS TS)
WebSphere MQ Client for
z/VSE
App 1 App 2
PUT GETTrigger
Queues
Queues
Client
channel
Client
channel
z/VSE applications work directly with the MQ Servers 2 and 3
Note:
• z/VSE Applications have to be aware of MQ Server 2 and 3
• Decision which MQ Server Queue will host the messages has to be in the application
Replace the MQ Server on z/VSE with the
MQ Client on VSE

z/VSE (CICS TS)
WebSphere MQ Client for
z/VSE
App 1 App 2
PUT GETTrigger
Add a dedicated MQ Server (i.e. on Linux on System z)
Note:
• z/VSE Applications are all working with the same MQ Server
• All definitions from z/VSE MQ Server can be replicated to the new dedicated MQ server
• z/VSE applications need to be aware of just one MQ server
Queues
Queues
Client
channel
Dedicated WebSphere MQ
Server
Queues
Server to
Server
channel
Replace the MQ Server on z/VSE with the
MQ Client on VSE

Rational Developer for z Systems (RDz)
with z/VSE Development & Debug Plug-in for RDz – from QGroup
Workstation z/VSE
IBM Rational Developer
for z Systems
z/VSE
Debug
Plugin
(Q-Group)
Remote
Debug
API
Remote
Debug
Interface
VSE
Debug
Tool
Debugged
Program
(Batch or CICS)
3270 Frontend
z/VSE
Development
Plugin
(Q-Group)
z/VSE
Connector
Client
Eclipse
LPEX Editor
COBOL
Parser
SQL/CICS
Parser
PL1 Parser
JCL Parser
HLASM Parser
Local
COBOL/PL1
Compiler
VSE
Connector
Server
VSAM
ICCF
LIBR
POWER
Console
HLASM
PL1 Compiler
COBOL Compiler
TCP/IP
TCP/IP

28
Access to VSE’s
resources
Editor with
Syntax Highlighting
Outline View
shows structure
of program
Project View
allows grouping
of program files

29
Remote Compile shows error
in source editor
Compiler Messages after Remote Compile

30
Access to VSE console

31
3270 Terminal Emulator included

32
Remote Debugger allows debugging of COBOL programs
Display Variables
Step through in program source
Breakpoint

IBM MobileFirst Foundation
MobileFirst Studio
MobileFirst Server
MobileFirst Console MobileFirst
Application Center
Device Runtime

z/VSE and IBM MobileFirst
To start mobile development with z/VSE, you need to have the following applications:
– The IBM MobileFirst Platform Developer Edition
– The z/VSE Connector Client and Server
– Web Service enabled CICS TS applications
Whitepaper: ftp://public.dhe.ibm.com/eserver/zseries/zos/vse/download/
GettingStartedWithMobileDevelopmentForVSE.pdf

TCP/IP for VSE
Java
z/VSE
Connector
Client
z/VSE Script
Server
z/VSE Navigator
Maptool
VSAM/JDBC
VSAM
Redirector
Server
z/VSE Print
TCP/IP
Config Tool
Keyman/VSE
Virtual Tape
Server
CICS
Transaction
Gateway
Web Service
(SOAP or REST)
DB2 Connect
WebSphere
MQ
DB2
DB2
z/VSE
Connector
Server
VSAM
Redirector
Client
Auto
FTP
Virtual Tape
CICS
Transaction
Server
Web Service
(SOAP or RREST)
DB2 Server DB2 VSAM, DL/I
MQ Server
or Client
CICS
Web Support
VSAM DL/I
LIBR
Console
ICCF
POWER
TCP/IP
TCP/IP
TCP/IP
TCP/IP
TCP/IP
TCP/IP
TCP/IP + SNA
TCP/IP (HTTP/SOAP)
TCP/IP (DRDA)
TCP/IP
z/VSE Health
Checker
POWER
POWERAuto email
Auto LPR
DBCLI
ServerMS SQL
Oracle
JDBC DBCLI API
TCP/IP
MQ Client
Trigger Monitor
Rem. Dbg API Remote Dbg. Debug Tool
TCP/IP
Rational Developer
for System z
Plugin
Summary
The z/VSE Connectors
provide lots of possibilities
to connect z/VSE
with the rest of the world.

Questions ?

z/VSE Connectors Introduction, Use Cases, and News

More Related Content

What's hot (20)

Similar to z/VSE Connectors Introduction, Use Cases, and News (20)

More from IBM (20)

Recently uploaded (20)

z/VSE Connectors Introduction, Use Cases, and News