z/Ware 2.0 Technical Overview

Copyright © 2010 illustro Systems International, LLC

z/Ware 2.0 Technical

illustro Systems International LLC

ISI zware-2Copyright © 2010 illustro Systems International, LLC

Topics

z/Ware Common Components (ZWC) Combined Products Enhanced Script facilities Named Scripts Document facility Executing CICS programs COMMAREA Events HTTP Client facility WebService Client facility Batch Program API


z/Ware Common Components Infrastructure (ZWC) Common support services split from

previous product code to create a new infrastructure that can support multiple products

Allows multiple products to run in a single address space

Simplifies the code of each product Multiple products receive benefit of

support and enhancement


ZWC… Services

Multi-tasking workflow management Communications management

Message routing, logging, storing, retrieval Operator commands

Operating system interfaces Storage management Dump/trace management 3270 session management Variable/value management


ZWC…

Services Document management File and Library management

Read/write/caching HTTP Server

HTML & XML support Static document serving CGI program execution Web services (SOAP) support


ZWC…


z/Ware Product Functions Combined z/Ware 2.0 performs the functions

previously handled by z/Web-Host and z/XML-Host Supports XML templates in addition to HTML Support Web Services (SOAP) requests and

responses


Enhanced Script Facilities

Statements previously used with the Application Automation Facility (AAF) within a WebScreen definition, are now refered to as Scripts

Expanded to a more feature rich scripting facility

Can be used in places other than a WebScreen


Enhanced Script Facilities...

Many new facilities in Version 2 use new script statements to perform important functions

Several of the old statements have been expanded to work with new facilities If Assign


Execution of Named Scripts

A new facility called Named Scripts allows execution of stand alone scripts Script statements stored in a library member and

defined to the system with a script name Not associated with a 3270 session Requested from web page or off-platform program

with any desired user variables Use any available scripting functions Requests can be one-time or persistent


Execution of Named Scripts...


The Document Facility

The Document script statement is used to create and delete in-storage user documents

Documents are created from templates stored in library members

Substitution of user variable values within the template

Templates can contain HTML, XML or any desired text format

Documents can be returned to the requestor, placed in a COMMAREA or used for other purposes


The Document Facility…


Executing CICS COMMAREA Programs Script statements can be used to:

Create named CICS COMMAREA buffers Map data fields within the COMMAREA Insert required data into the COMMAREA Request execution of a CICS program

passing the COMMAREA Extract data from returned COMMAREA Create a user Document with returned data


Executing CICS COMMAREA Programs... Multiple CICS regions can be defined

and requests directed to desired region Can use

Generic or specific CICS connection Any desired mirror transaction id Any desired userid

Persistent Script requests can be used to perform multiple requests using the same data items


Executing CICS COMMAREA Programs...


CICS COMMAREA Events

A COMMAREA Event is triggered by a user CICS program passing a COMMAREA to a z/Ware CICS program The COMMAREA data is matched against

the defined COMMAREA Event definitions Script statements from the matching

COMMAREA Event are executed Updated COMMAREA is returned to original

program


CICS COMMAREA Events…


HTTP Client Support

Scripts can send GET or POST HTTP requests to external servers Servers in the data center Servers anywhere on the Internet

Can be used to send data to remote servers or retrieve data from remote servers

Documents are created by user and used for: The URL Data (on post requests) Custom HTTP request headers (optional)


HTTP Client Support…

External servers are defined in the ZWC configuration via Define_Server statement

The request is sent using the HTTP_Request script statement

HTTP response headers are returned in the Document named HTTP_RESP_HDRS

HTTP response data is returned in the Document named HTTP_RESP

User variables set by request: HTTP_RETURN 0 or numeric error code HTTP_STATUS numeric HTTP result code HTTP_RESPONSE character HTTP result string



Script If statement can test “fields” in returned Document against character strings

Script Assign statement can extract data “fields” from returned Document into user variables




Web Service Client Support

Can invoke a Web Service residing anywhere on the Internet

Called Type1 service because it is not fully automated yet

Documents created by user script & used for: URL data SOAP Body data (XML elements sent as request)

Automatically built: Server part of the URL string SOAP Envelope


Web Service Client Support… External servers are defined in the ZWC

configuration via Define_Server statement The request is sent using the

WebService_Type1 script statement HTTP response headers are returned in the

Document named HTTP_RESP_HDRS SOAP response data is returned in the

Document named HTTP_RESP (XML response document)


Web Service Client Support… User variables set by request:

SOAP_RETURN 0 or numeric error code HTTP_STATUS numeric HTTP result code HTTP_RESPONSE character HTTP result

Script If statement can test data “fields” from returned documents

Script Assign statement can extract data “fields” from returned documents into user variables


Web Service Client Support…


Batch Program API

Extends the CICS COMMAREA concept to batch programs

Allows simple program call to trigger script execution

No TCP/IP Sockets programming Batch programmer does not have to know

anything about TCP/IP, HTTP, SOAP, Web Services or other protocols

User program builds COMMAREA (buffer) containing needed data

Program call to ZWEBBAT1 passing COMMAREA


Batch Program API…

COMMAREA Event script triggered in z/Ware Server

Script performs desired processing Updated COMMAREA returned to user

program REXX external function provided

Place COMMAREA data on program stack Call ZWEBREXX() function Updated COMMAREA data returned on

program stack


Batch Program API…


Wrap Up

More is planned for future releases of Version 2

Please let us know if you have specific needs

Technology

z/Ware 2.0 Technical Overview