[LCL] |
Access to User's Local Machine |
The [LCL] tag can be included in a number of system directives to route the command to the user's local machine irrespective as to whether the user is using the system via WindX or directly executing the application. Its purpose is to allow the application designer to create code that will be portable. It will route requests to the end user local workstation without the application having to know how the user is connected.
When the [LCL] tag is used on the system, if the user is running the application directly, then the tag is ignored and dropped. If the application is being run via WindX or JavX, the [LCL] tag is automatically replaced with a [WDX] tag. See [WDX] Direct Action to Client Machine.
The commands/directives that support the [LCL] command tag are:
|
CALL "[LCL]..." , ... |
KEYED "[LCL]..." |
|
DEF OBJECT id, "[LCL] ..." |
NEW ( "[LCL]..." ) |
|
DIRECT "[LCL]..." |
OPEN (..) "[LCL]...." |
|
DIRECTORY "[LCL]..." |
PROGRAM "[LCL]..." |
|
ERASE "[LCL]..." |
REFILE "[LCL]..." |
|
EXECUTE "[LCL]..." |
SERIAL "[LCL]..." |
|
INDEXED "[LCL]…" |
SORT "[LCL]..." |
|
INVOKE "[LCL]..." |
|
The use of the [LCL] tag is also supported in Format 2 of the PTH( ) function.
(Support for the [LCL] tag was added in PxPlus v6.30.)
The following logic will open the file "C:\data\spread.csv" on the local workstation currently being used by the user:
open (hfn)"[LCL]C:\data\spead.csv"
CALL Transfer to Subprogram
DEF OBJECT Define Windows Object
DIRECT Create File with Keyed Access
DIRECTORY Create Subdirectory
ERASE Delete File/Directory from System
EXECUTE Execute Basic Instruction
INDEXED Create Indexed File
INVOKE Execute Operating System Command
KEYED Create Single/Multi-Keyed File
NEW( ) Create New Object
OPEN Open a File for Processing
PROGRAM Create or Assign Program File
REFILE Clear Record from File
SERIAL Create a Sequential File
SORT Create File for Sorting