
concert(1)                   Khoros                    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, warpim-
     age, 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 pro-
     grams; 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 execu-
          tion of concert was initiated acts as the "master"; all
          other users agree to be "slaves".  The "master" con-
          trols 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 control-
          ling 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 exe-
     cute the following command:

     % 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
            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, iconim-
     age, 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 hit-
     ting ^C.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

