Command GROUP
Function:
Insert program files into Program Manager groups.
Syntax:
GROUP [[ "groupname" ] filename [/D] [/S] [/C]]
or
GROUP ["groupname" /D [/C]]
| groupname | Program Manager group name string. |
| filename | Program file(s) to add to the group. |
| /D | Delete a group. |
| /S | Process sub-directories. |
| /C | Indicates that parameter groupname refers to a common group. |
Program files:
Only valid program files can be inserted into the Program Manager groups, and all other file types are ignored. A valid program file must have an extension of either .EXE, .COM, .BAT, .PIF or any filename that has a File Extension Association.
Error message:
The command GROUP uses Dynamic Data Exchange to communicate with the Program Manager. A request is sent to the Program Manager, and the Program Manager returns either a positive or negative acknowledgment, depending on whether the request is carried out or not.
When a request fails then the error message Request Denied is displayed. The most common reasons for this error occurring is :-
- WinOne® can not link to the Program Manager.
- an attempt to delete a Program Manager group that does not exist.
- an attempt to insert a program file into a Program Manager group that is full. A Program Manager group can only contain a fixed number of items or programs. Typically, only 50 items or programs are allowed in any one Program Manager group.
- an attempt to manipulate a common group when the currently logged in user does not have system administrator privileges.
Note:
- When the /C switch is not specified then parameter groupname name refers to a private group. When the /C switch is specified do not include the "[Common]" part to specify a common group name. For example, when WinOne® is installed on Windows NT it is placed in a common Program Manager group. The parameter groupname is specifed as "WinOne", not "WinOne [Common]", and the /C switch must also be specified.
- The /C switch is ignored when WinOne® is running on Windows 95 or Win32s, since there are no common Program Manager groups in Windows 95 or Win32s.
- System administrator privileges are required to manipulate common groups or items contained in a common group.
- Examples on using GROUP.
|
