An ILE Building Block

Size: px

Start display at page:

Download "An ILE Building Block"

Jodie Bryant
6 years ago
Views:

1 An ILE Building Block

2 IBM Introduced ILE for C with V2R3 of the OS in 1993 COBOL, RPG compilers could build ILE objects as of V3R1 (1994) The term OPM (Original Program Model) was introduced along with RPG IV to identify non-ile programs ILE compilers may generate OPM or ILE program object

3 Activation groups Programs grouped together to share common resources Subprocedures programs within programs Modules groups of procedures Programs with a single entry point for a CALL Service programs with multiple entry points Re-useable code bound to ILE programs

4 Activation group Loading and unloading programs together Binding Directories A list, similar to a library list that is searched when looking for a procedure Binder source A list of subprocedures in a service program that can be called externally

5 Activation groups are like a garbage bag Load a program, or group of programs into an activation group When the process finishes throw away everything in the activation group When the activation group is destroyed All resources are returned to the system

6 Memory for static and automatic variables Static variables retain their values from call to call, while automatic variables lose value and memory locations Memory for dynamic storage Introduced with ILE for RPG (always available to C) Temporary data management resources ODP, commitment control, local SQL cursors Resources for exit points and exception handlers

7 DFTACTGRP(*YES) - Act like OPM, not allowed to use ILE functions DFTACTGRP(*NO) - Remain resident, LR still closes files and initializes variables ACTGRP(*CALLER)- If called from command line, or OPM act like OPM, else if called from ILE named activation group execute in the caller s activation group ACTGRP(*NEW) Create new (system named) activation group, automatically destroyed at job end ACTGRP( xxxx ) Ordinary named activation group, can be destroyed by using RCLACTGRP

8 OVRDBF FILE(FPMFINC) SHARE(*YES) OVRSCOPE(*ACTGRPDFN) From the default activation group behave like *CALLLVL From an ILE activation group affect only the named activation group An activation group is a function of the job An override scoped to an activation group will not have an impact on other jobs on the system even if they share the same named activation group

9 CL running in Default Activation Group OVRDBF OPM_1 ILE_1 OPM_2 OVRDBF FILE(FPMFINC) SHARE(*YES) OVRSCOPE(*ACTGRPDFN) ILE_1 uses named activation group QILE Override in effect for OPM_1 and OPM_2 Override is not in effect for ILE_1

10 OVRDBF OPM_1 ILE_1 OPM_2 CL running in Default Activation Group OVRDBF FILE(FPMFINC) SHARE(*YES) OVRSCOPE(*JOB) ILE_1 uses named activation group QILE Override in effect for OPM_1 and OPM_2 Override is in effect for ILE_1

11 Default Activation Group Every job has a default activation group Automatically started when job starts Automatically destroyed when job ends It is the only activation group that can run non-ile programs ILE Named Activation Group Created automatically when a program is called Named activation groups will not be created if they already exist for the job May be recovered (destroyed) by using the RCLACTGRP command or CEETREC system API Automatically destroyed at job end Multiple named activation groups can be started by a job

12 A normal end operation by highlevel language exit statements is implemented by calling the CEETREC API. The activation group and job-level return codes are updated whether or not the activation group ended, provided call stack entries were canceled. This API cannot end the default activation group.

13 Job Activation groups Multiple named activation groups can be defined for a job ORDMNT Maintenance programs that might offer services to execute only once daily ORDINQ Order inquiry functions used throughout the day Once ORDMNT processes are completed, the resources can be reclaimed, while ORDINQ resources are left resident ORDMNT ORDINQ

14 ILE and service programs may execute in the DAG If *CALLER was used and called from an OPM If *CALLER was used and the call originated in the DAG If the teraspace model was not specified for the ILE program The DAG does not support teraspace operations

15 Don t let ILE or service programs execute in the DAG ILE HLL end verbs will not complete in DAG COBOL, STOP RUN. C, exit() Static address, memory allocations will not be returned to the system Resources can t be recovered until the job is ended

16 ErrorOccurred = CloseObjectCursor(); *inlr = *on; return; ENDSR; B P Quit b /free ErrorOccurred = CloseObjectCursor(); *inlr = *on ; exit(0) ; /end-free P Quit e A

17 D CEETREC PR D rc 10i 0 const options(*omit) D user_rc 10i 0 const options(*omit) C CEETREC(*omit: 0);

20 DSPJOB Note that LR was set on in both programs, yet there are still ODP s in the job File Library Device Scope Activation QDUODSPF QPDA WD_3022A1 *ACTGRPDFN *DFTACTGRP QDDSPEXT QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP QDUI132 QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP FPMFINC PGMLIB FPMFINC *ACTGRPDFN *DFTACTGRP FLMFINC6J PGMLIB FLMFINC6J *ACTGRPDFN *DFTACTGRP QDDSPOF QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP H OPTION(*NODEBUGIO:*SRCSTMT) DFTACTGRP(*YES) CALL TSTILE1' EVAL *INLR = *ON RETURN TSTILE1 H Dftactgrp(*no) actgrp(*caller) SETLL 1 VRWSTMTS; READ VRWSTMTS; Exec SQL Select floan into :loannumber From FPMFINC Where floan = :shloan; *inlr = *on; Return;

21 DSPJOB More ODP s in the job Member/ File Library Device Scope Activation QDUODSPF QPDA WD_3022A1 *ACTGRPDFN *DFTACTGRP QDDSPEXT QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP QDUI132 QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP FPMFINC PGMLIB FPMFINC *ACTGRPDFN *DFTACTGRP FLMFINC6J PGMLIB FLMFINC6J *ACTGRPDFN *DFTACTGRP FPMFINC PGMLIB FPMFINC *ACTGRPDFN QILE FLMFINC6J PGMLIB FLMFINC6J *ACTGRPDFN QILE QDDSPOF QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP H OPTION(*NODEBUGIO:*SRCSTMT) DFTACTGRP(*YES) CALL TSTILE2' SETON RETURN LR TEST ILE QILE H Dftactgrp(*no) actgrp('qile') SETLL 1 VRWSTMTS; READ VRWSTMTS; Exec SQL Select floan into :loannumber From FPMFINC Where floan = :shloan; *inlr = *on; Return;

22 DSPJOB QILE ODP s no longer show in the job File Library Device Scope Activation QDUODSPF QPDA WD_3022A1 *ACTGRPDFN *DFTACTGRP QDDSPEXT QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP QDUI132 QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP FPMFINC PGMLIB FPMFINC *ACTGRPDFN *DFTACTGRP FLMFINC6J PGMLIB FLMFINC6J *ACTGRPDFN *DFTACTGRP QDDSPOF QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP QILE activation group entries have been removed However the only way to recover ODP s in *DFTACTGRP is to Sign Off! H OPTION(*NODEBUGIO:*SRCSTMT) DFTACTGRP(*YES) CALL TSTILE3 EVAL RETURN *INLR = *ON TSTILE3 H Dftactgrp(*no) actgrp('qile') bnddir('qc2le') D Quit pr extproc('exit') D 3u 0 value SETLL 1 VRWSTMTS; READ VRWSTMTS; Exec SQL Select floan into :loannumber From FPMFINC Where floan = :shloan; *inlr = *on; Quit(0); Return;

23 File Library Device Scope Activation QDUODSPF QPDA WD_3022A1 *ACTGRPDFN *DFTACTGRP QDUI132 QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP QDDSPOF QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP CEETREC exits and no ODP s from the program appear in the open file list However, CEETREC will not recover an ODP if *CALLER is the activation group entry File Library Device Scope Activation QDUODSPF QPDA WD_3022A1 *ACTGRPDFN *DFTACTGRP QDUI132 QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP FPMFINC P FPMFINC *ACTGRPDFN *DFTACTGRP QDDSPOF QSYS WD_3022A1 *ACTGRPDFN *DFTACTGRP H/TITLE *** TEST ILE CALL *** C CALL 'TSTILE4' **** C SETON LR C RETRN TSTILE5 H Dftactgrp(*no) actgrp('qile') SETLL 1 VRWSTMTS; READ VRWSTMTS; Exec SQL Select floan into :loannumber From FPMFINC Where floan = :shloan; *inlr = *on; CEETREC(*omit: 0); Return;

24 End

ILE Activation Groups

ILE Activation Groups & Binder Language Susan Gantner susan.gantner@partner400.com www.partner400.com www.systemideveloper.com Your partner in IBM i Education In this session in the ILE Essentials series,