CA2E--Change Control Facilities Reference Tables

This appendix contains the following change control facilities reference tables:

Model Object Description—This table describes the most significant fields contained in the model object description for each design object in a CA 2E model.
Default Change Types for Component Change Processing—These tables list the default change type for each possible change you can make to a model object. There is a separate table for each model object type.
Component Change Processing Propagation Table—This table shows the effect of each change type on objects that use the changed object.
For more information on CA 2E change control facilities, refer to the chapter, “Managing Model Objects”, in this guide.

CA2E--Model Object Description

CA 2E maintains a model object description for each object in your model and automatically updates the model object descriptioneach time the object is changed, regenerated, or imported.

Use selection option 8 from the Edit Model Object List panel to view the model object description for an object. A standard set of information is displayed for each model object type; for example, name, type, surrogate, and so on. Additional information displayed depends on the model object type as shown in the following table:

Object Type	Information Displayed	Examples
ACP	Attribute	PHY, RTV, UPD
	Source Member	Name and description
	Source Details	Date/time of last successful generatio
	Auxiliaries	Implementation object name and description
APP	Application Area Code	Three-character name
ARR	–	–
CND	Atrribute	VAL, LST
FIL	Atrribute	REF, CPT
FLD	Usage	ATR, CDE, USR
	Atrribute	STS, DTE, TXT
	Implementation Name	DDS name
FUN	Function Type	CRTOBJ, EXCINTFUN
	Access Path	Name and description
	Source Member	Name and description
	Source Details	Date/time of last successful generation
	Attribute (SEU Type)	RPG (if appropriate)
MSG	Atrribute	INF, ERR, STS
MSG	Implementation name	Message identifier

CA 2E--Definitions of Model Object Description Fields

The following table lists the most significant fields contained in the model object description. You can use model object list commands to analyze your model and create model object lists and reports based on values in the model object description.

For more information:

On model objects, model object lists, and model object list commands, refer to the chapter titled “Managing Model Objects” in this guide.
On retrieving model object description fields, refer to the YRTVMDLOBJ section of the Command Reference Guide.

Field	Meaning
FunctiModel object surrogate number (OBJSGT)	A number that uniquely identifies an object in a model; it is assigned automatically when the model object is created. CA 2E uses the object surrogate to identify objects internally. You can use the surrogate on model object list commands as an alternate to the owner/name/type identifier.
Object name (OBJNAM)	Descriptive name of the model object assigned by the developer. This is the name part of the object's owner/name/type identifier.
Object type (OBJTYP)	The model object's type; for example, ACP for access path. Possible values are: ACP APP ARR CND FIL FLD FUN MSG This is the type part of the object's owner/name/type identifier.
Object attribute (OBJATR)	The model object's subtype; the value depends on the object type. For example, for an object of type ACP, RTV means Retrieval access path. This field is blank for APP and ARR object types.
Surrogate of the owning object (OWNSGT)	The model object surrogate for the owner of the model object; for example, for an access path or function, this is the surrogate of the owning file (FIL). Not all objects have owners.
Name of owner of object (OWNNAM)	Descriptive name of the owner of the model object. This is the owner part of the object's owner/name/type identifier.
Function type (FUNTYP)	The type of function for model objects of type FUN; for example, DSPFIL for Display file and RTVOBJ for Retrieve object.
Implementation name (IMPNME)	The implementation or 3GL name for the model object. The value depends on the object type; it is blank for ARR and CND. ACP—Source member name APP—Application area code FIL—Format prefix FLD—DDS name FUN—Program source member name or blank MSG—Message ID
Copy name (CPYNME)	The Object name of the corresponding model object in a target model. It is used by the YCPYMDLOBJ command when copying model objects between models. For new objects, the Copy name is initially the same as the Object name; for new versions (FUN or MSG), the Copy name is initially the same as that used by the version group to which it belongs.
Creation date and time (CRTDTE/CRTTME)	The date and time the model object was created.
Change date and time (CHGDTE/CHGTME)	The date and time the model object was last edited. CA 2E updates this field automatically. It is not updated when: The model object is accessed as if to edit, but no changes are actually made. The model object has been copied from another model or model object and has not been changed since copying.
User profile of developer that changed the object (CHGUSR)	The name of the user profile that last updated the model object.
Change type (CHGTYP)	The type of the most recent change to the model object. It is used by component change processing to identify other objects in the model affected by the change. The possible values are: PUB—Public PVT—Private GEN—Regenerate OBJ—Object only
Impact processed indicator (IPCPRC)	This field indicates whether component change processing has been run for the last change to the model object. It is set by component change processing.
Component changed processing date and time (COMPDTE/COMPTME)	The meaning of this field depends on whether the model object itself or a component of the model object was changed. For a changed object, this is the same as its Change date and time. For an object that uses a changed object (a component changed), this is the date and time component change processing was run for the change.
Action required indicator (ACTRQD	The type of change required to the model object as a result of a change to one of its components. GEN—Generation required EDT—Edit required
Generation date and time (GENDTE/GENTME)	The date and time the model object was last successfully generated.
SEU Type (SEUTYP)	The system SEU type of the model object; for example, RPG or PF. It contains a value only for source-based model objects.
Import date and time (IMPDTE/IMPTME)	The date and time the model object was last copied from another model using the Copy Model Object (YCPYMDLOBJ) command
Group surrogate number (GRPSGT)	For a model object that is not a version of another model object, this is the same as the Model object surrogate. For a version of a model object, this is the group surrogate number of the model object from which the version was created. All versions of a model object have the same value in this field and together comprise a group of versions.
Current object indicator (CUROBJ)	For a version of another model object, this indicates whether the version is the one being used by other model objects in the model; in other words, whether the version is current. Only one version of a group of versions can be current. A model object that is not a version of another model object is always current.
Version type (VSNTYP)	The version type for the model object. Only one version in a group can be of type PRD. This value is always DEV unless you are using Advantage 2E CM. The values are: DEV—Development PRD—Production ARC—Archive
Archive surrogate number (ARCSGT)	The model object surrogate of the archive object that this object replaced when it was promoted. This field contains a value only for archive versions. This field is used only for Advantage 2E CM.
Check out date and time (CHKDTE/ CHKTME)	The date and time the model object was last checked out for a change. This field contains a value only if you are using Advantage 2E CM.
Check out user (CHKUSR)	The name of the user profile that checked out the model object for a change. This field contains a value only if you are using Advantage 2E CM.
Check out status (CHKSTS)	Status information used by Advantage 2E CM.
Check out list (CHKLST)	The name of the model object list to which the model object has been checked out. This field contains a value only if you are using Advantage 2E CM.
Promotion type (PRMTYP)	The promotion method for the model object; namely, whether the object is new to the target environment and whether the model object is to be promoted. This field contains a value only if you are using Advantage 2E CM. CHG—The object is to replace an existing version in the target ADD—The object is to be added to the target GEN—The object is to be generated from the target; the design object is not to be promoted DLT—The object is to be deleted from the target

CA2E--Default Change Types for Component Change Processing

Component change processing ensures the integrity of your model by identifying which other model objects are affected and the type of change required whenever you change a model object. CA 2E uses the default change type table internally to set the change type in the object description for the changed model object. You can use model object list commands to analyze your model based on this change type setting.

For more information on component change processing, refer to the Impact Analysis section of the “Managing Model Objects” chapter in this guide.

The tables in this appendix list the possible changes that can be made to each model object type and the default change type for each change. There is a separate table for each supported model object type. Each entry in each table corresponds to a position on a CA 2E panel where you can change a model object.

In cases where these tables cannot be used to determine the change type, the Override column in the table explicitly specifies the change type. A change type of *CREATE or *DELETE in the Override column are special cases of *PUBLIC. As a result, they do not require component change processing because there are no using objects.

CA2E--Access Paths - ACP

Panel	Change	Change Type	Override
Edit Access Path Auxiliaries	Query physical name	*PRIVATE
	Query physical text	*OBJONLY
	Query program name	*PRIVATE
	Query program text	*OBJONLY
Edit Access Path Conditions	Sequence number	*GEN
	Field	*GEN
	Condition	*GEN
Edit Access Path Details	Access path name	*OBJONLY
	Allow select/omit	*GEN
	Generation mode	*PRIVATE
	Source member name	*PRIVATE
	Source member text	*OBJONLY
	Duplicate sequence	*GEN
	Unique key	*GEN
	Maintenance	*GEN
	Alternate collation table	*PRIVATE
	Format text	*OBJONLY
	Format name	*PRIVATE
	Assoc. retrieval access path	*PRIVATE
	Sequence number	*PUBLIC
Delete Access Path	Delete Access Path		*DELETE
Edit Access Path Format Entries	Key number	*PUBLIC
	Ascending/descending	*GEN
	Alt. Coll. Sequence	*PRIVATE
Display Access Path Formats	Add new format for SPN access path		*PUBLIC
Edit Physical File	Sequence	*GEN
	DDS name	*PRIVATE
	Type	*PRIVATE
	Length	*PRIVATE
Edit Access Path Relations	Add/remove relations	*PUBLIC
	Referenced access path	*PRIVATE
	Select record function	*PRIVATE
Edit Access Path Select/Omit	Select/omit details	*GEN
	Sequence	*GEN
	Text description	*OBJONLY
Edit Access Path Relation Virtual Fields	Add/remove virtual fields	*PUBLIC
No Panel	Default access path creation program		*CREATE

CA2E--Arrays-ARR

Panel	Change	Change Type	Override
Edit Array	New array details		*CREATE
Delete Array	Delete array		*DELETE
Edit Array Details	Number of elements	*PRIVATE
	Sequence	*PRIVATE
	Unique	*PRIVATE
	File/field	*PRIVATE
	Access path/field	*PRIVATE
	Sequence	*PRIVATE
	Array name	*OBJONLY
Edit Array Entries	'+' Select field	*PRIVATE
Edit Array Entries	'-' Drop field	*PRIVATE
Edit Array Key Entries	Key number	*PRIVATE

CA 2E--Conditions - CND

Panel	Change	Change Type	Override
Display Field Domain Conditions	Delete condition		*DELETE
Edit Field Condition Details	Create condition		*CREATE
	Condition name	*OBJONLY
	Relational operator	*PRIVATE
	Internal value	*PRIVATE
	External value	*PRIVATE
Edit List Condition	Create condition		*CREATE
	'+' Add condition	*PRIVATE
	'-' Remove condition	*PRIVATE
	Change condition name	*OBJONLY

CA 2E--Files - FIL

Panel	Change	Change Type
Define Objects	New file/field
	Record not found MSG
	Record exists MSG
Edit File Entries	Replace field	*PUBLIC
Edit File Details	File name	*OBJONLY
	Attribute	*OBJONLY
	Document sequence	*OBJONLY
	GEN format prefix	*PRIVATE
	Distributed	*PRIVATE
	Enhance SQL Naming	*GEN

CA 2E--Fields - FLD

Panel	Change	Change Type	Override
Edit Field Details	Field name	*OBJONLY
	Document sequence	*OBJONLY
	Type	*PUBLIC
	Ref type	*NONE
	Ref field	*PUBLIC
	Field usage	*OBJONLY
	Internal length	*PUBLIC
	Internal decimals	*PUBLIC
	Data type	*OBJONLY
	Gen name	*PUBLIC
	K'bd shift	*PRIVATE
	Lowercase	*PRIVATE
	Old DDS name	*OBJONLY
	Text	*OBJONLY
	Left hand side text	*OBJONLY
	Right hand side text	*OBJONLY
	Column headings	*OBJONLY
	Default condition	*OBJONLY
	Check condition	*OBJONLY
	Mandatory fill	*OBJONLY
	Valid system name	*OBJONLY
	Modulus 10/11	*OBJONLY
	Edit codes Screen I/P	*OBJONLY
	Screen O/P	*OBJONLY
	Report	*OBJONLY
	Translate condition values	*OBJONLY
	External Length	*PUBLIC
	External decimal	*PUBLIC
	DDS name	*PUBLIC
	Prompt function	*OBJONLY
	Display as multi-line edit	*OBJONLY
	NPT height	*OBJONLY
	NPT width	*OBJONLY
Display Unreferenced Fields	Delete unreferenced fields		*DELETE
Field Mapping Function Parameters	Ctx	*OBJONLY
	Field	*OBJONLY
	Permit override	*OBJONLY

CA 2E--Functions – FUN

Panel	Change	Change Type	Override

Display All Functions	Change access path	*PRIVATE
Edit Functions	Function	*OBJONLY
	Function type	*OBJONLY
	Access path	*PRIVATE
Edit Function Details	Function name	*OBJONLY
	Source name	*GEN
	Target HLL	*GEN
	Text	*OBJONLY
No panel	Default functions for a new file		*CREATE
Edit Screen Format Relations	Select record override function		*PRIVATE
Edit Screen Constant	Lines before		*PRIVATE
	Spaces before
	Screen text
	Length
	Constant
Edit Function Field	Delete function field		*PRIVATE
Screen Field Mapping Parameters	Source context	*PRIVATE
Screen Field Mapping Parameters	Source field	*PRIVATE
Create Model Version	From & to functions		*OBJONLY
Edit Function Options	Subfile select	*GEN
	Header/Footer	*GEN
Edit Function Parameters (see note below)	File/field	*PUBLIC
	Access path/field	*PUBLIC
	Passed as	*PRIVATE
	Sequence	*PRIVATE
Note: The changes to the Edit Function Parameters panel apply also to arrays (ARR) and fields (FLD).

CA 2E--Messages – MSG

Panel	Change	Change Type	Override
Edit Message Function	Add message		*CREATE
	Change message		*PRIVATE
	Delete message		*DELETE
Copy message	New message		*CREATE
Edit Function Parameters	File/field	*PUBLIC
	Access path/field	*PUBLIC
	Passed as	*PRIVATE
	Sequence	*PRIVATE
Create Model Versions	From & to messages		*OBJONLY

CA 2E--Component Change Processing Propagation Table

Component change processing ensures the integrity of your model by identifying which other model objects are affected and the type of change required whenever you change a model object. The component change processing propagation table shows the effect of *PRIVATE and *PUBLIC changes to a model object on other objects that use the changed object.

For more information on component change processing, refer to the Impact Analysis section in the “Managing Model Objects” chapter in this guide.

Changed Object Type	Change Type	Using Object Type

		ACP	ARR	CND	FIL	FLD	FUN	MSG
ACP	*PUBLIC	*PUBLIC	*PUBLIC				*PUBLIC	*PUBLIC
	*PRIVATE	*PRIVATE1	*PRIVATE				*PRIVATE
ARR	*PUBLIC						*PRIVATE2
	*PRIVATE						*PRIVATE
CND	*PUBLIC	*PRIVATE		*PUBLIC			*PRIVATE2
	*PRIVATE	*PRIVATE		*PRIVATE			*PRIVATE
FIL	*PUBLIC	*PUBLIC			*PUBLIC
	*PRIVATE	*PRIVATE
FLD	*PUBLIC	*PUBLIC	*PRIVATE		*PUBLIC	*PUBLIC	*PRIVATE2
	*PRIVATE						*PRIVATE
FUN	*PUBLIC	*PRIVATE				*PRIVATE	*PRIVATE
	*PRIVATE					*PRIVATE	*PRIVATE
MSG	*PUBLIC				*PRIVATE		*PRIVATE
	*PRIVATE

Notes:

1.The using access path is flagged *PRIVATE only when you change a physical access path.
2. If the change affects the parameters of the using function, the using function is flagged *PUBLIC instead of *PRIVATE.