8.0;cpb (create_paste_buffer) *DM*, revision 8.0, 84/03/11
CPB (CREATE_PASTE_BUFFER) -- Display a list of the windows in a group.
usage:  cpb group_name [-i] [-c 'char']


FORMAT

  CPB group_name [options]


  The CPB command creates a window on a named paste buffer specific to the given
  group.  The paste buffer contains a list of the windows in the group.  Because
  these group lists are held in paste buffers,  your  programs  can  access  the
  groups   by   using  the  PBUFS  routines  described  in  the  "DOMAIN  System
  Programmer's Reference Manual".

  The DM automatically creates three special paste buffers to  help  you  manage
  your windows and icons.  These paste buffers contain the following groups:

     - The  INVIS_GROUP  --  this  buffer  holds  the  pathnames of all the
       windows that you have made invisible.

     - The ICON_GROUP -- this buffer holds the pathnames of all the windows
       that are represented by icons.

     - The ALL_GROUP -- this buffer holds the  pathnames  of  every  window
       open  on  your node - Shell process windows, DM windows, visible and
       invisible windows, and windows represented by icons.

  These special groups are created regardless of any  other  groups,  and  their
  members may overlap with the members of any other group (just as any group can
  have the same member(s) as another).

  A special feature of the CPB command allows you to directly access the windows
  in  a  group  when  the  paste  buffer  holding the group is displayed on your
  screen.  To use this feature:

     1. Use the CPB command to display the list of windows.

     2. Position the cursor on the pathname  of  the  window  you  want  to
        access.

     3. Press <CMD>, and issue the DR (MARK) command.

     4. Press <CMD> again, and issue the desired DM command.

  By  using  this  feature  you  can directly access windows that are invisible,
  represented with icons, etc..


ARGUMENTS

  group_name
  (required)         Specify the name of the group you want to display.


OPTIONS

  -I                 Specify that the window created will be in icon format.

  -C 'char'          Specify the icon character to be used in the  icon  window.
                     'char'  must  reside  in  the  current  icon font.  If this
                     option is not specified and  -I  is  present,  the  Display
                     Manager  will  use  the default icon character for this pad
                     type.


RELATED TOPICS

  More information is available.  Type:

  - HELP WGRA
    for information on creating window groups.

  - HELP ICON
    for information on creating icons.