concert(1) University of New Mexico (03/19/91) concert(1)
PROGRAM
concert - Instruction & collaboration program
SYNTAX
concert
-command name of Khoros program to be executed
-d2 second display
[-master] Master/Slave mode (true) or Equal-Participant
Mode (false)
[-d3] third display
[-d4] fourth display
[-d5] fifth display
[-d6] sixth display
[-d7] seventh display
[-d8] eighth display
[-d9] ninth display
[-d10] tenth display
[-V] Gives the version for concert
[-U] Gives the usage for concert
[-P] Prompts for command line options
[-A [file1]] Creates the answer file called concert.ans or
file1
[-a [file1]] Uses concert.ans or file1 as the answer file
DESCRIPTION
Concert is a collaboration program, with which two or more
people may "share" the execution of one of the main Khoros
xvroutines: animate, cantata, editimage, putimage,
warpimage, viewimage, xprism2, or xprism3. When concert is
used, the specified application program will appear on all
the displays that are indicated, and the same execution of
the program will be reflected on each display.
Concert may be used as an instructional tool, or it may be
used so that two or more people can collaborate on the
analysis of a problem using one of the above Khoros
Page 1 (printed 7/21/94)
concert(1) University of New Mexico (03/19/91) concert(1)
programs; accordingly, concert may be run in one of two
modes: master/slave mode, or equal-participant mode.
Regardless of the mode that concert is run in, it is HIGHLY
RECOMMENDED that all concert users remain in verbal
communication with each other at all times. If users remain
within hearing range of one another, this is not a problem;
however, if separated by distance, use of the telephone is
recommended during the use of concert.
Master/Slave Mode
When concert is run in master/slave mode, by specifying
[-master 1], it is for instructional or demonstrational
purposes. The user on the display on which the
execution of concert was initiated acts as the
"master"; all other users agree to be "slaves". The
"master" controls all I/O for the program being run;
the actions of the "master" are reflected on all other
displays. "Slave" users are limited to simply
observing the actions of the "master". Any input that
a "slave" user attempts to initiate on the running
program will be ignored. Thus, this mode of concert
may be used in instructing new users of Khoros in the
correct use of one of the abovementioned Khoros
programs. Other uses may include bug reports and
demos. Verbal contact should be maintained between the
"master" user (who should be giving a running
explanation of his actions as he uses the desired
program) and the "slave" users (who should be allowed
to interrupt to ask questions at any time).
Equal-Participant Mode
When concert is run in equal-participant mode (the
default mode), all users are equal participants in the
running program; each can provide input to the program
at any time. While this provides a valuable method of
collaborating with others on the solution of a problem
using one of the Khoros applications, its success
depends entirely on the cooperation of the users! It
is easy (and often tempting) to "fight" with other
users over control of the program. Contention over
control of the program will lead to confusion and loss
of productivity. To avoid this, it is recommended that
all users remain in close verbal contact with each
other at all times; users should take turns
controlling the program, and should agree on who is to
provide input to the program before doing so.
Before running concert, it is required that all users give
permission to the machine on which concert is executed to
send X Events to their displays. Each user of concert
(besides the one who executes the concert program) must
execute the following command:
Page 2 (printed 7/21/94)
concert(1) University of New Mexico (03/19/91) concert(1)
% xhost machine:display
Where "machine:display" is the name of the machine and
display from which concert is exected.
REQUIRED ARGUMENTS
-command
type: string
desc: name of Khoros program to be executed
-d2 type: string
desc: second display
OPTIONAL ARGUMENTS
-master
type: boolean
desc: Master/Slave mode (true) or Equal-Participant
Mode (false)
default: false
-d3 type: string
desc: third display
default: null
-d4 type: string
desc: fourth display
default: null
-d5 type: string
desc: fifth display
default: null
-d6 type: string
desc: sixth display
default: null
-d7 type: string
desc: seventh display
default: null
-d8 type: string
desc: eighth display
default: null
-d9 type: string
desc: ninth display
default: null
-d10 type: string
desc: tenth display
Page 3 (printed 7/21/94)
concert(1) University of New Mexico (03/19/91) concert(1)
default: null
EXAMPLES
% concert -command xprism3 -d2 snidley:0
SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lconcert(3)
Chapter 9 of the Khoros User's Manual
RESTRICTIONS
This program may only be used with Khoros xvroutines,
including: animate, cantata, composer, editimage,
iconimage, preview, putimage, warpimage, viewimage, xprism2,
or xprism3.
At this time, a problem with the implementation means that
concert does not end when the "QUIT" button is click on in
the program being run. Concert must be exited from by
hitting ^C.
COPYRIGHT
Copyright 1991, University of New Mexico. All rights
reserved.
Page 4 (printed 7/21/94)