Trailing-Edge
-
PDP-10 Archives
-
decuslib20-10
-
decus/20-184/photo.hlp
There are no other files named photo.hlp in the archive.
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.