The Jazz Workbench

The Jazz Workbench. 1

Getting Help. 2

Control Buttons. 4

New.. 4

Check. 4

Show All 4

Show Data. 5

Process. 5

Job Results. 7

Configure. 7

Screen. 7

Services. 7

Font Size. 7

Lower Control buttons. 7

Exit 7

Diagnostics. 7

Show COPY Help. 7

 

Help for other forms: -

Configuration         This describes the Configuration page, which you see when you click the [Configure] button

Process                This describes the Process page, which you see if you right-click the [Process] button

Screen                  This describes the 3270 screen editor, which is displayed when you click the [Screen] button.

Services                This describes the forms you see during a web services discovery process

 

This form controls all Jazz Processing. It looks like this (although some controls like the [Screen] and [Services] buttons will come and go depending on the situation): -

 

Keywords and fields have been identified by colour, and the code has been indented to show its logical structure.  Also, when your program is checked Jazz will produce error messages when errors are found: -

IN1.SalesThisMonth = IN1.Name + 5;

#168 E Operator invalid for preceding item

#031 E "+" is invalid here

When you write unqualified references like “SalesThisMonth” and “Name” Jazz will find the fields and qualify the references for you, providing visual confirmation that the field exists and a helpful hint enabling you to check that you have the field that you want. 

 

If you open a Jazz program with a basic editor like Notepad you’ll see something like this: -

*# Last Updated by robertb at 30/11/2013 10:24:19 a.m.

PROGRAM AAnExmpl BATCH; 

COPY IN1;

COPY FR;

PROCESS IN1 WHERE (IN1.Region > 5) ORDER(IN1.Region, IN1.District, IN1.Name);

GET FR WHERE (FR.Region = IN1.Region);

PRINT(IN1.Region, Fr.Name, IN1.SalesThisMonth SUM, IN1.SalesYTD SUM)

BREAK(IN1.Region, IN1.District);

END PROCESS IN1;

Getting Help

You can get help by right-clicking part of the workbench.  Note, if the right-click doesn’t work as described here, use a normal (left) click first, then try the right-click again: -

1.      Help about a statement.  Right-click on any statement except COPY and the relevant page of the language reference manual will open. For example, with the cursor positioned on the PROCESS statement a right-click produces this.

2.      Help about a message.  Right-click with the cursor positioned on an error message and an explanation of the error is given: -


3.      COPY and Record Definitions.  Right-click on a COPY statement and another workbench opens, displaying the imported definition and allowing you to edit it.  For example, clicking on
     
COPY In1;
displays: -

 

Just in case you want to see the definition of a COPY statement these 2nd-level workbench sessions have a button [Show COPY Help].  Click [Exit] to return to the parent session.  If the COPY code includes further COPY statements then you may open further levels of workbench session.

 

4.      Program Data.  If you right-click on an INSCREEN, WEBSERVICE, or COMMAREA option of a PROGRAM statement the corresponding record layout is opened.  For WEBSERVICE and COMMAREA options you may edit the record layout, but you should edit the INSCREEN definition through the Jazz 3270 screen editor.

 

5.      Selecting Data.  In many situations you can write a question mark, and the workbench will respond with a data list from which you can select the fields that you want. For example, writing PRINT ?; in your program causes this window to be displayed when you click [Check]: -

 

You can expand the nodes for the records IN1 or FR and click on the fields that you want to print.  As you select them they are added to the data list: when you are through, click [Finish] to return to the program.

 

6.      Workbench controls.  Read on to find out how the various controls on the Workbench form work.

7.      Other forms.  Just click F1 to open its Help page.

8.      Language Reference “Manual”.  This is a list of all Jazz statements, and links to their Help pages.

9.      Users’ Guide.  This is a series of tutorial-style pages, showing you how to write various types of program.

You should use both Language Reference and Users’ Guide together, just as you’d use a textbook and a dictionary together.

Control Buttons

New

When we click [New] or take the New option from the File menu the Jazz workbench responds with a dialog like this: -

Click [+] to expand the nodes until we find the one we want, then click this. This time we’ll select “New Batch Program”, and the dialog will ask us for the program name and create the PROGRAM statement for us.

Check

[Check] will get Jazz to check the program. Errors may be reported, keywords will be highlighted, and the code will be indented.  However no COBOL is generated and nothing is submitted to the zOS system.

Show All

Click this and the button text changes to “Hide”, and the hidden code from COPY statements etc is displayed.  For example: -

 

You should not change the copied text as it will immediately be replaced by the original version when next you click [Check].  Instead, right-click the COPY statement.

Show Data

This shows the program’s data list, as described above.

Process

Process controls Jazz processing by the zOS system.  If you right-click the button, or if your Process default is “Show this form on left click” the Process form is displayed.  If your process default is not “Show this form” then processing is the same as if you had opened the form and clicked its [Submit] button.  Processing is: -

 

1.      If necessary the program is re-checked.

2.      COBOL is generated (unless errors are too serious)

3.      JCL is generated

4.      The job is submitted

5.      The workbench then checks for the job’s completion.

 

 

As the job progresses various messages appear at the bottom of the workbench, until a message tells you that the job output has been downloaded successfully, and the button [Job Results] is highlighted: -

Job Results

If this is highlighted, as shown above, then clicking it will display the output of your last job in NotePad.  If it is not highlighted then it opens an Explorer window filtered for names starting with “JOB” and with type .txt.    You may see your job twice, once as a .txt file and once as .txt.txt: -

The reason for this:  job output from a mainframe is written with a control character as the first character of each line.  Here is the start of Job06702.txt: -

1                   J E S 2  J O B  L O G  --  S Y S T E M  S 0 W 1  --  N O D E  S V S C J E S 2       

0

 21.17.58 JOB06702 ---- TUESDAY,   13 JUN 2017 ----

 21.17.58 JOB06702  IRR010I  USERID IBMUSER  IS ASSIGNED TO THIS JOB.

 21.17.58 JOB06702  IEF677I WARNING MESSAGE(S) FOR JOB IBMUSER9 ISSUED

 21.18.00 JOB06702  ICH70001I IBMUSER  LAST ACCESS AT 21:17:54 ON TUESDAY, JUNE 13, 2017

 21.18.00 JOB06702  $HASP373 IBMUSER9 STARTED - INIT 1    - CLASS A        - SYS S0W1

 21.18.02 JOB06702  -                                      -----TIMINGS (MINS.)------                          -----PAGING COUNTS----

 21.18.02 JOB06702  -STEPNAME PROCSTEP    RC   EXCP   CONN       TCB       SRB  CLOCK          SERV  WORKLOAD  PAGE  SWAP   VIO SWAPS

 21.18.02 JOB06702  -COMPILE  COBOL       00  10233    133       .00       .00     .0            90  BATCH        0     0     0     0

 21.18.03 JOB06702  -COMPILE  LKED        00    322     34       .00       .00     .0            41  BATCH        0     0     0     0

 21.18.04 JOB06702  -GO                   00    948     99       .00       .00     .0           145  BATCH        0     0     0     0

 21.18.04 JOB06702  -IBMUSER9 ENDED.  NAME-                     TOTAL TCB CPU TIME=      .00 TOTAL ELAPSED TIME=    .0

 21.18.04 JOB06702  $HASP395 IBMUSER9 ENDED

0------ JES2 JOB STATISTICS ------

-  13 JUN 2017 JOB EXECUTION DATE

-           25 CARDS READ

-        1,770 SYSOUT PRINT RECORDS

-            0 SYSOUT PUNCH RECORDS

-          116 SYSOUT SPOOL KBYTES

-         0.09 MINUTES EXECUTION TIME

 !! END OF JES SPOOL FILE !!

 

When [Job Results] is clicked Jazz copies Jobnnnnn.txt to Jobnnnnn.txt.txt interpreting the control character: -

1 = new page

0 = leave a blank line

- = leave two blank lines

 

Whichever file you select, Job Results will open file Jobnnnnn.txt.txt.  Here is the start of JOB06702.txt.txt: -

---- Page --------------------------------------------------------------------------------------------------------------

                   J E S 2  J O B  L O G  --  S Y S T E M  S 0 W 1  --  N O D E  S V S C J E S 2       

 

 

21.17.58 JOB06702 ---- TUESDAY,   13 JUN 2017 ----

21.17.58 JOB06702  IRR010I  USERID IBMUSER  IS ASSIGNED TO THIS JOB.

21.17.58 JOB06702  IEF677I WARNING MESSAGE(S) FOR JOB IBMUSER9 ISSUED

21.18.00 JOB06702  ICH70001I IBMUSER  LAST ACCESS AT 21:17:54 ON TUESDAY, JUNE 13, 2017

21.18.00 JOB06702  $HASP373 IBMUSER9 STARTED - INIT 1    - CLASS A        - SYS S0W1

21.18.02 JOB06702  -                                      -----TIMINGS (MINS.)------                          -----PAGING COUNTS----

21.18.02 JOB06702  -STEPNAME PROCSTEP    RC   EXCP   CONN       TCB       SRB  CLOCK          SERV  WORKLOAD  PAGE  SWAP   VIO SWAPS

21.18.02 JOB06702  -COMPILE  COBOL       00  10233    133       .00       .00     .0            90  BATCH        0     0     0     0

21.18.03 JOB06702  -COMPILE  LKED        00    322     34       .00       .00     .0            41  BATCH        0     0     0     0

21.18.04 JOB06702  -GO                   00    948     99       .00       .00     .0           145  BATCH        0     0     0     0

21.18.04 JOB06702  -IBMUSER9 ENDED.  NAME-                     TOTAL TCB CPU TIME=      .00 TOTAL ELAPSED TIME=    .0

21.18.04 JOB06702  $HASP395 IBMUSER9 ENDED

 

------ JES2 JOB STATISTICS ------

 

 

  13 JUN 2017 JOB EXECUTION DATE

 

 

           25 CARDS READ

 

 

        1,770 SYSOUT PRINT RECORDS

 

 

            0 SYSOUT PUNCH RECORDS

 

 

          116 SYSOUT SPOOL KBYTES

 

 

         0.09 MINUTES EXECUTION TIME

!! END OF JES SPOOL FILE !!

       1 //IBMUSER9 JOB  ,CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID,COND=(8,LT)          JOB06702

         //*** COMPILE BATCH PROGRAM or SUBPROGRAM                                      

         IEFC653I SUBSTITUTION JCL - ,CLASS=A,MSGCLASS=H,NOTIFY=IBMUSER,COND=(8,LT)

 

For a batch program the job will include a GO step where the program is run.

Configure

Click this to set up Jazz initially, and to change your configuration details.  Here you define where your libraries are within your Windows and zOS environments and what processing options you want.  Refer to this Help page for more information.

Screen

If this is a CICS program then this button appears.  Clicking it initiates the Jazz screen editor, where you can create and edit 3270-type screen layouts. Refer to this Help page for more information.

Services

This button appears when you’re writing a program that provides or invokes web services to allow you to discover web services and manage their message formats. Refer to this Help page for more information.

Font Size

Click [+] to enlarge the font used to display your program.  Click [–] to make it smaller.

Lower Control buttons

These buttons appear under the program: -

Exit

Closes the program, after a prompt to see if you want to save it.

Diagnostics

This is intended for the development team and is probably not useful to Jazz users.  If clicked a form appears that allows you to print various Jazz-internal diagnostics.

Show COPY Help

This button only appears if you’ve right-clicked a COPY statement and so you are in a 2nd-level Workbench session. If you click this you’ll open the Help page for the COPY statement.