9.202 START_PROCESS_EDIT
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 |