ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.6)
_______________________________________________________________________________
 xdmc [-p <pid>] [-q] [-w <windowid>] [-display <node:0.0>] [-list [-cmd]] [-ver]  "dm;cmd;list"
 "execute ce commands"
 
 
 DESCRIPTION:
    Use  this  command  to  execute ce commands from the shell command line
    (not to be confused with ce's "Command:" line). 
    
    This is perhaps best illustrated with an example.  Say you  would  like
    to  run a program within a ceterm window, and you want the font '10x20'
    to be used while your program is running.  You  also  want  to  restore
    the   user's   original   font  immediately  following  your  program's
    termination.  You could accomplish this by writing a Korn shell  script
    as follows:
    
        #!/bin/ksh
        
            ... shell script initialization stuff ...
        
        # now save our current font and then load '10x20';  PPID
        # is a predefined Korn shell environment variable that
        # is our parent's process id
        
            xdmc -p $PPID "fl;tdmo;xc -l fl_save;fl 10x20"
        
        # now run our program here
        
            our_program options ...
        
        # now restore our user's original font here
        
            xdmc -p $PPID "tdm;es 'fl ';tr;xp -l fl_save;tr;en"
        
        # we're done!
    
    Quotes  are  required  around  <command_string> if it contains embedded
    white space.  The rules governing the contents of <command_string>  are
    exactly  those that govern commands or command strings that are entered
    at ce's "Command: " prompt. 
    
    If '-p <pid>' is omitted,  the  current  process's  pid  is  used.

 PARAMETERS
    -p <pid>
            Send  the  commands to the ce process associated  with  process
            <pid>.  If this parameter and the -w parameter are omitted, the
            commands  are  sent to the ceterm process associated  with  the
            shell which
            called xdmc.
      
    -q      quiet mode.  Do not generate any error messages.  The exit code
            will be zero if everything worked.  Non-zero otherwise.
    
    -w <windowid>
            This is the X window id to send the dm commands to.  The window
            id's can be viewed by doing an "xdmc -list".  The use of actual
            window id's tends to be limited to debugging and experimenting.
            There are two special values for the -w option.  Specifying "-w
            any"  sends  the commands to the first window it finds  on  the
            list. This is useful for sending key definitions, where it does
            not  matter  which  window  actually   processes  the  request.
            Specifying  "-w  ."  causes xdmc to send the  commands  to  the
            window  the cursor is currently in.  This is useful for running
            xdmc  from a telnet'ed session.  Warning, while the 'cd'  alias
            which sends the current working directory to the ceterm process
            via  xdmc could use this option, the current working  directory
            when  telnet'ed  to another machine may be unavailable  to  the
            ceterm process running on the original machine.

    -display <node:0.0>
            Open the display on the named node.  The default is taken from
            the $DISPLAY environment variable.

    -list
            Display  the  list  of  open Ce windows.  This  is  a  dump  of
            internal  Ce  information  and  is not to  useful  except  when
            debugging.   However, the main window's X window id is  listed,
            and  this is the window id used in the -w parameter.  Note that
            this output may change in future releases of Ce.

            Sample output:

            update_cc_list:  Size = 96, actual_type = 31 (STRING), actual_format = 8, nitems = 96, &bytes_after = 0
            dump_cc_list: PID 9026, len = 96
            SET 1: ID:  0x274E5001 0x6DAF2DED 0x82830C83, WINDOW COUNT 1, UID: 727
                window  0:  main: 0x500002, pgrp 0, shpid 0, shpgrp 0 cepid 8797
            SET 2: ID:  0x274E5001 0x6DC88AB2 0x82830C83, WINDOW COUNT 1, UID: 727
                window  0:  main: 0x800002, pgrp 0, shpid 0, shpgrp 0 cepid 9019

    -cmd
            Valid  only with -list, this option causes the ce saved command
            to be displayed.  This is the command used by a session manager
            to restart the command.  The command is listed below the window
            information.

    -ver    Print the version information and exit.

    "dm;cmd;list"
            This  is a list of DM commands to execute.  Using normal  shell
            rules,  if  there is any embedded white space the  entire  list
            must  be enclosed in quotes.  To execute commands from a  file,
            pass the command "cmdf <path>", where <path> is the path to the
            file containing the commands.
    

 RELATED HELP FILES:
     commands      (List of Commands) 
     ce            (Create Edit - Command: prompt)       
     cv            (Create View - Command: prompt)       
     ceterm        (ceterm - from shell prompt)          

     support       (customer support) 
     

_______________________________________________________________________________
  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.