9.202 START_PROCESS_EDIT

Note: Built-In Function Rules     Usage Options

Starts an "edit session" on the definition of a nominated LANSA process definition.

The edit session can be used to define a new process or alter an existing one.

The process definition is locked for exclusive use throughout the edit session.

Only one process definition can be edited at one time (ie: it is not possible to concurrently edit two or more process definitions within the same job).

A process edit session should be terminated using the END_PROCESS_EDIT Built-In Function to ensure all locks/etc are released/shutdown in an orderly manner.

Any process edit session that receives a fatal error will have an END_PROCESS_EDIT command automatically issued.

Special Note: This Built-In Function provides access to very advanced facilities that basically allow RDML functions to construct new RDML functions.

This is a very specialized area that requires very good knowledge of the LANSA product. Use of this Built-In Function in a "commercial" application (e.g. Order Entry) is not normal and should not be attempted.

This is a Specialized Built-In Function for use in a Development Environment only.

Arguments

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Name of process to be edited

1

10

 

 

2

A

Opt

Process description.

Used for a new process only.

Default value is PROCESS.

1

40

 

 

3

A

Opt

Process menu type / style.

Used for a new process only.

Must be SAA/CUA or ACT/BAR.

Default value is SAA/CUA.

7

7

 

 

4

A

Opt

Initial public access.

Used for a new process only.

ALL, NORMAL or NONE allowed.

Default value is NORMAL.

3

6

 

 

 

Return Values

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Return code

OK = edit session commenced

ER = fatal error detected

2

2