Service Manuals, User Guides, Schematic Diagrams or docs for : IBM system3 SB11-5351-0_ConversionAid_System3toDOS_VSE_ProgramDescriptionAndOperationsManual_5785-KAD_Jul79

<< Back | Home

Most service manuals and schematics are PDF files, so You will need Adobre Acrobat Reader to view : Acrobat Download Some of the files are DjVu format. Readers and resources available here : DjVu Resources
For the compressed files, most common are zip and rar. Please, extract files with Your favorite compression software ( WinZip, WinRAR ... ) before viewing. If a document has multiple parts, You should download all, before extracting.
Good luck. Repair on Your own risk. Make sure You know what You are doing.




Image preview - the first page of the document
SB11-5351-0_ConversionAid_System3toDOS_VSE_ProgramDescriptionAndOperationsManual_5785-KAD_Jul79


>> Download SB11-5351-0_ConversionAid_System3toDOS_VSE_ProgramDescriptionAndOperationsManual_5785-KAD_Jul79 documenatation <<

Text preview - extract from the document
                        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
or


◦ Jabse Service Manual Search 2024 ◦ Jabse PravopisonTap.bg ◦ Other service manual resources online : FixyaeServiceinfo