The Jazz Users’ Guide is a series of tutorial web pages showing you how to use Jazz for a variety of programming tasks. Other web pages, such as those in the Language Reference series, are designed for reference. The tutorial and reference web pages cross reference each other, and are designed to be used together. If you want to see how to write a report program, start with a user guide page showing a report program. If you want to understand all the options and rules of a PRINT statement, use a language reference page. The Users’ Guide is like a textbook, while the Language Reference is like a dictionary.
There are the following pages in the Users’ Guide series. You should read Introduction to Jazz first, but otherwise the pages can be read in any order except where indicated.
These pages apply to all types of programming
· Introduction to Jazz. This section should be read first. It introduces the key concepts of Jazz and gives some examples from the simplest problem type, batch reporting.
· Training Objects. You may like to create the training files UG1, CustF, and FR, that are used in various demonstrations and tutorials.
·
Jazz
Logic. IF, CASE,
and LOOP statements
allow you to control your program’s logic. ROUTINE
and PARAGRAPH
statements allow you to improve the clarity of your code. CALL
and INVOKE
combine with interface descriptions to allow you to structure your code, reuse
logic, and interact with pre-written and remote services.
·
Working
with SQL (DB2 and other relational databases)
·
External
I/O. Defining a file as type XIO
means that I/O routines developed by you or your software vendor are used to
access the data. This chapter shows you
how this feature is used. It can be
complex, so avoid using XIO unless you have no option.
·
Date
and Time Fields. This chapter shows
you how you can use DATE, TIME, and DATETIME
fields in assignments, ACCEPT (validation), PRINT and SEND statements (Display).
·
Conversion
from Easytrieve. Easytrieve was the inspiration for the very first version
of MANASYS, which was essentially “Easytrieve that generated PL/I”, and if
you’re familiar with Easytrieve then you’ll see echoes of it in the Initial Demonstration. MANASYS Jazz is the easiest and best way of
converting Easytrieve to COBOL. Click Converting Easytrieve Data, Creating
the Program Structure and Converting
Easytrieve Logic, for even more detailed
information
·
Using Jazz with DL/1. DL/1, developed
in 1966 by IBM, Rockwell, and Caterpillar for the Apollo program to send a man
to the moon, started the database management system revolution, and, although
it has been superseded by relational databases such as DB2 and others, it still
exists in legacy IBM environments. From Build #310 MANASYS Jazz
users are able to convert Easytrieve programs using DL1 to Jazz, which will
create COBOL to read and update DL1 databases.
This
section covers various types of batch programming. You can skip this if you are developing CICS
or Web Service programs.
·
Batch updating. Direct updating, file copy, and sequential updating.
·
Data
Conversion is basically a process of copying files with changes. Jazz provides special facilities to manage
this process efficiently by generating Excel spreadsheets, and then using these
spreadsheets to create the conversion programs.
·
Report
Designing. With PRINT most basic
data reporting can be simply accomplished with basic Jazz, but what if you want
more! The Jazz report designer allows
you do graphically design a report as you would a screen, specifying logic on
control break, and getting exactly the result that you want.
·
Creating
Test Data. MANASYS Jazz makes it easy to
create test data files, either by selecting and modifying production data, or
from program logic alone. Well designed test data is a valuable software asset.
·
Merge Processing. A batch program may read two sequential
files, updating the first from the second, and writing a new copy of the first
file with the results of the update
This covers
programming for 3270 screens, i.e. “Classical” CICS. If this is relevant to
you, read these chapters in order.
·
Jazz
On Line Programming:
Introduction.
The first chapter on classical CICS programming. Creating a CICS menu
program, and a program that displays a record with a 3270-type display.
·
Jazz On Line Programming, Part 2. Updating Records.
Extending the preceding chapter, this shows how you can update data.
·
Jazz On Line Programming, Part 3. Handling Multiple Records. Here
we handle parent/child relationships, building a very simple order-entry
system. Still with classical CICS programming using 3270-type displays.
You should
read these chapters in order, except Invoking Web Services which can be skipped
or read later.
·
Service-Oriented
Architectures and Web Services. Here we introduce the concepts and
terminology of Service Oriented Architectures, providing essential background
so that you can both provide and request Web Services with Jazz.
·
Providing
Web Services shows you how to write a Web Service Provider using either
COMMAREA or CHANNEL communication. The
example programs are little more than “Hello World”,
but once developed you’d have the basic knowledge to write programs providing
your mainframe data (VSAM? DB2?) through
a web service so that it can be displayed on a web page.
You can skip this chapter is it isn’t relevant
to you.
·
Invoking
Web Services covers the reverse situation, where your program invokes an
existing web service. The chapter shows
you how to discover a web service and request data from it. Again, only with a very basic “Get time”
service, but giving you the basic principles that you’ll
need for real problems.
·
Real
Web Services. With the basic
technology covered, now we start to deal with real problems: accessing data
from VSAM and providing it to an external program, and then extending this to
update the VSAM data through a web service. In a CICS update record locking is
essential but excessive locking can bring an on-line system to a halt, so we
need “pseudo-locking” logic that minimises the time that actual locks are
held. With classical CICS programs Jazz
managed this by storing a copy of the original record in COMMAREA, but this won’t work in Web Services so Jazz includes an encrypted
hash total in the output and input message.
·
Web
Services and Multiple Records. After
Real
Web Services, here you learn how to write web services that handle record
hierarchies (think Customer/Order) and other record collections.
· Client Programming. For JSON web services Jazz can generate a client interface encapsulating all the rules of the CICS web service, presenting to the client methods and properties that can be discovered by Intellisense™ and used, like any other .NET™ object.
Read this section in order as far as
you need, except that you can skip the Classical CICS chapter if it is not
relevant.
·
Integrating
Micro Focus Enterprise Developer with Jazz turbo-charges both products,
multiplying the productivity gains available from either individually, and facilitating
the world of distributed development (Mainframe/Linux/Windows etc).
·
Set
up Jazz for Micro Focus (Mainframe)
·
Jazz
Batch Programming with Micro Focus