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 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:

% 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, 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.