àmiãm

'»l!«j

W&È GRAFl iiiiiilif A PACKAGE FOR PROGRAMMING I l THE IBM 2250 DISPLAY UNIT

by

A.ENDRIZZI

β'?

EURATOM H- 4. Í972

1972

.

Joint Nuclear Research Centre Ispra Establishment-Italy

.

Scientific Data Processing Centre-CETIS

m'w'iSH«"

-'iaiM^'i'S-

iliU'Mt.:'Mil

LEGAL NOTICE

l.\k

This document was prepared under the sponsorship of the Commission of the European Communities.

Neither the Commission of the European Communities, its contractors nor any person acting on their behalf:

make any warranty or representation, express or implied, with respect to the accuracy, completeness, or usefulness of the information contained in this document, or that the use of any information, apparatus, method, or process disclosed in this document may not infringe privately owned rights; or

assume any liability with respect to the use of, or for damages resulting from the use of any information, apparatus, method or process disclosed in this document.

'kKt

This report is on sale at the addresses listed on cover page 4

[ at the price of B.Fr. 40. ] When ordering, please quote the EUR number and the title, which are indicated on the cover of each report.

?Η%ί

¡j4jpif|f

Printed by Ceuterick, Louvain Luxembourg, March 1972

iliJaöl'U"?!1 M'ïuf Ι ιΓ,ΗΠ

This document was reproduced on the basis of the best available copy.

■

mit • :

riíii»'«·

EUR 4789 e

GRAFI — A P A C K A G E FOR P R O G R A M M I N G T H E IBM 2250 DISPLAY UNIT by A. ENDRIZZI

Commission of the European Communities Joint Nuclear Research Centre — Ispra Establishment (Italy) Scientific Data Processing Centre — CETIS Luxembourg, March 1972—18 Pages — B . F r . 40.—

The GRAFI package provides the Fortran Cobol and PL1 programmer a flexible and easy to use interface with the IBM 2250 display unit.

Programs requiring graphic output and/or man-machine interaction, may be implemented using GRAFI subroutines for displaying graphic forms, for scaling and plotting of variables and for communication between the program and the 2250 operator. They are written using IBM Graphic Subroutine Package and may be used in conjunction with it.

EUR 4789 e

GRAFI — A P A C K A G E FOR P R O G R A M M I N G T H E IBM 2250 DISPLAY UNIT by A. ENDRIZZI

Commission of the European Communities Joint Nuclear Research Centre — Ispra Establishment (Italy) Scientific Data Processing Centre — CETIS Luxembourg, March 1972—18 Pages — B.Fr. 40.—

The GRAFI package provides the Fortran Cobol and PL1 programmer a flexible and easy to use interface with the IBM 2250 display unit.

Programs requiring graphic output and/or man-machine interaction, may be implemented using GRAFI subroutines for displaying graphic forms, for scaling and plotting of variables and for communication between the program and the 2250 operator. They are written using IBM Graphic Subroutine Package and may be used in conjunction with it.

EUR 4789 e

GRAFI — A PACKAGE FOR P R O G R A M M I N G T H E IBM 2250 DISPLAY UNIT by A. ENDRIZZI

Commission of the European Communities Joint Nuclear Research Centre — Ispra Establishment (Italy) Scientific Data Processing Centre — CETIS Luxembourg, March 1972 — 18 Pages — B.Fr. 40.—

The GRAFI package provides the Fortran Cobol and PL1 programmer a flexible and easy to use interface with the IBM 2250 display unit.

Programs requiring graphic output and/or man-machine interaction, may be implemented using GRAFI subroutines for displaying graphic forms, for scaling and plotting of variables and for communication between the program and the 2250 operator. They are written using IBM Graphic Subroutine Package and may be used in conjunction with it.

EUR 4789 e

COMMISSION OF THE EUROPEAN COMMUNITIES

G R A F I A PACKAGE FOR PROGRAMMING

THE IBM 2250 DISPLAY UNIT

by

A. ENDRIZZI

1972

Joint Nuclear Research Centre Ispra Establ ishment-I ta ly

Scientific Data Processing Centre-CETIS

ABSTRACT

The GRAFI package provides the Fortran Cobol and PL1 programmer a flexible and easy to use interface with the IBM 2250 display unit.

Programs requiring graphic output and/or man-machine interaction, may be implemented using GRAFI subroutines for displaying graphic forms, for scaling and plotting of variables and for communication between the program and the 2250 operator. They are written using IBM Graphic Subroutine Package and may be used in conjunction with it.

KEYWORDS

IBM 360 COMPUTERS PROGRAMMING IMAGE TUBES GRAPHS

— 3 —

INDEX

page In t roduc t i on ί?

Using t h e IBM 2250 as a p l o t t e r 6

GIMAGE 6

GDISPL 6

Communication between the program and the IBM 2250 7

GRAFI 7 GSIZE 7 GWAIT 7 GGROUP 8 GOMIT 8 GINCL 8 GCANCL 8

U t i l i t y sub rou t ines 9

GWRT ,. 9 GWRF 9 GWRI 9 GRDT 1 0 GRDF 1 0 GRDI 1 0 GWRRD 10 GLIST 11 GDES 12 GUPDAT 13

Conjunction with IBM Graphic Subrout ine Package 15

System informat ions 1 6

Bibl iography 17

— 5·

I n t r o d u c t i o n *)

This p u b l i c a t i o n d e s c r i b e s sub rou t ines t h a t can be c a l l e d from a F o r t r a n ,

Cobol, PLI program t o d i s p l a y g raph ic da t a on the screen and communicate

with an IBM 2250 d i sp l ay u n i t a t t a c h e d t o an IBM S/36O Computing System.

The GRAFI package al lows the programmer t o c r e a t e g r aph i c output and t o

make h i s programs i n t e r a c t i v e even i f he i s not f a m i l i a r wi th the IBM 2250

and i t s b a s i c so f tware .

This p u b l i c a t i o n i s d iv ided i n t o f ive s e c t i o n s . The f i r s t s ec t i on p r e s e n t s

the procedure for g e n e r a t i n g da ta s e t s con ta in ing g r a p h i c informat ions

t h a t can be d i sp layed a t a l a t e r t ime . This use of the 2250 i s very s i m i l a r

t o the use of a o f f - l i n e p l o t t e r . The second s e c t i o n de sc r ibe s subrou t ines

t h a t enable communication between the 2250 use r and h i s program. The

t h i r d s ec t i on p r e s e n t s some u t i l i t y programs for d i sp l ay ing cu rves , for

d i sp l ay ing p r i n t e d r e s u l t s and for updat ing cards from 2250 conso le .

The package GRAFI has been implemented using IBM Graphic Subrout ines

Package and may be used in conjunct ion with i t . That i s the sub jec t of

the four th s e c t i o n .

The f i n a l s ec t i on g ives the system informat ion for having GRAFI running

on a IBM S/360 c o n f i g u r a t i o n .

Before us ing t h i s p u b l i c a t i o n the r eade r must be f a m i l i a r with the

fol lowing r e p o r t s :

Programmation r e l a t i v e au Calcomp EUR 2280

Contour map sub rou t ines EUR 2241

by Ρ. Moin i l , J . P i r e

This p u b l i c a t i o n s conta in t h e sub rou t ine s for gene ra t ing graphic forms,

s c a l i n g and p l o t t i n g of l i n e s .

The use r of GRAFI may c r e a t e the image on the screen by c a l l i n g t h e

sub rou t ine s descr ibed in t h e p u b l i c a t i o n s l i s t e d above.

Note t h a t a t t he beginning of t h e image t h e cathode ray i s supposed to be

p o s i t i o n e d a t t h e lower l e f t corner of the screen which corresponds t o

t h e o r i g i n of the u s e r ' s system of c o o r d i n a t e s .

*) M a n u s c r i p t r e c e i v e d on Oc tobe r 7> 1971

6 —

Using the IBM 2250 d i s p l a y u n i t as a p l o t t e r

The programmer may not be i n t e r e s t e d in the i n t e r a c t i v e f a c i l i t i e s of the

d i sp l ay u n i t , but in using i t as a p l o t t e r . His program does not r e q u i r e

t h e 2250 as a resource bu t gene ra t e s a da ta s e t which con ta ins g raph ic

da ta t h a t w i l l be d i sp layed by ano ther program.

The user de sc r ibe s the images ,us ing subrou t ines l i s t e d in r e f . 1 and 2 . Each new image must be preceeded by a c a l l t o GIMAGE.

CALL GIMAGE (SIZE, NFILE)

must be t h e f i r s t GRAFI subrou t ine c a l l e d .

Al l g raph ic sub rou t ine s (Ref. 1 and 2) executed nex t t o CALL GIMAGE

gene ra t e forms belonging t o the same image.

SIZE (cm.) def ines the s i z e of the s c reen .

IBM 2250 has a 30.48x30.48 cm screen and usua l ly i s SIZE = 30.48.

That means t h a t you want a 1 by 1 s c a l e r e p r e s e n t a t i o n on the

s c reen . I f SIZE i s g r e a t e r ( l e s s ) than 30.48 a l l dimensions

w i l l be a u t o m a t i c a l l y reduced ( incremented) by 30.48/SIZE.

NFILE defines the For t ran l o g i c a l number of the s e q u e n t i a l da ta

se t you have a t d i s p o s a l for s t o r i n g g r a p h i c da ta

//G0.FTXXF001 DD card with XX = NFILE conta in ing t h e d e s c r i p t i o n of t h i s

da ta se t must con ta in the following

DCB = (RECFM = VB , LRECL =