Text preview for : SB11-5351-0_ConversionAid_System3toDOS_VSE_ProgramDescriptionAndOperationsManual_5785-KAD_Jul79.pdf part of IBM SB11-5351-0 ConversionAid System3toDOS VSE ProgramDescriptionAndOperationsManual 5785-KAD Jul79 IBM system3 SB11-5351-0_ConversionAid_System3toDOS_VSE_ProgramDescriptionAndOperationsManual_5785-KAD_Jul79.pdf



Back to : SB11-5351-0_ConversionAid | Home

sB1 -5351-0
1




Conversion id System/3
A
to DOS/VSE
lnternational i e l d
F P r o g r a mD e s c r i p t i o n
Program and Operations anual M
Program Number 5785-KAD
PREFACE

This publicationprovides the informationrequiredby a
userwho want to migratefrom a System/3 iSV All listingsare in English,and a1lconstants in tablesor
are
to +:OO arraysat the end of eachprogram.This makesir easyto
Processor under DOS/VSE. It containsthe information
modify them or to tranlatethem into anotherlanguage.
neededto convertprograms and files and to preparethe In order to use the System/3to DOS/VSEConversion
corresponding control card.The assistanceconcernins file Aid program, the reader should be familiar with the
distribution is more meaningfulwhen the user is
fariiliar differences berweenSystem/3RpG and DOS/VS RpG. He
with the physical location of these
files. must alsobe familiarwith the JCL, sort specifications
The publicationis divided into three main parts: and
programs,and the charateristics the differenr access
of
"Understanding the program" containsa functional
methods.
description the programand presents
of hardwareand Beforeusingthis International Field program, reader
the
software requirements.
should be familiar with the contents of Systemf3 to
"Installingthe Program,' describes components the
the of DOSIVS ConversionGuitte, GC2O-1792andIntroduction
program as distributed and how to install
them. to DOSIVS,cC33-s370.
"Rrinning the Program"containsthe steps performing
_ in
the conversion a job stream
of and describes input and
the
output.
Apilendix A and Appendix B coutain a detailed
description eachcomponent the programand
of of of the
layout of the files used by thesecomponents. These
appendixes shouldbe consulted modifications the
for to
sourcecode. Appendix C containsa sampleproblem,
illustratingthe conversion the job streamsof
of two
programs.




First Edition (Iuly 1979)
This edition applies to version l, Modification
Level cl, o|Conversion Aid system/3
to DOS/VSE, Program Number STSS-KAD, and
to all subsequent releasesand
modifications until otherwise indicated in new
editions or Technical Newsletters.
Changes are periodically made to the information
herein; before using this
publication in connection with the operating
of IBM systems, consurt thelatest IBM
systeml3T0 Bibtiography, c'c20-0001, for the
editions that are applicable and
current.

Publications are not stocked at the address given
below; requests for IBM
publications should be made to your IBM
representative or to the IBM branch office
serving your locality.

A form for reader's comments is provided at the back
ofthis publication. Ifthe form
has been removed, comments may be addressed
to:

IBIlI Nelherlands
lnternationai Field Program Center
P.O. Box 24
I42O AA UITHOORN
Netherlands

IBM may use or distribute any of the information you
supply in any way it believes
appropriate without incurring any obligation whatever. you
may, oi continue
to use the information you supply. "ourr",

(g Copyright International
BusinessMachines Corporation 1979
CONTENTS




I NTRODUCTION 1
UNDERSTANDING THE PROGRAM
The Customizer . . z
The Conversion Program . . 3
Creating Printer Carriage Control Tapes q
Distributing Files on Disk . . 4
Documentating Installation and Files Conversion 4
Preparing the Input Job Stream for Execution . 5
Additional Conversion Modules 5
Program Conversion Functions . 5
uodifications to be Verified . 6
9unctions Not Converted 7
Miscellaneous eonversion Aids 7
l"!inimum Configuratj-ons . . 8
System/3 . . tt
SYStem,/37o or 4300 Processor . - 8

INSTALLING THE PROGRAM 14
Customi.zing the Program 14
tlataloqinq Module in the DOS/VSE Relocatable Library - 14
.l2mn1o
i J u . r r P r v
Drnhl am '14

RUNNING THE PROGRAM 16
T r r^vrs + e
rh r
16
Format of Control Statements - 17
Drnnoqq i nn 21
r\rr+ nrrl 22
listings . . 22
Messages . - 24
Miscellaneous
'I
Output . 27
I^In r iz Er i ae 29
Size of Work Files . 29
Executinq the Converted Programs on the System/370 . - 30

APPENDIX A. DESCRIPTION OF INDIVIDUAL COMPONENTS 31
The CONVOO omponent
C . - 31
The C O N V O 1C o m p o n e n t . . 32
The C O N V O 2C o m p o n e n t . . 32
The C O N V O 3C o m p o n e n t . . 34
The CONV04 Component 2q,

The CONV05 Component 36
The CONV06 Component 36
The CONVo7 Component a'l
a't
The CONV08 Component
The CONVo9 Component 1?

The C O N V 1 0C o m p o n e n t ? a

The CONV'I Component
1 ?q

The CONV12 Component ?a

The CONV13 Component ?o
'Ihe CONV14 Component tt0

APPENDIX B. LAYOUT OF RECORDS OF MAJOR FILES 41
! ^ ] O R R D S KF i I e (Direct Access, Length 128) 41
LABELS FiIe (Indexed Sequential, Length 128) 42
(Length '128) rl3
PROGRAMFiIe a n d C O N V O 2V I O R K D S K i l e
F "
CONTROL File (Length 64) t+7
OCLFILE FiIe (Length 64) 4'7



1l-t-
S3IABEL File (Lengt 64) 48
JCIFILE File (Indexed Seguential, Length 128) 48
S T R E A M SF i I e (Length 128, CONVl1, CONVl2, CONVl3, eONVl4 Componentsl 49
APPENDIX C. EXECUTION OF SAMPLE PROBLEM . . 51




l_v
INTRODUETION




when a system/3 user decides to upgrade to a system/37} or an rBM 4300
Processor, he eneounters a eertain number of difficurties. First,
System/3 RPG, in which most user programs are written, iloes not have the
same functions as DOS/VS RPG. Second, wit-hin a short time the user has
to ehange not only his programs, but also the control eards and physical
location of the files.

IBM has made the System/3 to DOS/VSE Conversion Aid International Fiel<1
Program available in order to help the System/3 user convert to DOS/VSE
and allow him to prepare for the conversion using his Systernrz3. In this
wiy, while using tools familiar to him, he can have his programs reaily
for exeeution when his Systen/3'l} or 4300 is installed.

It is recomnended that System/3 seguential files without additions to
the end of the file and treated consecutively be converted to SAM files-
Otherwise files should be eonverted to VSAM files.
gNPERSTANDING HE PROGRAM
T




The System/3 to DOS/VSE Conversion Aid International FieId Program
consists of 19 source programs writt-en in System/3 RpG and one resiilent
program written in DOS,zVSE ssembler language.
A The DOS/VSE program
should be catalogued into the DOS/VSEreloeatable Iibrary. This routine
serve as a complement to the converted System/3 programs when the chosen
met-hods is VSAM' and it is used to aecess on ESDS VSAM file or to aecess
the Data conponent of a KSDS VSAM file by relative record number.


llE_gggrgMrzER
The first four programs to be executed make up the customizer; two of
these programs can be executed on a System/3 Model 10 anrl the ot-her two
on a System/3 Model 15-B- The fcLlowinq is c n o c i f i o A -
o Usinq the S ! - I I T C Hc a r d :
- Control statement input on 80- or 96-column cards or on
diskette
- Customized output of the conversion aid programs on 80- or
96-column cards, diskette, or magnetic tape
- Output of the components to be cataloged on the DOS/VSE
relocatable library on 80-column cards, diskette, or magnetic
tape.

Configuration of the System/3 on which the eonversion programs are
to be executed:
- Input of the programs to be eonverted to 80- or 96-eolumn
eards or diskette
- Type of disk unit for work files
- Output of the eonverted programs (includinq control eards for
cataloging and printer carriage control tapes) cn B0- or
96-column cards, dlskette, or magnetic tape
- Output of the input job stream for execution under DOS/VSE on
80- or 96-column cards, diskette, or magnetic tape.

. Correspondence between System/3 deviees and System/31l deviees

r Description of Systen/310 or 4300 configuration:
- Type of disk (3330,33t{0 or FBA)
- Type of printer
- Printer line length (default value)
- Printer overflov line (default value)
- System/3'| 0 PO\,iER/VS(incl-uded or excludedf

Thi.s customizer will call an input file that contains the remaining
components of the conversion aid nr^dram
If this customizer needs to be executed on a System/3 Model 15-C or 15-
D, programs CST151 and CST152, residents in source Library, must be
compiled. The SUBR93subroutine, needed to eompile CST151 program, is
cat-aloged in R I..ibrary.


pRCGRAM
!HE_SONVERSION

CONVOO nd CONVO1, the first
a two components of the aetual conversion
program, prepare the definition and caleulate the occupancy of all the
files of the prograns to be converted-

The CONVOO ontroL cards specify the characteristies
c of all files: the
type and narne of each file, the length and number of records, and so on.
C O N V O 1p r o v i d e s a l i s t i n g of file occupancy of the logical units, and
places on a work file the informaticn reguired by subseguent components.

Sequential disk files can be converted to SAM or VSAM-ESDS. Direct-
files can be converted to VSAM-RRDS ith relative
w record number-

Inilexeil files can be converted t o V S A M - K S D So r V S A M - E S D Sw i t h alternate
indexes (if the file is created unordereil).

The CONV02 component reads the System/3 source programs. If these
programs are compatible with the file definitions, and if there are no
other unresolvable incompatibilities, C O N V O 2p l a c e s t h e m i n a w o r k f i l e -
C O N V O 2i s t h e o n l y c o m p o n e n t t h a t i s e x e c u t e d e a c h t - i m e a s o u r e e p r o g r a m
j-s converted- If a program is not aecepted, only that program need be
resubmitted.

It is assumed that all prcgrams to be converted have been execute<1
without errcr on the System/3. The CONV03 to CONV05 eomponents convert
all the source programs in a job stream placed in the work file by
C O N V 0 2 - C O N V O 5p l a c e s t h e c o n v e r t e d souree programs on the type of
media specified in the customizer.

The listings produced for each converted program contai-n:

. A listing of the converted program

o Modifications performed by the conversion aid program

r Moilifications assumed by default and which must be verified

. Functions that the program cannot convert and whieh must be
converted manually-

The conversion airl prograrn contains a large number of components in
order to execute it on a System/3 16K partition.

The programs converted using components CONVOO o CONV05 can be executed
t
under Dosi/vsE. The remaining eornponents perform the followinq
functions:

o Creating printer carriage control tapes

r Distributing files on disk

. Preparing the conversion of System/3 files to System/37O via
intermediate tape files or Data Import Feature

r Defining catalog, space, and VSAM files

. Preparinq the input iob stream for execution.
CREATING PRINTER CARRIAGECONTRCI TAPES

The CoNVO6 cornponent- processes printer carriage control tapes. First,
it reduces their number to a minimum; then it numbers them, starting
wittr the nurnber speeified in the input t-o the coNVO4 eonponent. rn
addition, it gives a name to each tape and lists its format. The
component generates the control and ilata statements used to eompile and
eatalog all the FcBs, unless an IBM 1403 printer without powER/vs is to
be used-


DISTRIBUTING FIIES CN DISK

T h e C O N V O 7c o m p o n e n t d i s t r i b u t e s files on disk. A data statement must
be entered to coNv0? for each sYsxXX definect in coNVoo to relate the
SYSXXX to the volume number and to indicate the relative position in
which the disk space of the paek must be allocated- If these statements
contain no errors' coNvOT produces an oceupancy list similar to the one
produced by eoNvO1- This list indicates the files on each paek which
may eontain one or several sysxxx. coNvo7 produces, too, a listinq of
t'he DLBLs and TIBLs in alphabetical order aieording to labels and with
blank file names.


D O C { ] M E N T A T I N GN S T A L I A T I C } i A N D F I L E S C O N V E R S I O N
I

eomponents coNV0B to coNv10 docunent installation and prepare the
conversion of files from System/3 to System/370 or IBM/4300. Files can
be converted via tape medium (concerns only those files whose definition
stat.ement contain an F in column 65) or via Data Import utility if 3340
Data rmport Feature is instalted. (concerns only those fires whose
definition statement contain U in eolumn 65.)

T h e C O N C O 9c o m p o n e n t l i s t s all eontrol statements required to execute
the programs converted at this point. This listing is in alphabetical
order- according to prograr name. The control statements are prepared
assuminq the pograms use the NAME-IABEL relationship speeified in
eoNVO2. These listings may be useful if the eomponents tnat prepares
the input job stream for executicn are not used. Aqain, ttre donvog
component prepares if any file definition statement was specified with
an R in column 65:

The $TINIT statements to initalize tapes

The $coPY statements needed to dump tape files with a bloek size no
larger than 4096 bytes-


The CONV10 eornponent prepares:

o D E F I N E M A S T E RC A T A L O G s t a t e n e n t s , to which must be added the number
of the first track/bloek of the EXTENT and the name of the disk
paek from the EXTENT statement a n d f r o m t h e V O L U M Ep a r a m e t e r i n t h e
corresponding AMS statement.

o DEFINE SPACE statements.

o DEFINE CLUSTER statements to every VSAM file defined-
. DEFINE ALTERNATEINDEX and its PATH to every VSAM file defined with
type A specified.

' R E P R Os t a t e m e n t s (concerns only to those files whose definition
statement contains an F in column 65) -



4
DATA IMPORT UTILITY statements (concerns only to those files whose
definition staternent eontains a U in column 65) -

BUIID INDEX statements (concerns only those files rrrhose definition
statenent contains an R or an U in column 65 and type A specified|.


P R E P A R I N GT H E I N F U T J O B S T R E A M F O R E X E C U T I O N

Components CONVl1 to CONV14 eonvert System/3 OCL to DOS/VSE JCL- Input
can be any set of System/3 OCL control statements, but 7*, /8, and /.
records must be replaced manually by */, E/, and ./ in order to avoid
terminating the program on an end-of-fi1e condition-

1f an OCL stream is unexpectedly terminated, t h e C o N V I1 e o m p o n e n t c a n b e
executed again, beginning rrith the data that was not processed. The
createcl records will be added to the output- file.

If the OCL statements contai-n no errors, and if all programs and files
referred to in the statements have alreadv been converted:

. The DoS/VsE JCL statements required to execute the converted
programs are generated.

. System/3 COPY statements are converted to AMS REPRo statements.

. System/3 SORT control statements are eonverted, with the exceptions
given in Appendix A.

Special care is requirecl when converting SORT control statements
using the digit-portion option. These statements are not
eonverted, unless the numerie field is changed fron a D to a c or a
tl



The remaining OCI statements are transferred without change, and a
warning message is issued.


A D D I T I O N A T -C O N V E R S I O N O D U T E S
M

Vihen a System/3 program processes randomly a sequential file converted
to ESDS, the converted program calls the WKVMXV oilule-
m


P R O G B A M O N V E R S I C NF U N C I I C N S
C

The following funetions are performed by the eomponents of the program:

The H statement is transferred with its valid entries.

A11 statements are numbered and contain the name of the program-

The required entries of the F statement are changed accoriling to
the file eharacteristics and the logieal S Y S X X Xu n i t .

r File names are decreased to seven characters and are modified (if
requirerl) to avoid duplicates. The eorrespondi-ng F, E , f , C , a n d O
statements and file conversion cards are updateil.

. The first- ten compilation tables are modified to fit into 80-column
cards (if they exceed 80 positions) -
The E statement is modified from execution tables or arrays if the
nurnber of entries per record is to be modified. The number of
entries per record is also rnodified in the E statement if the
record length has been changed.

New table files are created when more than one execution table is
assigned to a file-

The L stat-ement is converted to comments, or a nesr L comment
statement is created for a printer fi1e.
Decimal positions are pl-aced in arrays or in elements of arrays
defined in I statements.

Half-adjust (H in position 53) is added for S9RT operations.
Module to convert relative record number to relative byte address
(for VSAM ESDS files) is included and flagged.

c statements added to branch to the ineluded module are updated.
C statements are added to create random RRDS files-
The ADD eharacters in the addition to sequential fires are
suppresseil.

rf nothing is addeil to an additions file, this eondition is
ilet ected.

Errors in operation codes are deteeted-

rn o statements, the skip to line number by channel srrp is
changed.

one spaee is assumed following printer lines without spacing or
SKIPS

The overflow indicator is changed from output AND lines to primary
lines -

The L0 indicator in C statenents is suppressed.

The specifieation of output spacing in eonsole files is suppressed-

M O D T F T C A T I g N ST O _ B ! _ V E R I F r E p

The following conversion actions performed by the program may not be
complete. They should be verified before compilinq the eonverted souree
proqrams.

t A warning message is issued to reminil the user that an AMs Build
Alternate Index Commandmust be executed after running a program in
which an ESDS file wlth alternate index is created-
r The staeker selection specified in I and o statements is iqnored.
r Files processed between limits and random, primary, display,
dernand' or table files are assumed not to ba affeeted bv an
external indicator.

. The record length in A D D R O U Tf i l e s is changed-
. A warning message is issued to indicate that the contents of the
T E R R O Rf i e l d should be analyzed if M fields, record sequenee
eheeking, or record identifieation checking are used in the
program.


FUNCTIOT.*NCT CONVERTED
S

The following funetions are not converted- Either the conversion must
be performed manually, or the System/3 source programs must be modified
before conversion.

r Table expansion is performed only for the first ten defineil
conpilation tables. The eleventh table and those following must be
modified rnanuallv if the data does not fit into 80-column
statements.

o A warni-ng message is issued to indicate that the execution tables
must be modified if the number of entries per reeord has been
changed.

. A warning message is issued when ilata files are converted from
96-eolumn to B0-column eards, and the defined fields exeeed the new
reeord length.

r Combined files are not allowed-

r Double I/O areas and blocking of SPECIAL files are not allowed.

. A warning message is issued when H indicators are used-

. The module used by SPECIAL files or by any files called by an exit
routine must be rewritten-

. Statements added using an Auto Report eoPY statement must be
cataloged in the R sublibrary cf the Dos/VS source statement
library.

' only 15 files are allowed per program.

. only one printer is allowed per program.

r No console files, other than output or display files, are aecepted.

. No more than 11 skip positions are allowed in a printer listing-

. Data cannot be printeil on carils.

. warning messages are issued to indieate reserved words that must be
changed-


MTgcELLANEOUS CNVERSToN rlS
C A

r A customizer adapts the programs to be eonverted to the System/3'
Systen/370 or 4300 eonfigurations used.

o printer carriage control tapes are eonverted, and the cataloging of
FCBs is prepared.

o Files and data spaces are distributed on disk.

o The execution statements of each program are listed.
Control statements to convert files to disk using magnetie tape as
intermediate step are generated-

Executj_on job streams, including about 8 0 9 6o f s o r t s a n d f i l e
eopies, are converted from System/3 to System/3?O or 4300-

I,IINI MUM CONFIGURATIClis

Tbe minimum systern/3, systen/37} or 4300 configurations requirerl by the
syst-em/3 to Dos/vsE conversion aid Tnternationit Fi"ta Frogram are given
below.


SYSTEM/3

The customizer components of the prcgran reguire, in addition to the
eonfiguration needed to exeeute the ioure. prog.u*s to be converted
(Systemrz3 Model 10 or 15), one IBM 5444 oisk siorage
Drive or one IBt"1
3340 Direct Access storage Faeility, and one maqnetic tape unit-
The program eonversion components require:
a One System/3 Model 8, 10, 12, cr 15
a A minimum of 16K bytes of partition core storage
a One data entry uni-t, any type
a one B0- or 96-column card puneh, or one magneti-e tape unit
a One pri-nter, any type
a One disk unit, any type.

The system/3 must be equipped vrith a Dsr4 operating system and an RpG
compiler.


SYSTEM//370 R 4300 pRCCESSCR
C

To eatalog the converted source any system/370 or 4300 can be
Frogramsr
used, eguipped with:

' one 80- or 96-col-umn card reader, one magnetic tape unit, or one
Diskette Input/Output Unit
. One printer

' one rBM 3330 Disk storage or one rBM 3340 Direet Aeeess storage
raeility or one IBM 3310 or IBI 33?0.

rn oriler to convert systen/3 files using the conversion program, a tape
unit or Data fmport Feature is also required.

The characteristics of the System/37o or 4300 nust be those specified to
the customizer components. The system must incrude work areai with
cataloged 1abels in order to compile and execute the sort prograrns and
t h e B U I I , D A I - T E R N A T EI N D E X c o m n a n d .

rBM Dos/vsE RPGrr, Licensed program 5?46-RG1 is required. To convert
SystemT3 files using the control statements generated by the conversion
program, VSAM support is required.

An overall flowchart of the program is given in Figure 1-
PACKAGE USTOMIZATION EP
C ST




Di s k e t t e
Conversion
D e fi n i t i o n
Re c o r d s
(96-column)




System/3 List of Conversion
Definition Record
csT101 Errors
or CSTl51


S e q u e n ta l
i




] Sequential
Y




96-column 80-column
Diskette Tape Tailored
Tailored Source Decks
SourceDecks




Figure 1 (1 of 5). Program Flow
F I L E D E F I N I T I OS T E P S
N




DuplicatedLabels

Disk Occupation




C R E A T I N GT H E P R O G R A MF I L E




SourceProgram
Error List




Figure 1 (2 of 5). program Flow




10
SOURCEROGRAMONVERSION
P C


Number of First
FCB to Generate




System/3

coNV03




CONTROL




C o n v e r t e dS o u r c e C o n v e r t e dS o u r c e
P r o g r a mw i t h P r o g r a mL i s t
JCL cards




G E N E R A T I N G A R R I A G EC O N T R O L F C B s
C




List of Generated
FCBsCarrige
Control and
Programsthat




C a r r i g eC o n t r o l
F C B sa n d J C L
cards




Figure 1 (3 of 5). Program Flow




11
D O C U M E N T A T I N GI N S T A L L A T I O N A N D F I L E S C O N V E R S I O N




S y s - P a c k -e l a t i v e
R
P o s i t i o nC a r d s




O C L F IL E




L i s to f F i l e s



List of DLBLs and
TLBLs Dictionary




Sequential




P r o g r a mE x e c u t i o n
Control Statements
Dictionary




List of
AMS Commands AMS Commands
and Data lmport and Data lmport
Utility cards




Figure 1 (4 of 5). prograrn Flow




12
J O BS T R E A M O N V E R S I O N
C




JCLFILE



Systern/3

c o N V l1




System/3

c o N V l2 D i rect




System/3 List of Converted
Job Streams
coNVl4




Figure 1 (5 of 5). Program Flow




13
INS'TALLING THE PROGRAM




The magnetic tape containing the system/3 to Dos/vsE conversion Aid
International Field Frogram may he restoreil directly ont-o an IBM 5q4q
Disk storage Drive, or into the 54t14 simulation area of a 3340.

When the disk has been restored, it will contain:
. An objeet library in which are cataloged the eST101 anil csT102
components (for a systemT3 Model 10) and the esr151 and esr152
components (f or a system/3 l'lodel 158) . These components make up
the eustomizer, according to the systen/3 model on whieh they are
to be executed. The SUBR93 subroutine is eataloqed in the R
Sublibrary.

. A source library, in which is cataloged the souree CST'ISI and
csr152 components to be compiled in case a system/3 Model 15-c or
15 - D , i s u s e d i n t h e customizer step-

. A file containing all the conversion components and the routine to
be cat-aloqed in the Syst_en/3'l} or 4300 processor.


ggq:IQf4-IZTNG rHE PRoGRAM

The customizer components are executed only once and modify the
definitions of the different files used for conversion. In addition,
they retrieve the conversion components from the 5444 disk and plaee
them, together k'ith the routines to be cataloged in DoS/vSE Reloeatable
Library , onto the rnedium specified in the SWITCH staternent. These
components can then be compiled and cataloged in the System/3 used for
the eonversion process-

Output can be on 80- or 96-column cards, diskette, or magnetic tape.


c4!A_L9srNG MOpULE_rN_THE_loSIVSE_RETOCATABLE Lf ERARy

The input job strearn obtained as trial output from t-he customizer is a
DOS/VSE SYIIIN file that assembles and punches the WKVWXV odule with
m the
JCL to catalog it in the Relocatable tribrary- This module is written in
D O S ; / V S EA s s e m b l e r -

Once the SYSIN has been execut-ed, the obtained deck needs be executed
aIso.


S A M P I , EP R O B I E M

The complete execution of the sarnple problem distributed with the
program is given in Appendix C which also contains a listing of the
sample problern as follows:

. Input:
- Statements containing specifications for customization
- Input statements (OCL eontrol statements, source programs, and
data) -




1q
. Output:

- Converted source programs
- FCBS to be cataloged

- System/3 OCI statements and DOS/VSE JCL st-atements to be used
to convert disk files, using magnetic tape and Data Import
Utility as an intermediate mediurn, and to define VSAM catalog
and data spaces-
- cenerated DOS/VSE JCL statements.

o Listing obtained after having executed the sample problem.




15
3!NIINg THE PRocsAM




After the source programs have been sustomized and cataloged, 1he actual
conversion process can be started. C o m p o n e n t s C O N V O 6t o C O N V ] 0 s h o u t d
be executed, if possible, only once during the conversion process in
orand to avoid unwanted dualities in the allocation of sAM files.

rf the components coNv06 to coNv1O are executed a second time:
r Make sure that sAl,l files located on eaeh pack used in previous
processes are exactly equal to t-he ones loeated in the second tirne.
If this condition is not true, the automatic loeation assiqned to
SAM files in the seeond process ean be different.

o f)elete the existing eoNTRol fire before exeeuting the eoNVO4
componerrt to avoid adding data to the end of existing data-
. Enter the number of the first FCB not used in the previous
conversion process in place of the number 000 or 00'l for the eoNVOq
component uhen re-exeeuted.

I f t h e c o m p c n e n t s C C N V O O n d C o N V O 1a r e e x e c u t e d a s e c o n d t i m e , r e - e n t e r
a
coNVOOcontrol statements containing specifications of all files to be
used in the eonversion, even though sorne of the information may have
already been entered-

T h e C O N V O 2c o m p o n e n t i s t h e o n l y o n e t h a t h a s t o b e e x e c u t e d f o r e a e h
source program to be converted- conponents coNvo3 to coNvo6 are
executed only once for al1 programs that have been accepted by the
CONV02 component.

The converted programs can refer to all or part of the files entered
using the coNvoo cornponent. rf they refer to only a part of the files,
c o m p o n e n t s C O N V O 3t o C O N V O Sw i l l have to be executed several times, onee
for each grcup cf programs that refer to the files. The data for the
different groups is added to the eoNTRoL file- At the beginning of eaeh
qroup of source prograns, and before executing the CONVo2 component, the
P R O G R A Mi l e
f must be deleted to avoid addinq Droqrams followinq the
previously converted ones.

c o m p o n e n t s C O N V 1 1 t o C O N V 1 4m a y b e u s e d a s o f t e n a s n e e d e d t o c o n v e r t
job streams, as long as these job streams refer to files and programs
described in the JclFrtE, s3lABFt, and r-ABEls files- The eoNV11 to
CONV14components do not update these files-

The input job streams may not contain CAI-L statements to request
cataloged procedures. A11 eontrol statements for the proqram must be
ineluded in the iob stream.


IN!!!

To customize the source program before beginning the eonversj-on process,
the following data must be entereil for the CST101 or CST151 component,
depending on the System/3 model used and on the 1/O medium indicated in
the SWITCH staternent:

A eNV reeord indicating the eonfiguration of the System/3 on whieh
the conversion is to be perforrned



16
' A FUT record indicating the configuration of the System/3'l} or 4300
r As many EQU records as required to specify the equivalences betrrreen
Systen/3 devices used by the programs and the devices in the
System7370 or 4300 configuration.

As shown in Figure '1, file definition data (one record per filef must be
provided fcr the CONVOO omponent. c This and all other input must be on
the input medium specified for the customizer. NAME-LABEI carcls must be
p l a c e d b e f o r e t h e s o u r c e p r o g r a m i n t h e C O N V O 2c o m p o n e n t , f o l l o w e d by a
// reeord. rn all exeeutions of the eoNvorl component apprying to one
run of the coNvoO and coNv06 components, the first unused FcB must
al-ways have the same number. If the numbers are different, the number
in the last execution of CONVO4is assumed.

As input to the coNvO7 conponent, the relationship between the physical
disk units and the logical SYsxxx units must be specified. At the same
time, and in the same statement, the Relative Position in which the disk
space of the pack is allocated must be specified-

The job streams to be converted are submitted as input to the CONV1
1
component.


F O R M A TC F C C N T R C I S T A T E T ' 4 E n * T S


CCNVo0 Control Statements for File pgfinilion

PCSITION IDENTIFICATlON DESCRIPTION
OR COLUMN
1 Identifier F
2-30 Label System7370 file identification. In VSAM,
the file identification must be eoded as
fol lows :
. One to 29 characters: A to Z,
0 to 9, -, *, A1 or $
. A period must follow each group of
eight or fewer characters
. No embedded blanks are alloweil
. The first charaeter of each group
rnust be alphabetie
r The last charaeter of the file
identifieation cannot be a period.
For other files, the first charaeter
must be alphabetic- Valid eharacters
are A to Zr 0 to 9, blank, -, ., *, A,
and $.
31 - 3 4 Block length (For tape files| Block length must be a
multiple of the record lenEth.
35-38 Record length A number from 3 to 4096
39 File type S seguential
V SAM VSAM manased
T tape
K VSAIC KSDS
R VSAU RSDS
E VSAI{ ESDS
A VSAM ESDS with alternate index
40-41 Key length (For I, R, or A files) A number less
than or equal to 29, and less than or
egual to the record length
42-45 8ey location For I, K, or A files




17
46-tt? Percent of free For K files
spaee in
control intervals
48-49 Percent of free For K files
space in
control areas
50-52 logical SYSXXX A number from 001 to 099
units
53-56 Valiclity period If omitted, zero is assumed
in days
5't* 62 Estimated number Based on this number, the size of the
cf reeords file is calculated
63-64 Initials of the The eoNvo1 listing of file oecupancy is
application printed, sorted aecording to these
initials
65 Destination Mandatory field. To generate REPRO
statements to create a VSAM file or
DITTO statements to create other files,
an R must be entereil. To generate Data
Import Utility statements to ereate other
files a U must be entereil. Otherwise,
an N must be entered-
66-73 System/3 label System/3 fi-le identifieation


9ONV02_NAME- tABEt_stateSent

PCSITION IDENTIFICATION DESCRIFTION
CR EOLUMN

1-8 File name System/3 f i-le identification
9-37 Label DoS/vSE Label identification


CONV04 Stalement_Containinq First_FCB Number

POSITION IDENTIFICATION DESERIPTTON
OR COI,UMN

1-3 Number of first FCB


ggIyqZ_SYs-PACK Relative positign statemenr
PCSITTON IDENTIFICATION DESCRIPTION
CR COLUMN

1-3 Logical unit SYSnnn, corresponding to positions
50 to 52 of the coNvoo statement
4-9 Pack name Volume identification of the paek in whieh
files assigned to the SYSnnn will be
alLocated.
10-16 Relative
Positi-on Number of relative track/bloek positions in
which space allocated on the pack must start.

luqlomizer ICST101 or_CST15ll _Input

// swlrcE 10000000 Control statements on 96-eolumn cards
// swrtcB 01000000 Control statenents on B0-eolumn cards
// swrtcB 00100000 Control statements in 96-column diskette records




18
Customiser (CST102 or CSTl52) Output

// S W T T C H0 0 0 0 1 0 0 0 Program output on 96-column cards
// SVIITCH 00000100 Program output on 80-eoLumn cards
// SWIACH 00000010 Prograrn output on diskette
// SWITCH 00000001 Program output on magnetie tape

In the System/3 UPSI, only one of the bits U1, U2, and U3, and only one
of the bits U5, lJ6, and U7 may be set. The UB bit may be set at the
same time as one of the U5, U6 or U7 bits.


q9!_191 oI gsT'!5'l cNv statsment

POSITION IDENTIFICATION DESCRIPTION
OR COLUMN

1-3 cNv Identifi er
4 - 10 MFCUl Conversion input device
READO 1
READ4 2
MFCMl
DISKET
10-17 DISX Conversion work files
D I S K 45
DISK4O
18-24 MFCU2 Device for output of C O N V O 5a n d C O N V 0 6
TAPE components
MFCM2
READII2
DISKET
25-31 MFCU2 Device for output of CONV09, CONV1O, and
TAPE CONVIq components
MFCM2
READq2
DISKET
32:36 Number of records in the V { O R K D S Ki l e
f


CSll01 or CS!151 FUT Slate$ent

PCSITION IDENTIFICATICN DESCRIFTION
CR COLUMN

1-3 FUT Identifier
q-7 3330 System/370 or 4300 disk units
3340
FBA
tt-v 18 to 99 Default forms length
10-11 14 to 96 Default overflow line
12 Y O r N Use of POWER/VS
13-18 3203-4 System/370 or 4300 printer
3211
3203
5203
14 0 3
3203-5
PRTl




19
Q S T f 0 l o r c s ? 1 5 1 E Q US t g t e n e n !
POSITION IDENTIFICATION DESCRI TION
P
OF COTUMN

1-3 Fr\II
Identifier
4-10 MFCUl SystemT3
MFCU2
PRINTER
PRTNTS 4
EONSOLE
blank
DISK
DISK45
DISK4O
TAPE
SPECIAL
CRT77
RFADO 1
MFCI{1
MFCM2
READ42
DISKET


P O SI T I O N IDENTIFICATION DESCRIFTION
CR COLUMN

11-17 MFCU 1 S y s t e m 7 3 7 0o r 4 3 0 0
MFCU2
PRINTER
CONSOI.E
blank
DISK3O
DISK4O
TAPE
SPECIAL
READO 1
READO 5
READ2O
READ2 5
READ4O
READ4 2
MFCMl
MFCM2
DISKFT
FBA

18-21 l{aximum record length (required for
printer and diskette)
22-24 logical SYSXXX DOS/VSE deviee (required for
all deviees except DASD)
25-2'l Fhysical device address (reguired for all
devices except DASDT used to ereate ASSGN
statements)

Notes:

The 5444 sirnulation area of a 3340 disk does not support random
access to inilexed files. si-nee the rnternational Fierd program
uses ranrfom access to indexecl files, this area eannot be used as a
conversion work area. Therefore, positions 10 to 1? of the cNV
statement can be used only for an actual 5444 disk unit.




20
2. If a System/3 card reader punch is replaeed by two clifferent
DOS/VSE devices, two EQU statenents must be used, with the same
code in positions tt to'1 0 and different ones in positions 1'l to 17.
? The first EQU statement read by the customizer will be considered
as the definition of the input unit and the second as that of the
output unit. If there is only one EQU statement, the coile in
positions 11 to 17 will be considered as the definition of the
input/output unit.


sBeqEssrNg
In the input to CONV00, there must be one F statement for each labeled
tape file or disk file used by the programs to be converted. If CONVOO
is executed without error, C O N V O 1w i t l be executed; if not, the control
statements must be corrected and CCNVOO erun. r
t r t r h e nC O N V O Oa n d C O N V O 1 h a v e b e e n e x e c u t e d w i t h o u t error, C O N V O 2m u s t b e
executed for eaeh program to be converted. The input data for CONVO2
includes a NAME-IABEI statement for eaeh labeled tape or disk file used
by the program, followed by a // statement and the source program to be
converted. If a program is rejected (an explanatory message is
displayed at the printer) , it will not be added to the file of converted
programs and must be reconverted-

W h e n a l l t h e s o u r c e p r o g r a m s h a v e b e e n a c c e p t e d b y C O N V 0 2 , C O N V O 3t o
CONV05 can be exeeuted one after th other without interruption. fnput
t o C O N V O 4w i l l include the number of the first FCB not used bv former
runs of CONV06.

CONV05 produces the converted source programs, together with the eontrol
statements required to conpile them and catalog them in the DOS/VSE- In
addition, it produces a listing of the converted source programs, with
the nurnber of the corresponding error messages. The text of the
messages is given at the beginning of each proqram listing.

Messages numbered 25 and above are rwarning messages, and no aetion is
reguired- Hovever, a speci-a1 processing routine for sequential files
will be cataloged in the DOS/VSE Relocatable Library in response to
message 38 or 55-

Messages 1 to 25 reguire action of sorne ki-nd- In some cases, the system
response must be verified, and in others manual intervention is
reguired.

The converted source programs must be modified according to the
appropriate messages before being compiled on the System/370.

V l h e n C O N V O 5h a s b e e n e x e e u t e d , C C N V 0 6 i s r u n t o list the printer
carriaqe control tape images and to prepare for cataloging the FcBs.

F r o m t h e S Y S - P A C KR E L A T I V E P o S I T I o N s t a t e m e n t s , CoNV07 produces a listig
of file allocation per disk pack. The disk space is autornatleally
allocated as follows:

o Are located SAM files (in label alphabetical- order) without any
space between a file and the next one, they are allocated at the
specified Relative Position.

. The disk space behind the one used by sAM files (if any) is
dedieated to VSAM Data Space.




21
coNVOg and coNv10 provide the statements required to prepare the
eonversion of master files using clata frorn ihe lABEr,s file.

CONV11 to CONV14 convert the Systen/3 OeL statementsi the number of
statements to be converted d e p e n d s o n t - h e s i z e o f t