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.