ILE01: ILE Concepts. This chapter describes the ILE Concepts supported within IDDOS.

Transcription

1 ILE01: ILE Concepts. This chapter describes the ILE Concepts supported within IDDOS.

2 TABLE OF CONTENTS ILE01: ILE Concepts. 1.1 OPTION M = MODULES OPTION S = SERVICE PROGRAMS OPTION B = BINDING DIRECTORIES OPTION L = BINDER LANGUAGE Detail Export list Delete Export List Cross Reference Export List Export list Symbols OPTION SR = SYMBOL RESOLUTION List Modules List Service Programs...16 i Manual IDDOS 13 ILE01 ILE Concepts ii

3 Composition of a Program/Service Program A Program Object ( *PGM ) in an ILE environment is different from a Program Object in an OPM environment. Both objects can be executed, but the difference exists in the contents of a *PGM object. While in a OPM environment, a *PGM object is based on one and only one source, the ILE *PGM object is based on a collection of Modules (*MODULE). A *MODULE object is a nonrunnable object that is the output of an ILE compiler With other words : A Module is the compiled version of a source (RPG, COBOL, Java, etc.), but it can not be executed. It consists of one or more ILE Procedures. An ILE procedure is a set of self-contained high-level language statements that performs a particular task and then returns to the caller. With other words : An ILE Procedure is a piece of code handling a specific functionality. The options described underneath explain how the ILE techniques, like Modules, but also Service Programs, Binding Directories, etc. can be used from within RealWeb.Gen Within RealWeb.Gen you can create *MODULE, *PGM and *SRVPGM Objects by using the attributes Type, Module and Program on the Create Program definition screen ( refer to DEV07 Defining and Designing Programs). Manual IDDOS 12 ILE01 ILE Concepts 1

4 1.1 Option M = Modules This first option allows to manually define all Modules to be used to compose a Program or Service Program object. Typing option M=MODULES in the Programs & Modules screen produces the Program Composition : Modules screen. The option M=Modules is only allowed for Programs where the attribute Program = Y or S. Figure 1 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID102RGI : : Program composition : Modules S01 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Line Module System Description : : 10 WS200RGC WEBGEN ListCustomers : : 20 WS400RGC WEBGEN List Customers On Name : : F3=Exit F4=Selection F10=Symbol Resolution F12=Cancel : This screen lists all Modules to be used for the compilation of the *PGM / *SRVPGM object. Add manually Modules to it by typing in the Module names, or use F4 to select Modules from the list of all available Modules. The function key F10=Symbol resolution is explained in the item Option SR = Symbol Resolution Manual IDDOS 13 ILE01 ILE Concepts 2

5 Figure 2 displays the Program Composition : Selection screen after using F4. Figure 2 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID102RGI : : Program Composition: Selection S02 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Locate : : Line Module System Description : : IP803RGB *SYSTEM XML Driver : GetLanguage : : IP810RGB *SYSTEM XML Driver : GetUser : : IP811RGB *SYSTEM XML Driver : GetClass : : IP812RGB *SYSTEM XML Driver : GetMethod : : IP813RGB *SYSTEM XML Driver : GetRecord : : IP815RGB *SYSTEM XML Driver : GetField : : IP816RGB *SYSTEM XML Driver : GetReadNext : : IP817RGB *SYSTEM XML Driver : ResetDriver : : IP818RGB *SYSTEM XML Driver : GetOrder : : IP819RGB *SYSTEM XML Driver : SetHandle - GetHandle : : IP830RGB *SYSTEM XML Driver : SetField : : IP831RGB *SYSTEM XML Driver : CreateRecord : : IP832RGB *SYSTEM XML Driver : SetRecord : : More... : : F3=Exit F12=Cancel : Individual Modules can be selected by typing a numerical value in the Line field. This numerical value will be automatically translated into the multiple of 10 that is closest to the initial value. In case of a multiple selection the Modules will be listed in ascending order of their assigned value. Manual IDDOS 12 ILE01 ILE Concepts 3

6 1.2 Option S = Service Programs Besides Modules, Service Programs can be linked to Program Objects or other Service Program Objects. This option describes how to assign Service Programs. Typing option S=SERVICE PROGRAMS in the Programs & Modules screen produces the Service Programs screen: The option S=Service Programs is only allowed for Programs where the attribute Program = Y or S. Figure 3 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID102RGI : : Program composition : Service programs S01 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Line Srvpgm System Description : : 3010 IP760RGB *SYSTEM XML Driver : Service Program : : F3=Exit F4=Selection F10=Symbol Resolution F12=Cancel : This screen lists all Service Programs to be linked during the compilation of the *PGM / *SRVPGM object. Add manually Service Programs to it by typing in the Service Program names, or use F4 to select Service Programs from the list of all available Service Programs. The function key F10=Symbol resolution is explained in the item Option SR = Symbol Resolution Manual IDDOS 13 ILE01 ILE Concepts 4

7 Figure 4 displays the Program Composition : Selection screen after using F4. Figure 4 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID102RGI : : Program Composition: Selection S02 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Locate : : Line Srvpgm System Description : : IP760RGB *SYSTEM XML Driver : Service Program : : WS501RGC WEBGEN Service Program 2 : : F3=Exit F12=Cancel : Individual Service Programs can be selected by typing a numerical value in the Line field. This numerical value will be automatically translated into a number within the 30xx sequence, where xx represents a multiple of 10. In case of a multiple selection the Service Programs will be listed in ascending order of their assigned value. Manual IDDOS 12 ILE01 ILE Concepts 5

8 1.3 Option B = Binding directories Also Binding Directories are supported within RealWeb.Gen (refer to DEV12 Binding Directories to create *BNDDIR objects). A Binding Directory allows you NOT having to put all Modules and Service Programs one by one to be used during compilation. Instead use a Binding Directory to tell the ILE Compiler to search himself for the correct Modules and Service Programs to be used, based on a list defined in the Binding Directory. Typing option B=BINDING DIRECTORIES in the Programs & Modules screen produces the Binding Directory screen: The option B=Binding Directories is only allowed for Programs where the attribute Program = Y or S. Figure 5 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID102RGI : : Program composition : Binding Directory S01 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Line Bind Dir System Description : : 9010 TEST2 WEBGEN : : F3=Exit F4=Selection F10=Symbol Resolution F12=Cancel : This screen lists all Binding Directories to be used during the compilation of the *PGM / *SRVPGM object. Add manually Binding Directories to it by typing in the Binding Directory names, or use F4 to select Binding Directories from the list of all available Binding Directories. The function key F10=Symbol resolution is explained in the item Option SR = Symbol Resolution Manual IDDOS 13 ILE01 ILE Concepts 6

9 Figure 6 displays the Program Composition : Selection screen after using F4. Figure 6 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID102RGI : : Program Composition: Selection S02 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Locate : : Line Bind Dir System Description : : ARTICLE WEBGEN All Article Validations : : TEST2 WEBGEN : : F3=Exit F12=Cancel : Individual Binding Directories can be selected by typing a numerical value in the Line field. This numerical value will be automatically translated into a number within the 90xx sequence, where xx represents a multiple of 10. In case of a multiple selection the Binding Directories will be listed in ascending order of their assigned value. Manual IDDOS 12 ILE01 ILE Concepts 7

10 1.4 Option L = Binder Language The use of Binder Language is related to Service Programs only. It is the mechanism to describe the Public interface of a Service Program. Default all Exported Symbols ( ILE Procedures and Data Items) form the Public Interface of a Service Program. Binder Language allows you to make exceptions on this. Besides this, Binder Language also allows you to have different versions (or levels) of a Service Program, bundled in one *SRVPGM object. Typing option L=BINDER LANGUAGE in the Programs & Modules screen produces the Binder Language screen: The option L=Binder Language is only allowed for Programs where the attribute Program = S. Figure 1 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID487RGI : : Binder Language S01 : : Service program.. : WS500RGC : : Service Program : Article Validations : : Signature *CURRENT. : Type options, press Enter. : : 2=Change 3=Create *CURRENT 4=Delete 8=Xref 12=Symbols : : Opt Level Description : : *CURRENT Thirth Level : : *PRV Second Level : : *PRV First Level : : F3=Exit F6=Create *CURRENT F8=Browse F9=Generate F12=Cancel : This list displays all levels (or versions) available within a *SRVPGM object. The *CURRENT level is the most current created one. All previous levels (*PRV) are listed in a descending order on Creation date. One level contains a list of Exported Symbols, therefore a Level is also called an Export list Manual IDDOS 13 ILE01 ILE Concepts 8

11 1.4.1 Detail Export list Following functions in the above-mentioned Binder Language screen (see Figure 1) produce the Detail Export list : 2=CHANGE 3=CREATE F6=CREATE Figure 2 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID487RGI : : Binder Language S02 : : Service Program.. : WS500RGC : : Service Program : Article Validations : : Level : *CURRENT : : Description.... : Thirth Level : : Level check.... : Y Y/N : : Signature..... : 12E4D8F0161CFEEB11CE98975AEA85FD : : F3=Exit F12=Cancel : Level : '*CURRENT' is used when creating a new level or updating the current level. *PRV is used to identify a previous level. With F6 a new *CURRENT level can be created, option 3 allows to create a *CURRENT level based on an existing level. When a new *CURRENT level is created, the previous *CURRENT is renamed to *PRV. Level check : Identifies whether Service Program clients (Programs or Service Programs that use a Service Program) have to inheret the Signature from the Service Program they use. If they inheret it, no recompilation have to be done of these clients when a new level for the Service Program is created. Signature : After compilation of the Service Program, each Export List or Level receives a unique identifier under the form of a Signature. Manual IDDOS 12 ILE01 ILE Concepts 9

12 1.4.2 Delete Export List The Signature is default generated by the System, unless a Signature was defined by the User. The signature allows to create additional Export Lists for a Service Program, without having to recompile all Service Program Clients. The 4=DELETE function in the above-mentioned Binder Language screen (see Figure 1) produces the Delete Export List Confirmation screen: Figure 3 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID487RGI : : Binder language S03 : : Press Enter to Confirm your choices for 4=Delete : : Press F12=Cancel to return to change your choice(s) : : Opt Level Description : : 4 *CURRENT Thirth Level : : F12=Cancel : When deleting an export list, a check is performed whether Service Program Clients still make use of the related Signature of the Service Program. Manual IDDOS 13 ILE01 ILE Concepts 10

13 1.4.3 Cross Reference Export List The 8=XREF function in the above-mentioned Binder Language screen (see Figure 1) produces the Xref Export List screen: Figure 4 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID487RGI : : Binder Language S04 : : Service program.. : WS501RGC : : Service Program 2 : : Level : *CURRENT : : Description.... : Second Level : : Program Description : : F3=Exit F12=Cancel : This screen lists all Service Program Clients ( Programs and Service Programs that make use of this Service Program). The Cross Reference can be listed per Level ( = per Signature ). Manual IDDOS 12 ILE01 ILE Concepts 11

14 1.4.4 Export list Symbols The 12=SYMBOLS function in the above-mentioned Binder Language screen (see Figure 1) produces the Export list Symbols screen: Figure 5 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID487RGI : : Binder Language S05 : : Service program.. : WS501RGC : : Service Program 2 : : Level : *CURRENT : : Description.... : Second Level : : Type options, press Enter. : : 4=Remove 5=Full : : Opt Seq Symbol : : 2 DUMMYARTICLEVALIDATION1 P : : 3 DUMMYARTICLEVALIDATION3 P : : 4 IMPEXPFIELD D : : 5 DUMMYARTICLEVALIDATION11 P : : 6 DUMMYARTICLEVALIDATION12 P : : 7 EXPORTFIELD D : : F3=Exit F6=Add F11=Fold/Drop F12=Cancel : This list presents an overview of the Exported Symbols for a specific Level in a specific Service Program. This list represents in fact the Public Interface of the Service Program. Default all Exported Symbols ( ILE Procedures and Data Items ) of all Modules included in the Service Program, are defined in the Export List. Option 4=Remove and F6=Add can be used to modify the list. If the Symbol Name length exceeds the screen width, a more indicator.. will be displayed; use option 5 to display the full Symbol Name The F11=FOLD/DROP function key displays additionally the Module containing the Symbol. The F6=ADD function key produces following screen: Manual IDDOS 13 ILE01 ILE Concepts 12

15 Figure 6 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID487RGI : : Binder Language S06 : : Service program.. : WS501RGC : : Service Program 2 : : Level : *PRV : : Description.... : First Level : : Type options, press Enter. : : 1=Select : : Opt Symbol : : DUMMYARTICLEVALIDATION3 P : : DUMMYARTICLEVALIDATION12 P : : F3=Exit F11=Fold/Drop F12=Cancel : This list contains all potential Symbols that can be assigned to an Export List (already assigned Symbols are not listed). Option 1=SELECT adds the Symbol to the Export list. Manual IDDOS 12 ILE01 ILE Concepts 13

16 1.5 Option SR = Symbol Resolution Symbol Resolution allows to dynamically define the required Modules and Service Programs to be used to compile a *PGM or *SRVPGM object. It helps in resolving unresolved symbols. Typing option SR=SYMBOL RESOLUTION in the Programs & Modules screen produces the Symbol resolution screen: The option SR=Symbol Resolution is only allowed for Programs where the attribute Program = Y or S. Figure 7 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID508RGI : : Symbol resolution : (Unresolved) imports S01 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Type options, press Enter. : : M=Modules : : Opt Symbol Resolved by : : GETFIELD S IP815RGB : : GETORDER S IP818RGB : : GETREADNEXT S IP816RGB : : GETRECORD S IP813RGB : : LISTCUSTOMERSONNAME M WS400RGC : : SETHANDLE S IP819RGB : : SETMESSAGE S IP840RGB : : CREATERECORD S IP831RGB : : SETFIELD S IP830RGB : : SETRECORD S IP832RGB : : F3=Exit F12=Cancel : For each Module defined in the list of Modules for a Program or Service Program, this screen displays a list of Called Procedures and Imported Data Items. Each of these symbols need to be resolved by selecting additional Modules. Resolving means adding a *MODULE or *SRVPGM object with a matching symbol name, to the definition list of a Program or Service Program. As long as all Symbols are not resolved, the Program or Service Program can not compile correctly. Manual IDDOS 13 ILE01 ILE Concepts 14

17 1.5.1 List Modules The M=MODULES function in the above-mentioned Symbol resolution screen (see Figure 7) produces the List Modules screen: Figure 8 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID509RGI : : Symbol resolution : Modules S01 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Symbol : GETFIELD : : Type options, press Enter. : : 1=Select 4=Delete 9=Browse S=Service program : : Opt Module System Description Selected : : IP815RGB *SYSTEM XML Driver : GetField : : F3=Exit F12=Cancel : This list displays all Modules that have the selected Symbol in their Export list. Option 1=SELECT adds the Module to the list of Modules for the Program or Service Program concerned. Upon selection of a Module a Y value appears in the Selected field. Option 4=REMOVE removes the Module from the Program or Service Program concerned. Upon performing this action the Y value disappears from the Selected field. Instead of adding a Module to the List of Modules, it is also possible to add a Service Program containing the Module to the list of Service Programs of a Program or Service Program. Option S=SERVICE PROGRAM produces the List Service Programs screen. Manual IDDOS 12 ILE01 ILE Concepts 15

18 1.5.2 List Service Programs Figure 9 : INTEGRATED DEVELOPMENT & DOCUMENTATION SYSTEM Real Web.Gen Cursus ID510RGI : : Symbol resolution : Service Programs S01 : : (Service) Program.... : WS200RGC M P : : ListCustomers : : Module : IP815RGB : : XML Driver : GetField : : Type options, press Enter. : : 1=Select 4=Delete : : Service : : Opt Program System Description Selected : : IP870RGB *SYSTEM XML Driver : Service Program Y : : F3=Exit F12=Cancel : This list displays all Service Programs that have the selected Module in their content list. Option 1=SELECT adds the Service Program to the list of Service Programs of a Program or Service Program. Upon selection of a Service Program a Y value appears in the Selected field. Option 4=REMOVE removes the Service Program from the list of Service Programs. Upon performing this action the Y value disappears from the Selected field. The result of adding Modules and Service Programs to the definition list of a Program or Service Program, is also visible in option M=Modules and S=Service Programs. Manual IDDOS 13 ILE01 ILE Concepts 16