9 106 GET_PROPERTIES

You are here:

9.106 GET_PROPERTIES

Note: Built-In Function Rules Usage Options

Returns the version details of a single LANSA OBJECT.

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	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. For use when Object Path Type = L	1	260

Return Values

No.

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

Req

Identification list for an object

From - To Description

1 - 2   Identifier Number
3 - 4   Option Number
5 - 44   Data

See values below.

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.

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