9.174 PHYSICAL_KEY
Þ Note: Built-In Function Rules.
Specifies or re-specifies the name of a field that is a key of the physical file associated with the file definition being edited.
An edit session must be commenced using the START_FILE_EDIT Built-In Function prior to using PHYSICAL_KEY.
Warning: This Built-In Function cannot be used for a file of type "OTHER".
Þ This is a Specialized Built-In Function for use in a Development Environment only.
For use with
|
LANSA for i
|
YES
|
Do not use on IBM i in an RDMLX partition.
|
|
Visual LANSA for Windows
|
YES
|
|
|
Visual LANSA for Linux
|
NO
|
|
|
Arguments
|
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
Name of key field. Must have been previously specified as a field in the file by using the FILE_FIELD Built-In Function.
|
1
|
10
|
|
|
|
2
|
N
|
Opt
|
Optional sequencing number. Used to sequence key fields. If not specified keys are sequenced in the same order as they are presented.
|
1
|
5
|
0
|
0
|
|
Return Values
|
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
Return code
OK = key defined
ER = fatal error detected
In case of "ER" return code error message(s) are issued automatically and the edit session ended without commitment.
|
2
|
2
|
|
|
|