Contents | Index | < Browse | Browse >

 ACTION  <action>   Source   <destination>
 ===================================================================
 This is a command which will recursively scan the directory tree
 and perform the given <action> to the Source.

  LVAction  will do the same things, but to all the selected 
 files/dirs of a given dir listview.

 The ESCAPE key - hit while a Gui4Cli window is active - will abort 
 any operation taking place.

 The "Source" can be a File or a Directory - *not* a device.

 The Actions that can be performed, are :

 COPY       Will copy the file or dir to the destination.
            ex : ACTION COPY dh0:MyDirectory ram:
            Action COPY (also  COPY  and  LVACTION COPY ) will check 
            if the destination file exists and is more recent than the 
            source. If yes, it will warn you (as is done by Dir-Opus, 
            Windows etc) and ask you if it should proceed (with Yes, Yes 
            to all, No etc..)

 COPYNEW    Same as copy but will only copy files created at a later date
            than the destination files (if they exist).

 MOVE       Will move the Source to the destination (or just rename them
            if they are on the same device).

 DELETE     Will delete the source file or dir.
            You *must* give a destination. This can be anything or
            "NOREQ". If you state "NOREQ" you will suppress a
            "Delete Files ?" kind of requester that will otherwise
            appear.

            ex : Action delete Ram:t/MyDir NOREQ - Will delete dir
            Ram:t/MyDir, without asking you first.
            
 SIZE       Here, <destination> must be the name of a variable where 
            the total size of the File or Directory (or all dirs/files
            for lvaction) will be stored.

            ex : Action SIZE ram:t/MyDir  MyVariable

            The sizes will be shown in the listview next to the dirs.

 PROTECT    Protect requires that the <destination> argument be a MASK
            denoting the protection bits you want to set the file
            to. This MASK, is a 7-digit number, where each number
            can be a 1 or a 0, showing that you want the given bit
            set.

            Each digit represents :
            1st   Delete    -> 1 means file can NOT be deleted, 0 it can.
            2nd   Execute   -> Used by shell commands - set to 0 (I think)
            3rd   Write     -> 1 = File is writable
            4th   Read      -> 1 = File is readable
            5th   Archive   -> 1 = File has not changed
            6th   Pure      -> 1 = File is program that can be made resident
            7th   Script    -> 1 = File is a script

            ex : Action Protect DH0:MyDir 1000000  
            - Protect all files in dh0:MyDir from deletion.

 CLI        This is new with V3.0 and it allows you to execute a 
            command recursively through a directory and all it's
            subdirectories, for all files found therein. There is a
            special internal variable called $$FILE which will be
            valid whenever Gui4Cli is recursing through the files of
            a directory. Using it you can do this (for example) :

            ACTION CLI MyDirectory 'search $$FILE string'

            and all the files within the directory and it's subdirs,
            will be searched. This command is very important, because
            it can take simple CLI commands and make them recursive -
            saves on a lot of code repetition..