when title is not a question n o ‘we can’ when title is not a question n o ‘we can’ when...

CA 2E r8.5 – An Overview

SAM2012 - April 16, 2012Rory Hewitt – CA Technologies

About the Speaker

—Rory Hewitt−Software Architect for 2E team

−Software developer for 17 years (14 with 2E development team)

−Helped design some of the largest features in recent 2E history• RPGIV generator, function wrappering & duplicate parameters,

triggers

−Competition-level snowboarder, boxer and karateka

overview of r8.5

new functionality at r8.5

—Default templating

—Trigger functions

—Service program support

questions

agenda

—Available since 2009

—Major release

—Significant take-up by customer base—Most common release in use by far

—1 service pack available (8.5 SP1) plus multiple fixes

overview of release 8.5

Default templating

—Allows automatic use of a *Template function−New functions copied from *Template function

—Include standard functionality on a function-type basis−Standard *MOVE ALL's in RTVOBJ (DB1.*ALL->PAR.*ALL) etc.

−Common initialization functionality

—Standardize parameters for function types−Include extra parameters by default

−Use RCD instead of KEY for DBF functions (CHG/CRT/DLT/RTV)

−Call another function within a CHGOBJ to load a field

default templating

Default RTVOBJ parameters – where are the non-key fields?

Default RTVOBJ parameters - have to be changed for every RTVOBJ :(

Create a RTVOBJ over the *Template file

Create some 'sensible' parameters (like the whole record format)...

...and return the non-key fields

Add in the standard *MOVE ALL's for 'record not found'...

...and 'record found'

...and set the 'Default prototype function' flag to 'Y'...

...(not forgetting to read what it does, of course!)...

Now create a new RTVOBJ function over your file...

...and note the new completion message (same as if F21 was used)...

...and see that the parameters are more useful...

...and correctly return the fields you want...

Trigger functions

—External 2E functions of type TRGFUN−Predefined parameters based on owning file

−No default Action diagram code (like EXCEXTFUN)

—'Endpoint' for CA 2E trigger framework−Invoked when owning database file is updated by

application• Called directly in updating job (synchronous)

• Called via data queue server (asynchronous)

—Can contain any processing (except updating owning file)

trigger functions

...Create a trigger function (TRGFUN) over any file...

...and view the parameters (which are all read-only)...

1. *Trigger control data

2. 'Old' record format

3. 'New' record format

...and add some code to the function itself

—Define triggering conditions for each Trigger function−Event (Insert, Delete, Update)

−Time (After or before record update)

−Commitment level

—Use YCVTTRGDTA command to convert−Trigger control information converted to external (non-2E) format

−Triggers added to *FILE object

−Specify CA 2E Trigger Router (YTRIGGER) as trigger program

—External trigger-related objects exist outside 2E model−Either *GENLIB or separate library

trigger functions

Specify triggering conditions for each Trigger function...

...then convert trigger data to external format...

...then edit converted external trigger data and add triggers to PF(s) automatically

All 2E triggers call same 'trigger program', called YTRIGGER...

—At runtime, file is updated by application program

—OS Database Manager calls YTRIGGER (Trigger Router)

—Trigger Router determines 2E Trigger function(s) to call

—Either−Trigger Router calls 2E Trigger function(s) directly

(synchronous)

—Or−Trigger Router sends transaction information to Trigger Server

−Trigger Server calls 2E Trigger function(s) (asynchronous)

trigger functions

trigger functions – synchronous processing

Application Program

Trigger Router

TRGFUN*FILE*FILE*FILE*FILE*FILEFile

1. Application program updates file2. Database Manager (operating system) calls Trigger Router3. Trigger Router calls 2E Trigger function(s)

—Synchronous processing−Default option

—Benefits−Can be used where application program should know

about errors

−Easy to debug (in same job as application program)

−Simplest way to add functionality

−Program-to-program call – less likelihood of problems

—Drawbacks−Long-running processing will 'lock' application program

trigger functions – synchronous processing

trigger functions – asynchronous processing

TRGUNTrigger Server

1. Application program updates file2. DBM (OS) calls Trigger Router3. Trigger Router sends data to

Trigger Server (in different job)4. Trigger Server calls 2E TRGFUN(s)

Application Program

Trigger Router

*FILE*FILE*FILE*FILE*FILEFile

—Asynchronous processing−Non-default option – must be specifically chosen

—Benefits−Can 'offload' long-running processing to separate job

−Allows application program to continue

−Least chance of problems showing up in application program

−Can 'save' trigger processing for later time/date

—Drawbacks−Errors in trigger function don't signal application program

−Complex to test

trigger functions – asynchronous processing

Service program support

Existing ILE Support

ILE support prior to r8.5

—Some ILE support prior to r8.5

—Generation of ILE languages−RPGLE (introduced in Release 7.0)

−CBLLE (introduced in Release 8.0)

—Can define functions as PGM (*PGM) or MOD (*MODULE)

—Modules not directly 'callable'−Must be 'bound' into calling program

PGM Function

MOD Function

*PGM objects

gives us

EditCustomer EditAccountEditVendor

PromptData ValidateData

EditCustomer

PromptData

ValidateData

EditVendor

PromptData

ValidateData

EditAccount

PromptData

—Each *PGM contains a copy of each *MODULE it needs−Bind-by-copy

—Benefits−Fewer runtime *PGM objects

−Bound calls are quicker than program calls

—Drawbacks−Large stand-alone multi-*MODULE *PGM objects

−Change to bound module requires program update

—Ability to create service programs (*SRVPGM)−Consist of one or more modules

−Accessed at runtime by programs

—Programs no longer 'contain' modules−Bind-by-reference

—Bound calls still faster than program calls

—Module change only requires service program update−No change required to calling programs

service program functionality at r8.5

PGM Function

MOD Function

gives us

*PGM objects EditCustomer EditVendor EditAccount

*SRVPGM object

EditCustomer EditAccountEditVendor

PromptData ValidateData

DataFunctions

PromptData

ValidateData

service program functionality at r8.5

Enhanced ILE Support

—New "Service program" function type−Can be created over any model file

—Fully integrated with existing model functionality−Impact Analysis

−Change Management

−Model Documentation

—Uses same 2E 'look and feel'−Intuitive and easy for long-time 2E developers

Service Program Creation

—*SRVPGM's are not 'typical' source-based objects…

—…but we found a way to do it−One source member per *SRVPGM

• Generation control information

• Creation options (used by Toolkit compile preprocessor)

• Export list

−Allows full integration with change management tools• Source control, security, promotion, rollback etc.

−Same *DSNR/*PGMR/*USER authority as elsewhere

Service Program Creation

—Multiple signature options−System-generated, hard-coded or *SRVPGM name

−Allows better control of runtime objects

—Can also bind modules created outside CA 2E model−Use 2E model as 'placeholder' for external *SRVPGM's

−Puts under source control, versioning etc.

−Stores complex CRTSRVPGM command etc.

New 'Service program' (SRVPGM) function type

Object type is 'SPG'

Object attribute is 'BND'

New 'M' and 'P' selection options

Service program signature

Use F9 to change signature

SERVICE PROGRAM MODULES lists modules that comprise the

service program

Standard options can be used against any modules from the CA

2E model

SELECT MODULE screen allows user to add modules from the CA 2E model to the service program

Option G generates source into member in QSRVSRC source file

Generated source consists of two 'sections'…

Compilation instructions

Z* and Y* lines used by the CA 2E Toolkit compile preprocessor to

create the service program

Export definition list

List of procedures and data exported by the service program, along with the signature definition

Impact Analysis

New *BNDMOD reason code for bound modules

Summary

—Simplifies application development process

—Uses new 1E compile preprocessor functionality

—Allows users to move fully to an ILE environment

questions

when title is not a question n o ‘we can’ when title is not a question n o ‘we can’ when...

Documents

sl1838bc-e - bostitch€¦ · when clearing a jam. 4. when...

言語知識（文字・語彙）－ - ----------- jlpt ·...

upside down - competitiveness when failure is not …...

聴解－ · 2021. 1. 15. · listening 1. 3. 4. (20 (355})...

言語知識（文字・語彙）－ · do not open this...

converting leads to customers - when digital alone is not...

n3g - jlpt.or.kr · language knowledge (grammar) reading...

when terms and conditions are not upheld

聴解－ - jlpt 1 3. (20 1 (305}) notes l ltl do not open...

picture introduction to self- · pdf fileabout diabetes...

do not open the question booklet until being told to …

when regex is not enough

equilibrium is not a question of control

n3g - wordpress.com · language knowledge (grammar) reading...

聴解－listening 1. 2. 3. 4. (2011—1) (40+) notes do not...

130919 jim cordy - when is a clone not a clone

berea digital – when is a screwdriver not a screwdriver -...

聴解－ - · pdf filelistening 1. 2. 3. 4. (2011—1)...

when growing pains are not growing pains

聴解－ - jlpt sensei · listening 1. 3. 4. (20 (355})...