INSTRUCTIONS FOR RUNNING FTP & JAVA ON AN IBM SYSTEM Z MF PROBLEM  Three  - 15 POINTS PART  A HOW TO USE FTP TO TRANSFER FILES IN BCIS 3630 Step 1    On your PC  - create a new folder on the  C:\  drive  named  C:\IBM [or if you are using a flash drive to the letter of the flash drive -  example   E:\IBM]   NOTE: Be certain that you are showing ALL file extensions in Windows [that means

INSTRUCTIONS FOR RUNNING FTP & JAVA ON AN IBM SYSTEM Z

MF PROBLEM  Three  - 15 POINTS

PART  A

HOW TO USE FTP TO TRANSFER FILES IN BCIS 3630

Step 1    On your PC  - create a new folder on the  C:\  drive  named  C:\IBM

[or if you are using a flash drive to the letter of the flash drive -  example   E:\IBM]

 

NOTE: Be certain that you are showing ALL file extensions in Windows [that means .java, .jcl .dat   etc.]

 

Step 2     Download to your desktop the FTP software from the BCIS 3630 website

Double click the download and it  will install into a folder named   C:\FTP3270  for UNT SYS Z.

[or you may just use the FTP software in the UNT  labs thru VMWARE]

 

Step 3    Go into that folder and double click   WS_FTP95.EXE. accept the license agreement, and when it opens:  Click  SAVE and then Click OK :

 

Verify  the Profile name as                   UNT IBM SYSTEM Z,  

 

Verify the host name as                        192.86.32.88,

 

Verify the host type as                          IBM MVS, 

 

change  the User ID to your  own         UNTM0##     [0 is a number]

 

change  the Password to your  own   SYS Z   password

click Save and check Save Password

 

(DO NOT ALLOW  Windows Firewall to block the program after clicking OK.) If it does:

 

A. Type WINDOWS FIREWALL in the ‘type here to search’  box  [on lower left]

 

B. click ‘Allow an app or feature through Windows Firewall’  [on upper left]

 

C. click’ Change settings’ [on upper right]

 

D. Be sure there are checkmarks in both the Private and Public boxes for:

 

          ‘File Transfer Program’    &     ‘WS_FTP 95’

 

E. click OK

 

Step 4    You are now in the FTP system please note that:

 

 [the UNT lab screens may look a little  different - just look thru them]

 

IN the left window you see the contents of the C:\IBM  folder on your PC  [which is now empty]

 

IN  the right window you will see the contents of your  UNTM0##   account on the SYS Z, It should contain several folders including:

JAVAPGM,  JAVAIN, JAVAOUT, JAVAJCL .

 

 [ONLY  if they are not there; go to TROUBLESHOOTING AFTER setting the OPTIONS]

 

SET the OPTIONS:

Click on the Options button, along the bottom. On the  window that appears, select the Session Options button. In the Session Options window select the ASCII radio button, located in the bottom left corner under Transfer Mode and put a check in the  box ‘Use PASV Transfer Mode’ then click Save.

This is critical as ALL UPLOADS AND DOWNLOADS MUST BE DONE IN ASCII.

 

TROUBLESHOOTING ONLY:

 

IF THE ABOVE 4 FOLDERS DO NOT SHOW UP - DO THE FOLLOWING:

 

Start FTP over again then:

 

Type  JAVAPGM  in the box for Remote Host  under Initial Directories,

 

 then Ok

 

You should see several JAVA  files, whether the files are there or not do the following !!!

 

A.   hit ChgDir on the right side and delete everything in the box

 

B.   type   ' UNTM0##.'    [ your ID  and  include the  ' and the  . ]   then  OK

 

C.  hit the refresh button -  all folders should now show in the window.

 

 

----------------------------------------------------------------------------------------------------------------------------

 

Step 5   Verify that you have set the OPTIONS  correctly:

 

Be certain that:

 

 ‘Use PASV Transfer Mode’ and the ASCII radio button are both  checked

 

This is critical as all transfer must be  ASCII.

Example only for illustration

 

Step 6:

 

 DOUBLE CLICK  the JAVAPGM folder in the right window -

 

Then click the “PERSONAL”   java program name to highlight it

 

Then click the left arrow between the two  windows to move the PERSONAL java program  to the  

 

C:\IBM folder in the left window,  answer Yes to the prompt. 

 

 

 

 

NEXT:

 

DOUBLE CLICK  the JAVAJCL folder in the right window -

 

Then click the “JAVABTCH”   java JCL  name to highlight it

 

Then click the left arrow between the two  windows to move the “JAVABTCH”   java JCL  to the  

 

C:\IBM folder in the left window,  answer Yes to the prompt. 

 

  You just completed two  member [or file] transfers from the SYS Z to your PC.

 

Step 7   You may now close the FTP software program for a while, but we are going to open it again later when we do member [or file] transfers from the PC back to the SYS Z

 

[HINT:  IF YOU HAVE GARBAGE WHEN YOU OPEN THE FILES IN THE NEXT

 

FEW STEPS,  IT IS  BECAUSE  YOU  DID NOT SET UP THE ASCII RADIO BUTTON.  

 

YOU MUST REDO THE TRANSFERS   IN ASCII BEFORE CONTINUING. ]

 

Step 8  Go to the C:\IBM folder on your PC and look at the files using ONLY NOTEPAD   

 

[HINTS:

 

Do not use MS WORD to edit your JAVA or JCL.

 

Do not use the TAB key in JAVA or JCL.

 

You must use NOTEPAD as it does not put in edit characters that cannot be processed by programming languages.

 

If later on, your PERSONAL JAVA program does not run on the SYS Z it is because they have 'non-processable invisible' characters in either the java program or the in the JCL because you did not use NOTEPAD.

 

Also, do not allow any blank lines at the end of the JAVA or JCL code. If you find a blank line, delete it.]

 

 

Step 9   [NOTE: YOU MUST LIMIT ALL JAVA, DATA  AND JCL  FILE NAMES TO 8 CHARACTERS OR LESS]

 

Open the ‘PERSONAL’  java  program on your PC with NOTEPAD,  and  Put your name where it says :  PUT YOUR NAME ON THIS LINE.  Save it

 

NEXT:

Open the JAVABTCH file in the JAVAJCL  folder  on your PC with NOTEPAD, and

Change the  USERID  in ALL  SIX [6]  places of the JCL file to your  UNTM0##,

 then save.  BE VERY CAREFUL WITH  THE 2 PLACES THAT SAY:

 

           /z/untm0##/Personal.java

 

ONLY REPLACE ‘0##’  WITH YOUR NUMBER, do not replace ‘untm’ with ‘UNTM’

Even java JCL is case sensitive   -   save it

 

Step 10   Now  reopen  WS_FTP95.EXE, [the ASCII button must be selected].

 

A.    Send the modified ‘PERSONAL’ java program  from the PC back to the SYS Z  by  opening  the  JAVAPGM folders in both the  right and left windows of   the screen.    In the left window, highlight  the ‘PERSONAL’ java program  that you   want to send from the PC to the SYS Z

then click the right arrow -    NOTE:  You cannot have  the .java  file extension on files you submit to the SYS Z

 

B.    Send the modified JAVABTCH JCL  file  from the PC back to the SYS Z by opening  the  JAVAJCL folders in both the  right and left windows  of  the screen.   In the left window, highlight  the JAVABTCH JCL  file  that you want to send  from the PC to the SYS Z and  click the right arrow - 

NOTE:  You cannot have the .jcl  file extension on files you submit to the SYS Z

 

[LATER  ON,  if  you EVER need to send an input file from a PC to the SYS Z be certain to remove the .dat extension.]

 

NO SYS Z members [files]  can have windows file extensions

[.dat, .java, .jcl, .doc]

 

 

You have just done 2  MEMBER [FILE] transfers, from the PC to the System Z

 

WHICH IS WHAT YOU WILL DO   FROM NOW ON

 

Close the FTP software.  

 

End of PART A       

 

 

 

PROBLEM THREE  - PART B -  

RUNNING A COMPUTER PROGRAM ON THE MAINFRAME

 

Step 1         log on to the SYS Z  as you did before

 

 

Step 2         at the ISPF Primary Options Menu

 

 tab to the command line       Option  ===  >

 

[NOTE: THIS IS NOT THE SAME AS THE ‘OPTIONS’  MENU ITEM AT THE TOP OF THE SCREEN]

 

And  type   3.4   then   hit  Enter

 

 

Step 3         at the Data Set List Utility  screen

 

                     Tab to the Dsname Level . . .  and   type your  User ID  ‘UNTM###’  then Enter

 

 

REMEMBER:  USE THE F3 KEY TO NAVIGATE BACKWARD FROM SCREEN TO SCREEN

 

 

 

Step 4         you are now at  the DSLIST screen, which shows all of your folders [PDS’s]

 

                     Tab to the JAVAPGM line and type a B  [browse] in the space, press ENTER, 

 

                     You are now looking at the files [members] in the JAVAPGM folder

 

                     Tab to the first JAVA  file listed,  and type a B in the space , press ENTER,

 

                     You are now looking at the  JAVA listing.     Look it over using the

 

F7 and F8 keys then    F3 back to the list and look at the next program.

 

 

 

Step 5        Browse  [B]  the files in  the JAVAJCL  folder,  the JAVAIN folder,  &  the JAVAOUT  

 

                     folder  [which should be empty for now]

 

 

 

 

Step 6         Return to the JAVAJCL folder, and this time type an  ‘E’ [edit]  in the

 

                  space beside JAVAJCL;   hit enter

 

                  NEXT: type an  ‘E’   in the space beside the JAVABTCH  file;   hit enter

 

                  You are now at the EDIT menu for ISPF,

 

                  At the  Command = = =  >   type  ‘ SUBMIT’  and then Enter

                  This is how you run a job on the system Z

 

 

Step 7        F3 back to the DSLIST of  folders, and tab to the JAVAOUT line.

                 

                  Type a ‘B’  beside JAVAOUT and then Enter, 

tab to the output file PERSNOUT  and

 

                  Type a ‘B’ beside the output file PERSNOUT;  then enter.  Look at the

output.

 

[Hint: IF JAVAOUT IS EMPTY, you have an error which you must find and fix and rerun your job]

 

 

Step 8        Next,  review the Job log to see how well your  job ran, or if it ran.

.

a.   Use F3 to go to the   ISPF Primary Option Menu     

 

b.   On the       Option   === >      line   type   SD   then hit enter.

 

c.   This takes you to the   SDSF   Primary Option Menu 

 

                     d.   at    COMMAND   INPUT    ===  >    type    ST    then hit enter

 

 

 

c. This takes you to the  SDSF STATUS DISPLAY ALL CLASSES   screen.  

 

Locate  the JOB  that you just ran and type a   S    beside  it in the  NP  column,

Then hit Enter

d. This will present you with a listing of the job you just ran. Use  F7  &  F8   to move up and down screens and and use F10  & F11 to move from

side to side on the screens.

Step  9       F3 out and logoff -       

                  Hint : As stated earlier, if you cannot get  past the  ‘Process Option’  screen,  just type  a   2   to the right of   ‘Process  Option’   and  hit enter.  

                  [please disregard the message ‘delete data set , etc…].

Step 10      To print your JAVAOUT file, open the WIN FTP program, THEN:

 

                     Double Click the JAVAOUT folder in the right window  and Highlight the PERSNOUT                      file’   click the left arrow between the two windows to move the PERSNOUT file

                     To the   C:\IBM  folder in the left window, answer Yes to the prompt. 

 

 

 

Step 11      Print PERSNOUT using Wordpad – it may be ‘ugly’  as downloads may contain carriage control characters.

 

YOU HAVE JUST LEARNED HOW TO RUN A PROGRAM ON THE IBM MAINFRAME

 

End of PART B

 

PROBLEM THREE  - PART C -  

RUNNING ANOTHER JAVA PROGRAM ON THE MAINFRAME     

 

FIRST: 

Go to ISPF edit and navigate to UNTM0##.JAVAJCL(JAVABTCH) and take a look at the JCL.

Type HILITE AUTO on the command line. The HILITE command allows the ISPF editor to color-code data based on context when you are Editing or Viewing a member.

[Remember:]     UNTM0##.JAVAIN(PERSNIN)   contains  input data for this java program]

 

 

SECOND:

Go to ISPF edit and navigate to UNTM0##.JAVAPGM(PERSONAL) and take a look at the java source code.

Find the words SUPER STUDENT and change them to your LAST name only [stay between the “]

Find the course  #  3620 and change it to 3630

 
Navigate back to UNTM0##.JAVAJCL(JAVABTCH) and type "sub" on the command line to submit it again. Again, look at your output in the:   UNTM0## .JAVAOUT(PERSNOUT) member to see the result of the change you made. If it did not run, fix your typos and rerun it.

 

THIRD:

Complete all of  the following steps so that you can  run the CONTRIB program from the JAVAPGMS folder on the SYSTEM Z using CONTIN for input and getting CONTOUT as output:

   a. Type your name in the CONTRIB program where it tells you;  YOUR NAME HERE

  b. Edit the JAVABTCH JCL  using the following steps:

1. Go to line 10 [OPUT] and change the program name in ( ) after JAVAPGM to the name of the program you are running for example:     UNTM0##.JAVAPGM(CONTRIB)

2. Change the name of the  .java  program on that same  line 10 to the name shown in the actual java program

 for example: “public  class  Contrib” would be:   /z/untm0##/Contrib.java     [remember java is case sensitive]

3.  Make the same changes on line 15 and on line 24 [note: the  .java  extension does not appear on line 24]

4. Go to line 25 and change the name after JAVAOUT to  JAVAOUT(CONTOUT)

5. Go to line 26 and change the name after JAVAIN to  JAVAIN(CONTIN)

6.  SUBmit the JCL and then go to the JAVAOUT folder on the System Z and see if you have output in CONTOUT.

If you do, you have successfully run another java program,  if not, you must correct your typos and SUBmit the JCL again.

I will grade your JAVAOUT folder on the SYSTEM Z.

You just learned how to run any java program on the mainframe.

END OF PROBLEM THREE