                                                                     AUTHOR: DLW
                                                                       17 Sep 86
 PHOTO - Photographing a terminal session

 PHOTO is a program to "photograph"  a  terminal  session.   Also,  photographed
 sessions  from  DISPLAY terminals (eg.  VT100) can be accurately replayed using
 this program.  To run photo simply enter:

                         @PHOTO     --or--     @PHOTO S

 "@PHOTO" will just put you at the "PHOTO>" command level.  "@PHOTO S" will  run
 photo  and  pass the "S" command (an abreviation for "START") to "PHOTO>".  You
 can actually pass any vaild "PHOTO>" command to the program at this time.   For
 example:

                   @PHOTO  SET INTERRUPT-CHARACTER ^X, START

 When photo starts up it will execute these commands just as if  you  had  typed
 them  in  after the "PHOTO>" command prompt.  This set of commands will set the
 interrupt character to ^X, and start the photo session.  It is  important  that
 each  command  be  separated  with  a comma.  If you have a set of commands you
 always want executed when photo starts up place them in PHOTO.INI on you logged
 in  (PS:)  directory.  When PHOTO starts up these command will automatically be
 executed.

                      ====================================

 PHOTO>? A command, one of the following:
  CONTINUE      EXIT           FIX            HELP           INFORMATION
  KILL          REPLAY         RESET          SET            START
  TAKE


 CONTINUE  { PHOTO-SESSION, REPLAY }

      During a photo session or replay (see START or REPLAY) it is  possible  to
      temporary  interrupt  what  you  were  doing using the interrupt character
      (default is ^X).  CONTINUE will return you to where you were prior to  the
      interruption.   You  only  need to specify which one you want continued if
      both are in an interrupted state.
      

 EXIT (from this program)

      Exits from "PHOTO>" command level and returns you to the EXEC.
      

 FIX (file)  <file-name>

      Normally you shouldn't need to use this command.  It  is  used  to  fix  a
      corrupted photo log file (default is PHOTO.PIC).  A photo log file can get
      corrupted if the system dies while you are in the middle  of  a  recording
      session.  When this happen PHOTO does not have a chance to update the byte
      count of the log file.  The recording of  your  terminal  session  becomes
      "hidden" behind the logical end-of-file.  The FIX command will correct the
      byte count so you will be able to see the entire file.  If you attempt  to
      type  a  PHOTO  log  file  that needs fixing the following message will be
      displayed:

                File problem.  Run PHOTO and use "FIX"

      It will not hurt to use FIX on a file that does not need  the  byte  count
      fixed  up.   This command command may be used to FIX other files (not just
      photo log files) where you suspect the byte count is wrong.
      

 HELP (for) <a photo command>

      Displays help on all or specific PHOTO> commands.
      

 INFORMATION (about program status)

      Returns information about the program plus various settings.
      

 KILL  { PHOTO-SESSION, REPLAY }

      This command will kill or end the photo session or replay.  If  you  don't
      specify  which one you want killed, both will be killed.  Use this command
      if you interrupted your photo session or replay (^X)  and  don't  wish  to
      continue  it.   Normally  a  photo  session is ended by entering "@POP" or
      "@LOGOUT" to the inferior EXEC used by photo.
      

 REPLAY (photo session from)  <file-name>  (starting at)  <string>

      Allow you to replay a recorded terminal session from a photo log file (eg.
      PHOTO.PIC).   This  is  most  useful  for  terminal  session recorded from
      display terminals since the actual  cursor  positioning  escape  sequences
      will  be  sent  (unlike using the EXEC "TYPE" command).  During replay you
      will be able to control the speed of replay using ^A (to speed up  replay)
      and  ^Z  (to  slow  it down).  To abort a replay session use the interrupt
      character (default is ^X).  To insure an accurate replay you should insure
      your terminal characteristics at the start of replay are the same as those
      when the photo session was initiated.  The "search-string" is  optional  -
      if  specified  replay  will  begin  at  the first line where the string is
      found.
      

 RESET (all settings to default values)

      Initializes all settings to their default values (see the SET command).
      

 SET ?  one of the following:
       ECHO                   INTERRUPT-CHARACTER     LOG-TOGGLE-CHARACTER
       LOGOUT-CAPABILITY      NO                      REPLAY-SPEED

      SET ECHO (when TAKEing command files)

           Use to turn off or on echoing of commands from  TAKE  file  (see  the
           TAKE command).
           

      SET INTERRUPT-CHARACTER (to)  <control-character>

           When the "INTERRUPT-CHARACTER" is pressed during a photo session  you
           will  be  returned  to  the  "PHOTO>"  command level.  By default the
           interrupt character is ^X (control-X) but this can be reset  to  some
           other character using this command.
           

      SET LOG-TOGGLE-CHARACTER (to)  <control-character>

           By pressing the "LOG-TOGGLE-CHARACTER" during a photo session you can
           disable  or  enable recording of your terminal session.  For example,
           if you are in the middle of a recording session and you want to  read
           your mail but don't want this in the photo log file you can press the
           log-toggle character to disable recording - read  your  mail  -  then
           press the log-toggle character again to enable recording.  By default
           the log-toggle character is ^Y (control-Y) but this can be  reset  to
           some other character using this command.
           

      SET LOGOUT-CAPABILITY (for inferior EXEC)

           By setting LOGOUT-CAPABILITY (the default) you give the inferior EXEC
           used  for  the  photo  session the ability to "@LOGOUT".  If the EXEC
           doesn't have this ability then you must use "@POP" to end  the  photo
           session.
           

      SET NO <another SET command>

           Use to negate another SET command.
           

      SET REPLAY-SPEED (to)  { FAST, SLOW }

           This sets the initial speed of replay.  If neither FAST  or  SLOW  is
           specified  FAST  is  assumed.   Once  replay has started you can fine
           adjust replay speed using ^A or ^Z (see the REPLAY command).
           


 START (photo session)  { /APPEND or <file-name> }

      Starts photographing the terminal session.  The default file name if  none
      is  given is PHOTO.PIC.  The switch "/APPEND" is optional.  If you include
      it must come before the file name.  Use  "/APPEND"  to  append  the  photo
      session to the end of another file.  To end your photo session you can use
      the EXEC "@POP" or "@LOGOUT" commands.  "@POP" will return you back to the
      "PHOTO>" command level.
 

 TAKE (commands from file)  <file-name>

      Will take command from another file.  The default file  name  if  none  is
      given  is PHOTO.CMD.  When PHOTO first starts up there is an implicit TAKE
      of the file PS:<login-directory>PHOTO.INI.
      
