| Note: Built-In Function Rules Usage Options |
Returns the version details of a single LANSA OBJECT.
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 | Object Path Type 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 L = Literal. Literal Path Name should contain the path where the object will be located. | 1 | 1 | ||
4 | A | Opt | Literal Path Name Path of where the object is located. | 1 | 260 |
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 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
09 = File Version
Option Number
For Identifier 08 (only)
00 = Build Number
01 = Release Number
02 = Build Date
03 = Copyright Dates
For Identifier 09 (only)
00 = File Version Number
Data
Object Type: | FD = File |
|---|---|
Object Name | |
Object Extension | |
DLL Name | |
Build Date * | mmm dd yyyy |
Build Time * | hh:mm:ss |
Component Support | Y=Supports 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 |
* 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.
Following are two examples of the GET_PROPERTIES Return Values. One shows the values for a Function, the other is for a File:
Identifier 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 |