Upload
venkat-reddy-arrabiri
View
117
Download
0
Embed Size (px)
Citation preview
1
EASYTRIEVE PLUS
2
Contents
1. Introduction1.1 Capabilities
File access
Field Definition
Logic process
File Output
Report Output
3
1.2 Environment.
1.2 General Rules.
2 Structure of Easytrieve programs
2.1 Description of various sections.
2.2 Description of statements.
3 Compilation and Running
3.1 Structure of compilation and run
JCL.
4
Introduction Easytrieve plus is an information retrieval and data
management system It is a primitive form of 4GL whose English like
language and simple syntax provide the tools for easy data retrieval and report generation,
Easytrieve Plus can now produce reports in HTML format. This feature allows you to create reports that can be viewed either from a local disk or LAN or from a World Wide Web server using the Web browser
5
Capabilities File access :
Easytrieve Plus’ file access features all standard retrieval system capabilities, and also the following :
Accepts upto 890 input or output files.
Synchronises file processing (based on keys) of an unlimited number of files.
Tests for file availability and current record count.
Provides search of external & instream files.
Provides easy method for using temporary files.
6
Field Definition:
Easytrieve Plus’ methods of defining all types of record structures and field formats are consistent and easy to use, including :
Defining all field formats, including binary and unsigned packed fields.
Providing flexible edit masks.
Establishing initial values of working-storage fields.
Providing default report headings .
Allow multiple use of field definition using COPY keyword, reducing coding and maintenance.
7
Logic Process :
Easytrieve Plus provides complete conditional logic, including :
Provides standard programming constructions such as nested IF, DO WHILE and PERFORM statements.
Supports move for corresponding fields.
Sorts on any number of keys.
8
File Output :
Routine file maintenance is faster and simpler because of Easytrieve Plus’ enhanced capabilities, including :
Allowing an unlimited number of input and output files.
Loading and updating files, including VSAM, IMS/DLI, IDMS and SQL.
Saving report extract work files for subsequent use.
Provides a selective hex dump of a file or specific fields.
9
Report Output :
Report generation is the most powerful feature of Easytrieve Plus. The following features make it widely acceptable to users :
Produces unlimited reports from a single pass of the data.
Automatically formats reports.
Provides customizing alternatives to all report formats.
Provides control breaks on any number of keys.
Creates summary reports containing subtotals.
10
Environment
Easytrieve Plus operates on the IBM 370, 30xx, 43xx and compatible processors in the DOS/VSE, OS/VS, MVS/ESA and VM/CMS environments.
Under TSO, CMS and ICCF, Easytrieve Plus can run interactively for data inquiry, analysis and reporting.
The output can be either returned back to the screen or routed to a printer.
11
General Rules A colon is used to qualify non-unique field name An asterisk in the first column indicates a
comment. No comments are allowed between continuations lines
A plus sign indicates that the statement continues with the first non-blank character in the next statement area.
12Structure of Easytrieve Program
Easytrieve Programs have three main sections :
Environment Section Library Section One or more Activity Sections
13
Environment section
This section is used for customizing the operating environment for the duration of program compilation and execution. This section is optional and if not specified, a default environment is set.
Keyword used in this section : PARM
Example : PARM LINK (EZTPGM1)
14
DEBUGGING DEBUG parameter of the PARM statement is
used to generate the output which is helpful in analyzing programming errors
DEBUG subparameters are– DMAP - Data definitions for all files and working
storage– FLDCHK - validates all file/field references– FLOW - traces statement logic– STATE - gives statement number of the current
statement executed when abnormal termination occurs
15
XREF - produces a cross-reference of field-name, file-names, procedure-names
Examples– PARM DEBUG (DMAP FLDCHK STATE)
16
LIBRARY SECTION The Library section of the program is used to
define all input, output and working storage fields used in the program
17
The FILE statement describes an input or output file and is coded in the Library section.
The syntax isFILE ddname IS [ES] [F]
F lrecl
V maxlrecl+4
U blksize
FB (lrecl blksize)
VB (maxlrecl+4 maxblksize+4)
18
Field Definition Statement field-name start-location field-length
+ data-type [decimal-positions] + [HEADING ‘literal’] + MASK ([letter] [BWZ] [‘literal’]) [VALUE literal] [RESET]
19
Field-name Field name must be unique within a file. The name can be 1 to 40 alphanumeric
characters. Special characters can be used, but not
delimiters
20
Start-location The start location of a filed is the position of
its first character of data relative to the position of the first character of data in the record
21
Defining data structure:
Type Max. Length
A Alphanumeric 32, 767 N Numeric 18 P Packed 10 U Unsigned Packed 9 B Binary 4
22
HEADING Parameter
used to specify an alternative column heading for a field
Eg. CL-NAME 5 20 A HEADING + ‘CLIENT NAME’ produces the column heading as CLIENT NAME
23
MASK An Edit mask is a pattern of characters specifying
how non-alphanumeric data is to be printed. Alphanumeric fields cannot be edited. An edit mask is created using combinations of the following characters:
9 Formats digits. Z Suppresses Leading zeroes * Replaces leading zeroes with an asterisk - Prints a minus sign prior to the first non-zero
24
MASK digit of a negative number
$ Prints a currency symbol prior to the first non- zero digit.
Eg. For Date ‘Z9/99/99’ For Negative number ‘-,---,9.99'
25
MASK ([letter] [BWZ] [‘literal’])
Letter is used to name the edit mask that follows it. If we name a mask, we can reuse it on other field definitions just by specifying the name. A name can be any letter from A thru Y.
26
BWZ (Blank When Zero) specifies that a field should not be printed if the entire field contains zeroes
System Default MasksPAY 10 5 N 0 - ‘ZZ,ZZZ-’PAY 10 5 N 2 - ‘ZZZ.99-’PAY 10 5 N - ‘99999’
27
REDEFINITION Redefinition can be done in the following DOB 103 6 N MM 103 2 N
DD 105 2 N YY 107 2 N
28
Working Storage fields can be defined by
specifying W as the start location VALUE option in the field definition statement is
used to initialize the contents of a working storage field.
RESET - restores the field to its initial value whenever JOB or SORT is executed
29
Activity section
An activity section can be one of two type : JOB or SORT
A JOB activity is where program logic is coded. It can also contain a REPORT subactivity which generates the formatted report
The SORT activity is simply used to sort the data before doing other processing
30
JOB activity
Syntax:
JOB INPUT (file-name) START proc-name] +
NULL [FINISH proc-name]
SQL
file-name :Automatic input files to the activity.
proc-name :Procedures to run at the start and/or finish of the activity.
– START to identify a procedure to be executed during initiation of the JOB activity
– FINISH to identify a procedure to be executed during the normal termination of the JOB activity
31
Sort activity
This section is used to sort a data file.
Syntax:
SORT file-1 TO file-2
USING (field1 [D]…) +
[BEFORE proc-name]
32
JOB STATEMENT It identifies the name of the input file Syntax
JOB INPUT [file-name] + [NAME job-name]
The optional name parameter names the JOB activity. It can be up to 40 characters long. It can begin with A-Z or 0-9, it cannot consist of all numeric characters. This parameter is for documentation only.
33 Processing within a JOB activity is dependent on
the condition (IF) statements in the program Syntax IF field-one (EQ OR NE OR GT OR GE OR
LT OR LE) (FIELD TWO OR LITERAL OR ARITHMETIC EXPRESSION)
[Statements executed for true IF] [ELSE] [Statements executed for false IF] [END-IF]
34ASSIGNEMENT STATEMENT
The Assignment statement establishes a value in a filed.
Syntax
field-name [INTEGER] [ROUNDED OR TRUNCATED] EQ field-name-2 or literal or arithmetic expression
The are 4 arithmetic operations *, /, + and -
35
If INTEGER is used with TRUNCATED then only the INTEGER function is performed.
INTEGER, ROUNDED and TRUNCATED are valid only with Numeric fields only
36
REPORT The are two parts to every report subactivity
REPORT Statement - which specifies the type and physical characteristics of the report
Report Definition Statements - which defines the content of the report
37
REPORT Statement Report Statement is first coded in the report
subactivity Syntax
REPORT report-name +
[PAGE SIZE nn] [LINE SIZE nn] +
[SKIP nn] [SPACE nn] [NO ADJUST] +
[NODATE] [NOPAGE] [NOHEADING] +
[LIMIT nn] [EVERY nn]
38
PAGESIZE -Lines per page (Default is 58) LINESIZE-Length of each line (132) SKIP -Number of blank lines to be inserted
between line groups (0) SPACE -Number of blank lines inserted
between field columns and between fields and literals in title and detail lines(3)
NOADJUST -Requests that the title lines and report be left-justified on the page. The default is for the report to be centered on the page
39
NODATE -Inhibits printing the date in positions one through eight of the first title line
NOPAGE -Inhibits the printing of a page number.
NOHEADING-Inhibits the printing of column headings
LIMIT -Limits the number of records printed on the report
EVERY -Specifies that only every nth line is printed in the report
40
Report Definition Statements This is the second part of a report subactivity and
these statements define the content of the report. This has to be coded immediately after the REPORT statement in the following order– SEQUENCE– CONTROL– SUM– TITLE– HEADING– LINE
41
SEQUENCE This statement allows to specify the order of the data
in the report Sequence can be done on any field from input file or
any W working storage field Sequence fields are stated in major to minor order Sequence order is ascending. Coding D after a field-
name reverses the order for that field only.
Syntax
SEQUENCE field-name-1 [D] …. +
field-name-n [D]
42CONTROL
A CONTROL Statement specifies that a report should automatically accumulate and print totals. A control break occurs whenever the value of any control field changes or end-of-report is reached
A CONTROL field can be any nonquantitative field from any input file or working storage field
At each control break, the totals are printed for the quantitative fields specified in the report
Unlimited number of control fields can be specified.
43
Fields are coded on the CONTROL statement in a major to minor order.
SyntaxCONTROL Field-name NEWPAGE NOPRINT
FINAL RENUM – Final totals are automatically provided. You can alter
the default by coding FINAL NOPRINT– NOPRINT following any field-name or FINAL
suppresses the printing of totals at that control break.
44
NEWPAGE following any field or FINAL causes a new page with page numbers beginning at one after the printing of the control break totals (in case of final, before the printing of the final totals)
RENUM following any field or final causes a new page with page numbers beginning at one after the printing of the control break totals (in case of FINAL before the printing of the final totals)
45
SUM The SUM statement specifies the quantitative
fields to be totaled for a control report Normally easytrieve Plus totals all quantitative
fields specified on the LINE statement, but the sum statement overrides this process.
Only the fields specified on the SUM statement are totalled.
Syntax
SUM quant-field-1 ….. quant-field-n
46
TITLE STATEMENT The TITLE statement allows you to define a title for
the report. Up to 99 titles are permitted.
Syntax
TITLE [nn] +/- nn field-name
COL nn literal +/-nn is used to alter the normal spacing between
literals or fields on the title lines (nn spaces are added to or subtracted from the SPACE parameter
47
COL nn specifies the print column number where the next title item is to begin.
If this option is specified then NOADJUST should also be specified on the REPORT statement
If no TITLEs are coded, the date and page number are not printed.
48
HEADING STATEMENT The HEADING subactivity OVERRIDES a
HEADING parameter coded in the Library section
Syntax
HEADING field-name (‘literal’ ….)
Eg. HEADING EMP-NO (‘EMPLOYEE’ ‘NUMBER’)
49
LINE STATEMENT The LINE statement defines the content of a
report line. LINE 1 is used to designate headings for the
report columns.
Syntax
LINE nn +/-nn field-name
POS nn literal
COL nn
50
+/- is used to alter the normal spacing between line items. nn is added to or subtracted from the SPACE parameter
POS is for aligning fields under the corresponding column heading positions indicated on the LINE 1 statement.
COL nn specifies the print column number where next field is to begin.
51
TALLY TALLY is a system defined field for control
reports. It contains the number of detail records printed
within each control break and can be printed on the report.
It can only be used in control reports and the value of TALLY only appears on summary lines.
52
Relative start-location
– We can define the start-location of a field relative to a previously defined position in the record.
– Relatively defining a start-location eliminates the need to identify the actual start-location of a field
– This is most useful when we create output files
Example
EMP# * 5 N
NAME * 16 A
FILLER1 * 10 N
ADDRESS * 39 A
The ADDRESS field would then start in pos 32 in the record
53 Relative Redefinition
– You can relatively redefine a field by designating the original field-name as the starting location for all subsequent fields in the redefinition
– ExampleDOB W 6 N
MM DOB 2 N
DD DOB +2 2 N
YY DOB +4 2 N
The starting position of the redefined field is designated by using the original field plus the sum of the lengths of all previous fields used in the redefinition.
54
STOP STATEMENT A STOP statement allows you to terminate an
activity Syntax
STOP [EXECUTE]
STOP ends the current activity and goes on to the next activity if additional activities are coded.
STOP EXECUTE immediately terminates all EASYTRIEVE PLUS execution.
55
DISPLAY A DISPLAY statement sends data to a specified
output file or output device. This is commonly used
– For error messages.
– For highlighting reports.
– For hex display of selected information
56
Syntax (Format I)
DISPLAY [file-name] NEWPAGE +INTEGER +
SKIP number COL integer
POS integer
literal-1 ….. Literal-n
field-name-1 ….. Field-name-n If you specify the file-name, EASYTRIEVE
PLUS prints data to the named file. If file name is not specified the default is SYSPRINT/SYSLST (EASYTRIEVE PLUS output files)
57 NEWPAGE option specifies that a skip to a new page occurs before the data is printed.
SKIP option specifies that the designated number of lines are skipped before the data is printed.
Coding integer modifies the horizontal spacing between display items.
The COL integer option specifies the print column number where EASYP places the next display item.
The POS integer option on DISPLAY statements within report procedures causes the next display item to be positioned under the corresponding position on LINE 1 statement.
58
Syntax (Format II)DISPLAY [file-name] NEWPAGE HEX field-name
SKIP number file name In this format , EASYTRIEVE PLUS produces a
hexadecimal and character dump of the current record or the specified field-name
The parameter other than HEX, operate the same as in Format I
59
REPORT statement Syntax
– REPORT report-name [DTLCTL FIRST]
EVERY
NONE
[SUMCTL HIAR DTLCOPY]
NONE
TAG
[SUMMARY]
[SUMFILE file-name]
[PRINTER file-name]
60
DTLCTL determines when control field values are printed on detail lines :
FIRST detail line (Default) EVERY detail line NONE of the detail lines
SUMCTL determines when control field values are printed on total summary lines
HIAR prints all fields from major control to minor control as far as the breaking field. This is default.
61
NONE inhibits printing of control field values on total lines
TAG prints the control field name and the literal TOTAL on the left side of the subtotals
DTLCOPY print all values from detail lines onto summary lines
SUMMARY produces a summary report that contains only total lines.
SUMFILE generates a summary file.
62A summary file is a file that contains the
values for all control and summed fields at each minor break.
The summary file can be process by subsequent JOB activities
Summary file can be requested by defining the file in the library and then creating it via REPORT SUMFILE parameter.
63
VFM Virtual File Manager (VFM) provides an easy
method for establishing temporary work files without special job control or file allocation statements.
It is a sequential access method for program work files
It dynamically allocates space in memory for work files when sequencing a report or when producing multiple reports
64
CALL Statement invokes an external subprogram. The called program is an existing program in another
language Syntax
CALL program-name USING field-name …… +
RETURNS field-name-2
GOTO or GO TO statement is used to modify the natural top-to-bottom logic flow in a program
Syntax
GO TO or GOTO label/JOB
A label can be up to 40 characters long and it must be in the same activity or procedure
65
FILE PROCESSING EASYTRIEVE PLUS process the following file
types– SAM– ISAM– VSAM– IMS/DLI– IDMS
File processing can be done either Automatically (using JOB or SORT) or programmer controlled (using GET, PUT, READ, WRITE …)
66
The GET Statement retrieves the next record of the named file into the file input area
Syntax GET file-name
file-name is input file name
EOF - Test of end-of-file when using the GET command
PUT statement outputs a file sequentially
Syntax
PUT outfile [FROM file-name]
67
File processing fields RECORD-LENGTH is a two byte binary field with
zero decimal places used for all file types to determine or establish the length of the current data record. For variable length records, this field contains only the length of the records data
RECORD-COUNT is a read-only four byte binary field with zero decimal places which contains the number of logical I/O operations performed on a file
FILE-STATUS contains the results of most recent I/O operations on a file
68
TABLES A table is a collection of uniform data records in
a form suitable for quick reference– A search argument (keyword ARG) that uniquely
identifies that entry– A description (Keyword DESC) is the data associated
with the argument The user’s objective is to obtain the description
from a table of values based on the search argument
69
A table file must be arranged in ascending order by argument
No duplicate arguments can be places in the file A minimum of three entries are required in a
table
Syntax
FILE file-name TABLE INSTREAM
literal– INSTREAM denotes that the table file immediately
follows the file description
70
Literal specifies the number of entries in an external table. Specify a value here only if the number of entries is greater that 256
ENDTABLE must be the last entry in the instream table data
71
Instream exampleFILE STATTBL TBLE INSTREAM
ARG 1 2 N
DESC 4 15 A
01 ALBAMA
02 ALASKA
03 ARIZONA
ENDTABLE
72 SEARCH statement is used to perform an in-core
binary search of a table.
Syntax
SEARCH file-name WITH field-name-1
GIVING field-name-2
Field-name-1 is the name of a field which contains a value that is compared to the search argument
Field-name-2 is the name of a field into which the description is places if a match exists between field-name-1 and the search argument.
73
Example of an Easytrieve program
FILE PERSNL FB(150 1500)
NAME 17 8 A
EMP# 9 5 N
DEPT 98 3 N
NET 90 4 P 2
GROSS 94 4 P 2
74
JOB INPUT PERSNL NAME FIRST-PGM
*
REPORT PAY-RPT LINESIZE 80
SEQUENCE DEPARTMENT NAME
CONTROL DEPARTMENT
TITLE 01 ‘PERSONNEL REPORT’
TITLE 02 ‘SECOND TITLE’
HEADING EMP# (‘EMPLOYEE’ ‘NUMBER’)
LINE 01 NAME DEPT EMP# +
GROSS NET
75
OUTPUT09/03/01 PERSONAL REPORT PAGE 1
SECOND TITLE
EMPLOYEE
NAME DEPT NUMBER GROSS NET
RAJ 911 01963 445.50 300.00
RAMAN 01234 100.00 100.00
911 545.50 400.00
SUMIT 912 24689 100.00 200.00
912 100.00 200.00
645.50 600.00
76
Structure of compilation and run JCL
//jobname accounting info
//STEPNAME EXEC PGM=EZTPA00,REGION=300K
//SYSPRINT DD SYSOUT=*
//SYSLIN DD DSN=obj-module-dsn,DISP=…
//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,1)
//EZTVFM DD UNIT=SYSDA,SPACE=(CYL,1)
//userfile DD dd-parms
//SYSIN DD DSN=program-ds,DISP=SHR
77
Thank You