StarterKit_v1.0

StarterKit v1.0

Author: Manjusha

Date: 14 Apr 2011

Mathru Technologies StarterKit v1.0 Page 2

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, Attachmate’s 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.


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.


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.


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

Host Type IBM Mainframe

IP Address 127.0.0.1

Port 23

Display type Mod -4 (43x80)

With Extended Attributes


QWS3270 Plus Terminal Emulator Settings to get connected MathruTech Service

Vista TN3270 Terminal Emulator Settings to get connected MathruTech Service


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 Description

DFHAID Standard CICS Attention Identifiers copybook

DFHBMSCA Standard list of field attributes used in CICS application programs

DFHEIBLK Execute Interface Block (EIB) field definitions. This is automatically copied into CICS application

program

SQLCA SQL Communication Area copy book

EMPLOYEE DCLGEN for EMPLOYEE table

<MAP1> Symbolic map used in the sample program of CICS + DB2

<MAP2> Symbolic map used in the sample program using files

TDQMAP1 Symbolic map used in the sample program using TDQs

TSQMAP1 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


BMSGEN Generates BMS physical map and symbolic map

CICSCL Pre compile, compile and link a CICS program


CICSDB2 Compile and link COBOL + CICS + DB2 program

COBCL Compile and link a COBOL program

COBCLR Compile, link and run a COBOL program

COBCMLNK Compile COBOL main program and subprogram and to link them together

COBCOMP Compile a COBOL program

COBLINK Link a COBOL program

COBRUN Run a COBOL program

DB2BIND DB2 bind utility JCL

DB2CL Compile and link a DB2 program

DB2PREC Pre compile a DB2 program

DB2RUN 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


CALLPROC1 Instream PROC example

CALLPROC2 Cataloged PROC example

CALLPROC3 Cataloged PROC with symbolic parameters example

CATOLOG1 Cataloged proc used in CALPROC2 (a sample JCL for cataloged procedures)

CATALOG2 Cataloged proc used in CALPROC3 (a sample JCL for cataloged procedures)

DFSORT1 DFSORT utility

DFSORT2 DFSORT utility with INCLUDE parameter

GDGADD Adds a generation to a GDG dataset

GDGCREAT Creates a GDG base data set

GDGDEL Deletes a GDG base data set

IDCAMDEL Delete a VSAM KSDS data set using IDCAMS utility

IDCAMS Create VSAM KSDS data set using IDCAMS utility

IEBCMPR1 Compare two partitioned data sets using IEBCOMPR utility

IEBCMPR2 Compare two sequential data sets using IEBCOMPR utility

IEBCOPY1 Unload PDS to a PS dataset and loads that PS dataset to another PDS using IEBCOPY utility

IEBCOPY2 Copy selected members of PDS to another PDS using IEBCOPY utility

IEBGENR1 Copy one PS to another PS using IEBGENER utility

IEBGENR2 Copy one PS to a PDS member using IEBGENER utility

IEBGENR3 Copy a PDS member to another PDS member using IEBGENER utility

IEBGENR4 Copy a PDS member to a PS using IEBGENER utility

IEHPRGM1 Uncatalog a PS and a PDS using IEHPROGM utility

IEHPRGM2 Catalog a PS and a PDS using IEHPROGM utility

IEHPRGM3 Rename a PS and a PDS using IEHPROGM utility

IEHPRGM4 Rename a member of a PDS using IEHPROGM utility

IEHPRGM5 Delete a PS and a PDS using IEHPROGM utility


IEHPRGM6 Delete a member of a PDS using IEHPROGM utility

PARMJCL Passing data from JCL PARM parameter to a COBOL program

REPRO1 Load a sequential dataset to a VSAM KSDS file using IDCAMS REPRO utility

REPRO2 Unload a VSAM KSDS file to a sequential data set using IDCAMS REPRO utility

SYSINJCL 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


ARITHVEB Using Arithmetic verbs ADD, SUBTRACT, MULTIPLY, DIVIDE

CALLED1 Sub program for main program CALLING1

CALLING1 Main program calling sub program CALLED1

COMPUTE1 Using COMPUTE verb

EVALPGM Using EVALUATE statement

IFSTAT1 Using IF statement

INDXFIL1 Loads an indexed file IPAYROLL from a sequential file PAYROLL

INDXFIL2 Reads an indexed file IPAYROLL

INDXFIL3 Reads the indexed file IPAYROLL for a given key value when access mode is RANDOM

INDXFIL4 Updates IPAYROLL using the transaction file TRANSPAY

PARMPGM1 Gets data from PARM parameter in a JCL

PERFORM1 Using PERFORM and PERFORM...THRU statements

PERFORM2 Using PERFORM...TIMES and PERFORM...VARYING statements

SEQFILE Loads data into sequential file PAYROLL which is used as input to create VSAM KSDS file

IPAYROLL

SYSINPGM Receives data from JCL SYSIN

TABLE1 Table handling program

TABLE2 Table handling program using SEARCH statement and INDEXED BY clause

TABLE3 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.


TDQMAP1 Map used in the sample program using TDQs

TDQPGM1 Sample program using TDQs

<PROGRAM1> Sample program demonstrating CICS + DB2

<PROGRAM2> Sample program demonstrating KSDS file handling in CICS COBOL program

TSQMAP1 Map used in the sample program using TSQs

TSQPGM1 Sample program using TSQs


<MAP1> Map used in sample program of CICS + DB2

<MAP2> 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.


DB2 SAMPLE DATABASE SCHEMA

Table: EMPLOYEE

Column name Data type Length Column Nulls Keys

EMPNO CHARACTER 6 No Primary Key

FIRSTNAME CHARACTER 12 No

LASTNAME CHARACTER 12 No

WORKDEPT CHARACTER 3 Yes Foreign key

Referencing DEPTNO of DEPARTMENT

HIREDATE DATE 4 No

SALARY DECIMAL ( 9, 2 ) No

PROJCODE CHARACTER 6 Yes Foreign key

Referencing PROJNO of PROJECT

DESIGNATION CHARACTER 8 No

Table: PROJECT


PROJNO CHARACTER 6 No Primary Key

PROJNAME VARCHAR 24 No

DEPTNO CHARACTER 3 No

STARTDATE DATE 4 Yes

ENDDATE DATE 4 Yes

Table: DEPARTMENT


DEPTNO CHARACTER 3 NO Primary Key

DEPTNAME VARCHAR 36 NO

Support:

Our Support staff will be happy to help you any time, mail us [email protected]

Alternatively you can reach us on +91-9840388798 / +91-9444350933

Wish you happy programming in Mainframes technologies

Documents

StarterKit_v1.0