StarterKit v1.

0
Author: Manjusha Date: 14 Apr 2011

MAINFRAME ACCESS STARTER KIT

Thank you for choosing Mathru Technologies Mainframe Access service and Welcome to world of Mainframe technologies learning arena. According to a recent survey, World's 80% of business processing runs on Mainframe computers Mathru Technologies enables individuals learning Mainframe technologies by providing Mainframe Ids under simulated environment. Using our service one can learn and practice programming on Mainframes using COBOL, DB2, CICS, JCL, VSAM, and ISPF. Technical Environment Each Mainframe ID comes with sample COBOL programs covering key language concepts, DB2 and CICS. Respective JCLs are provided to run these sample programs. Note: A convention we follow throughout this document is wherever you find <userid>, substitute with your own userid How to Connect: Following is detailed procedure to connect to our server form Microsoft Windows operating system. We are using wc3270 Emulator supplied along with the StarterKit. However, user is free to use any other Emulators available in market. Please note that we support only TN3270E protocol emulators. Some of the Emulators we tested with are Vista tn3270, Attachmates EXTRA Client, IBM Personal Communications latest versions and QWS 3270 Plus. If you are using these emulators all you have to do is run Connect.exe and then configure emulator to connect to IP: 127.0.0.1 port 23 screen model 4 which is 43 rows & 80 columns. Step 1: Unzip the contents of downloaded Connect.zip file to a folder say MathruTech Double click Connect.exe file

Step2: Now, double click Session1 file. You shall see below screen. In the next step we will configure font.

Mathru Technologies StarterKit v1.0

Page 2

Step3: Configuring window font size and other window properties. As shown below right click on top left corner, and select Properties.

In the Font tab; Set font size to 18 and select Lucida Console font.

Mathru Technologies StarterKit v1.0

Page 3

In Options tab; select Large cursor size and check Quick Edit Mode in Edit options

Apply the changes by clicking OK button. You should now see larger Emulator window. User can control the size of window by setting font size appropriately.

Mathru Technologies StarterKit v1.0

Page 4

zScope Terminal Emulator Configuration Settings to get connected to MathruTech Service:

Host Type IP Address Port Display type IBM Mainframe 127.0.0.1 23 Mod -4 (43x80) With Extended Attributes

Mathru Technologies StarterKit v1.0

Page 5

QWS3270 Plus Terminal Emulator Settings to get connected MathruTech Service

Vista TN3270 Terminal Emulator Settings to get connected MathruTech Service

Mathru Technologies StarterKit v1.0

Page 6

Organisation of Sample programs and related datasets

Common Datasets <userid>.COPYLIB This PDS contains all necessary common copybooks used for programming. This PDS also contains all CICS symbolic copybooks. Symbolic copybooks are generated when a BMS map is generated or assembled. Following is a brief description of members in this dataset. Users are advised to make use of this PDS for their own copybooks as well.
Member Name DFHAID DFHBMSCA DFHEIBLK SQLCA EMPLOYEE <MAP1> <MAP2> TDQMAP1 TSQMAP1 Description Standard CICS Attention Identifiers copybook Standard list of field attributes used in CICS application programs Execute Interface Block (EIB) field definitions. This is automatically copied into CICS application program SQL Communication Area copy book DCLGEN for EMPLOYEE table Symbolic map used in the sample program of CICS + DB2 Symbolic map used in the sample program using files Symbolic map used in the sample program using TDQs Symbolic map used in the sample program using TSQs

Substitute <MAP1> and <MAP2> for your respective map names. <userid>. LOADLIB This PDS contains all Load modules which are produced as a result of linking object modules. These are the modules you finally run. <userid>.OBJLIB This PDS contains all OBJECT modules which are produced as a result of compilation. <userid>.DB2.DBRMLIB This PDS contains all DBRMs produced by DB2 bind. <userid>.TEMPLIB This PDS contains all programs generated as part of precompiler steps. <userid>.JOBLIB This PDS contains all JCLs required to compile and run various programs and utilities. Following is a brief description of members in this dataset
Member Name BMSGEN CICSCL Description Generates BMS physical map and symbolic map Pre compile, compile and link a CICS program

Mathru Technologies StarterKit v1.0

Page 7

CICSDB2 COBCL COBCLR COBCMLNK COBCOMP COBLINK COBRUN DB2BIND DB2CL DB2PREC DB2RUN

Compile and link COBOL + CICS + DB2 program Compile and link a COBOL program Compile, link and run a COBOL program Compile COBOL main program and subprogram and to link them together Compile a COBOL program Link a COBOL program Run a COBOL program DB2 bind utility JCL Compile and link a DB2 program Pre compile a DB2 program Run a DB2 program

<userid>.JCLUTILS This PDS contains all sample JCLs demonstrating usage of various JCL utilities. Following is a brief description of members in this dataset
Member Name CALLPROC1 CALLPROC2 CALLPROC3 CATOLOG1 CATALOG2 DFSORT1 DFSORT2 GDGADD GDGCREAT GDGDEL IDCAMDEL IDCAMS IEBCMPR1 IEBCMPR2 IEBCOPY1 IEBCOPY2 IEBGENR1 IEBGENR2 IEBGENR3 IEBGENR4 IEHPRGM1 IEHPRGM2 IEHPRGM3 IEHPRGM4 IEHPRGM5 Description Instream PROC example Cataloged PROC example Cataloged PROC with symbolic parameters example Cataloged proc used in CALPROC2 (a sample JCL for cataloged procedures) Cataloged proc used in CALPROC3 (a sample JCL for cataloged procedures) DFSORT utility DFSORT utility with INCLUDE parameter Adds a generation to a GDG dataset Creates a GDG base data set Deletes a GDG base data set Delete a VSAM KSDS data set using IDCAMS utility Create VSAM KSDS data set using IDCAMS utility Compare two partitioned data sets using IEBCOMPR utility Compare two sequential data sets using IEBCOMPR utility Unload PDS to a PS dataset and loads that PS dataset to another PDS using IEBCOPY utility Copy selected members of PDS to another PDS using IEBCOPY utility Copy one PS to another PS using IEBGENER utility Copy one PS to a PDS member using IEBGENER utility Copy a PDS member to another PDS member using IEBGENER utility Copy a PDS member to a PS using IEBGENER utility Uncatalog a PS and a PDS using IEHPROGM utility Catalog a PS and a PDS using IEHPROGM utility Rename a PS and a PDS using IEHPROGM utility Rename a member of a PDS using IEHPROGM utility Delete a PS and a PDS using IEHPROGM utility

Mathru Technologies StarterKit v1.0

Page 8

IEHPRGM6 PARMJCL REPRO1 REPRO2 SYSINJCL

Delete a member of a PDS using IEHPROGM utility Passing data from JCL PARM parameter to a COBOL program Load a sequential dataset to a VSAM KSDS file using IDCAMS REPRO utility Unload a VSAM KSDS file to a sequential data set using IDCAMS REPRO utility Passing data from a JCL SYSIN to a COBOL program

<userid>.COBOL.SRCLIB This PDS contains all COBOL Source programs. Following is a brief description of members in the dataset
Member Name ARITHVEB CALLED1 CALLING1 COMPUTE1 EVALPGM IFSTAT1 INDXFIL1 INDXFIL2 INDXFIL3 INDXFIL4 PARMPGM1 PERFORM1 PERFORM2 SEQFILE SYSINPGM TABLE1 TABLE2 TABLE3 Description Using Arithmetic verbs ADD, SUBTRACT, MULTIPLY, DIVIDE Sub program for main program CALLING1 Main program calling sub program CALLED1 Using COMPUTE verb Using EVALUATE statement Using IF statement Loads an indexed file IPAYROLL from a sequential file PAYROLL Reads an indexed file IPAYROLL Reads the indexed file IPAYROLL for a given key value when access mode is RANDOM Updates IPAYROLL using the transaction file TRANSPAY Gets data from PARM parameter in a JCL Using PERFORM and PERFORM...THRU statements Using PERFORM...TIMES and PERFORM...VARYING statements Loads data into sequential file PAYROLL which is used as input to create VSAM KSDS file IPAYROLL Receives data from JCL SYSIN Table handling program Table handling program using SEARCH statement and INDEXED BY clause Table handling program using SEARCH ALL statement

<userid>.CICS.SRCLIB This PDS contains all CICS COBOL Source programs and CICS BMS macros source members. Following is a brief description of members in the dataset.
Member Name TDQMAP1 TDQPGM1 <PROGRAM1> <PROGRAM2> TSQMAP1 TSQPGM1 Description Map used in the sample program using TDQs Sample program using TDQs Sample program demonstrating CICS + DB2 Sample program demonstrating KSDS file handling in CICS COBOL program Map used in the sample program using TSQs Sample program using TSQs

Mathru Technologies StarterKit v1.0

Page 9

<MAP1> <MAP2>

Map used in sample program of CICS + DB2 Map used in the sample program using files

Substitute <PROGRAM1> and <PROGRAM2> to your respective program names. <MAP1> and <MAP2> to your respective map names.

User CICS programming environment

CICS Transaction IDs: Each user is provided with two transaction IDs. You will receive names of these transaction IDs in Welcome Mail. The related PCT entries have already been made in CICS region. CICS Programs: Each user is provided with four CICS programs, you will receive names of these in Welcome Mail. All necessary PCT & PPT entries for these programs have already been defined in CICS region. BMS Maps: Each user is provided with four BMS Maps, you will receive names of these in Welcome Mail. All necessary PPT entries for these maps have already been defined in CICS region. Allocated TDQ: Each user is provided with one TDQ name, you will receive the name in Welcome Mail. TSQ: User is free to use whatever name he wishes to name TSQ, however he/she is allowed to use only one TSQ at a time in a program. Allocated Files: Each user is provided with two VSAM KSDS files, you will receive the names in Welcome Mail. The related FCT entries have already been made in CICS region.

How to enter into CICS region

From TSO prompt type CICS To come out of CICS region type CESF as the transaction code, control will go back to TSO prompt

How to reach ISPF Primary menu

From TSO prompt type ISPF

How to check JOB spool

From Primary Menu type SDSF or 10 which takes you to SDSF primary option menu, wherein you can type ST to view job spool. From any other panel you can just type =SDSF on command line.

Mathru Technologies StarterKit v1.0

Page 10

DB2 SAMPLE DATABASE SCHEMA Table: EMPLOYEE

Column name EMPNO FIRSTNAME LASTNAME WORKDEPT HIREDATE SALARY PROJCODE DESIGNATION Data type CHARACTER CHARACTER CHARACTER CHARACTER DATE DECIMAL CHARACTER CHARACTER Length 6 12 12 3 4 ( 9, 2 ) 6 8 Column Nulls No No No Yes No No Yes No Keys Primary Key

Foreign key Referencing DEPTNO of DEPARTMENT

Foreign key Referencing PROJNO of PROJECT

Table: PROJECT
Column name PROJNO PROJNAME DEPTNO STARTDATE ENDDATE Data type CHARACTER VARCHAR CHARACTER DATE DATE Length 6 24 3 4 4 Column Nulls No No No Yes Yes Keys Primary Key

Table: DEPARTMENT
Column name DEPTNO DEPTNAME Data type CHARACTER VARCHAR Length 3 36 Column Nulls NO NO Keys Primary Key

Support:
Our Support staff will be happy to help you any time, mail us support@mathrutech.com Alternatively you can reach us on +91-9840388798 / +91-9444350933

Wish you happy programming in Mainframes technologies

Mathru Technologies StarterKit v1.0

Page 11