9.127 GET_PROPERTIES
Þ Note: Built-In Function Rules.
Returns the version details of a single LANSA OBJECT.
For use with
|
LANSA for i
|
NO
|
|
Visual LANSA for Windows
|
YES
|
|
Visual LANSA for Linux
|
YES
|
|
Arguments
|
No.
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
Object Name.
Refer to Type of Object Name for format of the name entered here.
|
1
|
20
|
|
|
|
2
|
A
|
Opt
|
Type of Object Name
F = Full. This is the default. The full library name has been supplied e.g. for Linux Object Name = "liblp_dpb.so" for the object lp_dpb
P = Partial. Only the base library name has been supplied. The platform-specific data must be added. E.g. Object Name = "X_PDF" which for Windows would be converted to "X_PDF.DLL" and for Linux would be converted to "libx_pdf.so"
|
1
|
1
|
|
|
|
3
|
A
|
Opt
|
Partition or System Object
P = Partition. This is the default. The object will be located in the execute directory for the partition being processed e.g.
C:\X_WIN95\X_LANSA\X_DEM\EXECUTE
S = System. The object will be located in the system execute directory e.g.
C:\X_WIN95\X_LANSA\EXECUTE
|
1
|
1
|
|
|
|
Return Values
|
No.
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
L
|
Req
|
Identification list for an object
From - To Description
1 - 2 Identifier Number
3 - 4 Option Number
5 - 44 Data
See values below.
|
44
|
44
|
|
|
|
2
|
A
|
Req
|
Return Code
OK = The list was returned without error
NR = List was returned empty. This is usually due to either a non-LANSA object being queried or when the LANSA object was generated before the information was made available.
ER = An Error occurred during the getting of the list.
|
2
|
2
|
|
|
|
Note: Identifier, Option Number and Build Number (in Data description below) are zero filled and right justified.
Identifier Number
00 = Object Type
01 = Object Name
02 = Object Extension
03 = DLL Name
04 = Build Date
05 = Build Time
06 = Supports Components
07 = Collection Name
08 = Visual LANSA Internal Identification
Option Number
This only applies when the Identifier Number is 08.
00 = Build Number
01 = Release Number
02 = Build Date
03 = Copyright Dates
Data
|
Object Type:
|
FD = File
PF = Function
PD = Process
DF = Component
XX = LANSA Internal Object
|
|
Object Name
|
|
|
Object Extension
|
|
|
DLL Name
|
|
|
Build Date *
|
mmm dd yyyy
|
|
Build Time *
|
hh:mm:ss
|
|
Component Support
|
Y=Supports Components
N=Does not support Components
Not used for Functions.
|
|
Collection Name
|
This name is the same as the Library Name, except that it is truncated when the Library Name is too long. For example, a file in the LANSA demonstration system would have a value of XDEMOLIB.
Not used for a Function.
|
|
Visual LANSA Internal Option Number
|
00 = Build Number
01 = Release Number
02 = Build Date
03 = Copyright Dates
|
* All dates and times are in the language format of the computer on which the object was built. Therefore, LANSA internal objects, such as X_PDF.DLL, will always return an English style date because they were built in Australia. On the other hand, for an object built in France such as MYFUNC.DLL, the date will be French.
Times do not contain any time zone information so it is not possible to convert the time into local time for comparison purposes. The times should only be used for comparison when you are certain that all times you are comparing were generated in the same time zone.
Examples
Following are two examples of the GET_PROPERTIES Return Values. One shows the values for a Function, the other is for a File:
|
Indentifier Number
|
Option Number
|
Function Example
|
File Example
|
|
00
|
Spaces
|
PF
|
FD
|
|
01
|
Spaces
|
MYFUNC
|
LX_F02
|
|
02
|
Spaces
|
MYPROC
|
LX_DTA
|
|
03
|
Spaces
|
MYFUNC
|
LX_F02
|
|
04
|
Spaces
|
Oct 12 2001
|
Jul 16 1999
|
|
05
|
Spaces
|
12:53:40
|
15:15:07
|
|
06
|
Spaces
|
Spaces. Does not apply to a Function.
|
Y
|
|
07
|
Spaces
|
Spaces. Does not apply to a Function.
|
LX_DTA
|
|
08
|
01
|
9.1
|
7.8
|
|
08
|
02
|
0000002208
|
0000000000
|
|
08
|
03
|
Oct 10 2001
|
Jun 24 1999
|
|
08
|
04
|
1993-2001
|
1993-1999
|
|