Special Command Tags

[LCL]

Access to User's Local Machine

Description

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

Example

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"

Note:
WindX will support all the directives and functions that are used against a file channel that was previously opened with a [WDX] or [LCL] tag.

See Also

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