Novell Doc: NW 6.5 SP8: Utilities Reference

1.56 FLAG

Purpose

Use at a workstation to

View or modify file and directory attributes to determine which operations can be performed with the file or directory
Modify the owner of a file or directory
View or modify the search mode of executable files to determine how the program uses search drives when looking for a file

Syntax



SYS:PUBLIC\FLAG.EXE path [[+ | -] attribute...] [/option...] [/? | /VER]

Parameter	Use to
(no parameter)	If you type FLAG with no parameters, the attribute status of all the files in the current directory appears.
path	Specify the path to the file or directory whose attributes or search modes you want to modify.
+ \| -	Add attributes to a file or directory with the + (plus). Remove attributes from a file or directory with the - (minus). If neither + nor - is used, the attributes will be assigned to the file/directory as specified. If you add and remove attributes in the same command, group all + (plus) attributes together and all - (minus) attributes together.
attribute	Specify one or more file or directory attributes. See Directory Attributes and File Attributes.
/option	Replace option with any available option. See General FLAG Options.
/?	View online help. All other parameters are ignored when /? is used.
/VER	View the version number of the utility and the list of files it uses to execute. All other parameters are ignored when /VER is used.

NOTE:For help with tasks, press F1 in the utility.

Using FLAG

Use FLAG options to add or delete directory and file attributes, as defined in the preceding parameters table.

For attributes that can be applied to directories, see Directory Attributes.

For attributes that can be applied to files, see File Attributes.
When you add or delete multiple attributes, include a space between attribute abbreviations.
You can use wildcard characters.

General FLAG Options

Option	Use to
/NAME \| GROUP = name	Change the owner of a file or directory.
/D	View details about a file or directory.
/DO	View or modify only directories in the specified path.
/FO	View or modify only files in the specified path.
/OWNER=name	View all files or directories owned by a user.
/M=mode	Modify search modes of executable files. See Search Modes for Executable Files.
/S	Search the subdirectory in the specified path and any subdirectories below that level.
/C	Scroll continuously through output.

Directory Attributes

Option	Use to
ALL	Specify the Di, H, Ic, P, Ri, and Sy attributes as a group. Primarily used to assign directories these specific attributes.
Di (Delete Inhibit)	Prevent the directory from being deleted. This attribute overrides the trustee Erase right. When it is enabled, no one, including the owner and network administrator, can deletet the directory or file. A trustee with the Modify right must disable this right to allow the directory or file to be deleted.
Dm (Don't Migrate)	Prevent the directory from being migrated to a secondary backup system (regardless of what the volume is set to).
H (Hidden)	Prevent the directory from being seen in the directory listing.
Ic (Immediate Compress)	Compress the files in the specified directory as soon as the OS can. This does not apply to the directory's subdirectories and the files in them. Use Ic in combination with the /S option to apply immediate compression to the directory's subdirectories and their files recursively.
N (Normal)	Specify no attributes.
P (Purge)	Purge the directory or files in a directory immediately when deleted.
Ri (Rename Inhibit)	Prevent the directory from being renamed.
Sy (System)	System hides the directory so it does not appear in a file manager or directory listing. System is normally used with operating system files, such as Linux or NetWare system files.

File Attributes

Option	Use to
ALL	Specify the A, Ci, Di, H, Ic, P, Ri, Ro, Sh, Sy and T attributes as a group. Primarily used to assign files these specific attributes.
A (Archive needed)	Indicate that the file has been modified since the last backup.
Ci (Copy Inhibit)	Prevent files from being copied. This attribute overrides the trustee Read right and File Scan right.
Dc (Do not Compress)	Prevent a file from being compressed.
Di (Delete Inhibit)	Prevent a file from being deleted or copied over. This attribute overrides the trustee Erase right. When it is enabled, no one, including the owner and network administrator, can deletet the directory or file. A trustee with the Modify right must disable this right to allow the directory or file to be deleted.
Dm (Don't Migrate)	Prevent a file from being migrated to a secondary backup system (regardless of what the volume or directory is set to).
Ds (Don't Suballocate)	Prevent an individual file from being suballocated, even if suballocation is enabled for the system. Use on files which are enlarged or appended to frequently, such as certain database files. This flag applies only to files in a NetWare Traditional File System volume.
H (Hidden)	Prevent a filename from being displayed with the DOS DIR command. The file can't be copied or deleted.
Ic (Immediate compress)	Compress a file as soon as the OS can.
N (Normal)	Specify the Rw attribute.
P (Purge)	Purge a file immediately if the file is deleted.
Ri (Rename Inhibit)	Prevent a file from being renamed.
Ro (Read Only)	Allow a file to only be read; it can't be written to or deleted (in other words, Ro includes Ri and Di).
Rw (Read Write)	Allow a file to be read and written to.
Sh (Shareable)	Allow a file to be used by several users simultaneously. This attribute is usually used with Read Only.
Sy (System)	System hides the directory or file so it does not appear in a file manager or directory listing. System is normally used with operating system files, such as Linux or NetWare system files.
T (Transactional)	Protect a file by using the Transaction Tracking System™.
X (Execute)	Identifies executable files such as .exe and .com files.

Search Modes for Executable Files

IMPORTANT:The syntax is /M=mode. Replace mode with a mode number from the following table.

Mode	Use to
0	Search for instructions in the net.cfg file (the default mode).
1	Search the path specified in the file. If there is no path, the file searches the default directory, and then all search drives.
2	Search the path specified in the file. If there is no path, the file searches only the default directory.
3	Search the path specified in the file. If there is no path, the file searches the default directory; then if the open request is read only, the file searches the search drives.
4	Reserved; don't use.
5	First search the path specified and then all search drives. If there is no path, the file searches the default directory and then all search drives.
6	Reserved; don't use.
7	First search the path specified. If the open request is read only, the file searches the search drives. If there is no path, the file searches the default directory and then all search drives.

Status Flags

NOTE:Status flags show attribute information for a file or directory. You can't change these flags.

Status	Indicates
Cc (Cannot compress)	The file cannot be compressed because of limited space savings or failures that might have occurred during an unsuccessful compression attempt. If this flag is set for a file, the system will not attempt compression again until the next time the file is saved. To allow the file to be reevaluated for compression, use the COMPFIX utility to reset (turn off) this flag. For information, see Section 1.32, COMPFIX.
Co (Compressed)	The file has been compressed.
M (Migrated)	The file has been migrated.

Status

Indicates

Cc (Cannot compress)

The file cannot be compressed because of limited space savings or failures that might have occurred during an unsuccessful compression attempt.

If this flag is set for a file, the system will not attempt compression again until the next time the file is saved. To allow the file to be reevaluated for compression, use the COMPFIX utility to reset (turn off) this flag. For information, see Section 1.32, COMPFIX.

Co (Compressed)

The file has been compressed.

M (Migrated)

The file has been migrated.

Examples

To add Rw and Ic and remove Di and A from all files in the current directory, enter
```
FLAG *.* +R W Ic -Di A
```
To view attributes for file STUDENTS in directory sys:\course\winter, enter
```
FLAG SYS:\COURSE\WINTER\STUDENTS
```
To give files in drive G: the Hidden attribute, enter
```
FLAG G:*.* H /FO
```
To set the search mode to 7 for all executable files in the current directory, enter
```
FLAG *.* /M=7
```
To set the search mode to 1 and assign all files in the current directory the Read Write attribute, enter
```
FLAG *.* RW /M=1
```