Download - z/Ware 2.0 Technical Overview
![Page 1: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/1.jpg)
Copyright © 2010 illustro Systems International, LLC
z/Ware 2.0 Technical
illustro Systems International LLC
![Page 2: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/2.jpg)
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
![Page 3: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/3.jpg)
ISI zware-3Copyright © 2010 illustro Systems International, LLC
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
![Page 4: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/4.jpg)
ISI zware-4Copyright © 2010 illustro Systems International, LLC
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
![Page 5: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/5.jpg)
ISI zware-5Copyright © 2010 illustro Systems International, LLC
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
![Page 6: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/6.jpg)
ISI zware-6Copyright © 2010 illustro Systems International, LLC
ZWC…
![Page 7: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/7.jpg)
ISI zware-7Copyright © 2010 illustro Systems International, LLC
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
![Page 8: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/8.jpg)
ISI zware-8Copyright © 2010 illustro Systems International, LLC
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
![Page 9: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/9.jpg)
ISI zware-9Copyright © 2010 illustro Systems International, LLC
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
![Page 10: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/10.jpg)
ISI zware-10Copyright © 2010 illustro Systems International, LLC
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
![Page 11: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/11.jpg)
ISI zware-11Copyright © 2010 illustro Systems International, LLC
Execution of Named Scripts...
![Page 12: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/12.jpg)
ISI zware-12Copyright © 2010 illustro Systems International, LLC
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
![Page 13: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/13.jpg)
ISI zware-13Copyright © 2010 illustro Systems International, LLC
The Document Facility…
![Page 14: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/14.jpg)
ISI zware-14Copyright © 2010 illustro Systems International, LLC
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
![Page 15: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/15.jpg)
ISI zware-15Copyright © 2010 illustro Systems International, LLC
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
![Page 16: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/16.jpg)
ISI zware-16Copyright © 2010 illustro Systems International, LLC
Executing CICS COMMAREA Programs...
![Page 17: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/17.jpg)
ISI zware-17Copyright © 2010 illustro Systems International, LLC
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
![Page 18: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/18.jpg)
ISI zware-18Copyright © 2010 illustro Systems International, LLC
CICS COMMAREA Events…
![Page 19: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/19.jpg)
ISI zware-19Copyright © 2010 illustro Systems International, LLC
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)
![Page 20: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/20.jpg)
ISI zware-20Copyright © 2010 illustro Systems International, LLC
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
![Page 21: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/21.jpg)
ISI zware-21Copyright © 2010 illustro Systems International, LLC
HTTP Client Support…
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
![Page 22: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/22.jpg)
ISI zware-22Copyright © 2010 illustro Systems International, LLC
HTTP Client Support…
![Page 23: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/23.jpg)
ISI zware-23Copyright © 2010 illustro Systems International, LLC
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
![Page 24: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/24.jpg)
ISI zware-24Copyright © 2010 illustro Systems International, LLC
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)
![Page 25: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/25.jpg)
ISI zware-25Copyright © 2010 illustro Systems International, LLC
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
![Page 26: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/26.jpg)
ISI zware-26Copyright © 2010 illustro Systems International, LLC
Web Service Client Support…
![Page 27: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/27.jpg)
ISI zware-27Copyright © 2010 illustro Systems International, LLC
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
![Page 28: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/28.jpg)
ISI zware-28Copyright © 2010 illustro Systems International, LLC
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
![Page 29: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/29.jpg)
ISI zware-29Copyright © 2010 illustro Systems International, LLC
Batch Program API…
![Page 30: z/Ware 2.0 Technical Overview](https://reader033.vdocuments.us/reader033/viewer/2022061206/5481d4fcb47959fb0c8b4622/html5/thumbnails/30.jpg)
ISI zware-30Copyright © 2010 illustro Systems International, LLC
Wrap Up
More is planned for future releases of Version 2
Please let us know if you have specific needs