Query system configuration information.
Function No: | 993 |
DLL Required: | U_BIF993.DLL |
For use with
Visual LANSA for Windows | YES |
Visual LANSA for Linux | NO |
LANSA for i | NO |
Arguments
|
Return Values
o | Type | Req/ Opt | Description | Min Len | Max Len | Min Dec | Max Dec |
1 | A | Req | Information returned. SYS_DRIV Returns the drive in which the LANSA system is located as a drive letter followed by a colon. e.g: C: or D: or E: SYS_DIR Returns the root directory in which the LANSA system is located. e.g: D:\X_WIN95\X_LANSA\ SYS_DIR_EXECUTE Returns the directory in which the LANSA system EXECUTE objects are located. e.g: D:\X_WIN95\X_LANSA\EXECUTE\ SYS_DIR_SOURCE Returns the directory in which the LANSA system SOURCE objects are located. e.g: D:\X_WIN95\X_LANSA\SOURCE\ SYS_DIR_OBJECT Returns the directory in which the LANSA system OBJECT objects are located. e.g: D:\X_WIN95\X_LANSA\OBJECT\ PART_DRIV Returns the drive in which the current partitions LANSA system is located as a drive letter followed by a colon. e.g: C: or D: or E: PART_DIR Returns the root directory in which the current partitions system is located. e.g.: D:\X_WIN95\X_LANSA\X_DEM\ PART_DIR_EXECUTE Returns the directory in which the current partitions EXECUTE objects are located. e.g: D:\X_WIN95\X_LANSA\X_DEM\EXECUTE\ PART_DIR_SOURCE Returns the directory in which the current partitions SOURCE objects are located. e.g: D:\X_WIN95\X_LANSA\X_DEM\SOURCE\ PART_DIR_OBJECT Returns the directory in which the current partitions OBJECT objects are located. e.g: D:\X_WIN95\X_LANSA\X_DEM\OBJECT\ TEMP_DRIV Returns the drive in which temporary files / objects should be created as a drive letter followed by a colon. e.g: C: or D: or E: TEMP_DIR Returns the directory in which temporary files/objects should be created. e.g: D:\TEMP\ DRIV_LIST Returns a working list in return value 2. This value (return value 1) must be passed as a dummy argument when making a DRIV_LIST request. | 1 | 256 | ||
2 | List | Opt | Working list to contained returned information. Currently only required for a DRIV_LIST request. Refer to the following examples for the layout and format of the returned working list for DRIV_LIST requests. | N/A |
Examples
The following sample RDML function (which can be copied and pasted in the CS/400 free form function editor) queries and displays all possible drive/path combinations:
FUNCTION OPTIONS(*DIRECT)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(SYS_DRIV)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(SYS_DIR)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(SYS_DIR_EXECUTE)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(SYS_DIR_OBJECT)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(SYS_DIR_SOURCE)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(PART_DRIV)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(PART_DIR)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(PART_DIR_EXECUTE)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(PART_DIR_OBJECT)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(PART_DIR_SOURCE)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(TEMP_DRIV)
EXECUTE SUBROUTINE(SHOW_INFO) WITH_PARMS(TEMP_DIR)
********** COMMENT(Display subroutine)
SUBROUTINE NAME(SHOW_INFO) PARMS( OV_QUERY)
DEFINE FIELD(#OV_QUERY) TYPE(*CHAR) LENGTH(50)
DEFINE FIELD(#OV_RESULT) TYPE(*CHAR) LENGTH(50)
USE BUILTIN(OV_QUERY_SYS_INFO) WITH_ARGS(#OV_QUERY) TO_GET(#OV_RESULT)
DISPLAY FIELDS(#OV_QUERY #OV_RESULT)
ENDROUTINE