$ KCAP/TRACK [=filespec] KCAP> TRACK [=filespec]
The KCAP/TRACK subcommand is used to start KeyCapture for a
terminal. TRACK also enables tracking of RTA terminals.
You may also specify the name for the resulting KeyCapture file.
The default filespec is taken from the logical KCAP$OUTPUT_LOG_FILE.
This logical may be defined system-wide by KCAP_DEFAULTS.COM, or it
may be defined in any of the logical-name tables specified in
LNM$KCAP_TABLE_SEARCH_LIST, which is defined by KCAP_DEFAULTS.COM.
See the top-level KCAP Subtopic: Defaults.
If this logical is not defined and if /OUTPUT_LOG_FILE is specified
without the optional filespec, then KCAP will generate a log file
in the SYS$MANAGER directory using a default log-file name of:
KCAP_username_terminalname.KCAP
To close the current log file and start logging to a new log file
use a $ KCAP/TRACK/NEW_FILE command.
Terminal logging with /TRACK is terminated by KCAP/NOTRACK.
Examples:
$ KCAP /TRACK ! Start KeyCapture for the SYS$COMMAND terminal
! using the default file name and directory.
$ KCAP/TRACK=SYS$SCRATCH:SAVE_INPUT ! Start capture specifying a file
! spec.
1 – Description
Key capture begins after a TRACK command has been done. This is often done from SYLOGIN.COM or LOGIN.COM. KeyCapture is turned off by the NOTRACK command. When KeyCapture is in progress, a new log file can be started with KCAP/TRACK/NEW_FILE. This closes any existing file and starts key capture to a new file.
1.1 /MAX_REOPEN
$ KCAP/TRACK/REOPEN /MAX_REOPEN = blocks
/NOMAX_REOPEN
Specifies the approximate maximum number of blocks to which a
terminal-logging file may grow before a new version of the log file
is started, when /REOPEN is in effect.
Use /NOMAX_REOPEN to specify that any default /MAX_REOPEN value
should be ignored.
The default value for /MAX_REOPEN is taken from the logical
KCAP$MAX_REOPEN, usually defined by KCAP_DEFAULTS.COM.
Example: $ KCAP/TRACK/REOPEN/MAX_REOPEN=100
For more information, see the KCAP Commands TRACK Subtopic:
/REOPEN.
1.2 /MIN_REOPEN
$ KCAP/TRACK/REOPEN /MIN_REOPEN = blocks
/NOMIN_REOPEN
Specifies the minimum number of blocks to which a terminal-
logging file must grow before a new version of the log file is
started, when /REOPEN is in effect.
Use /NOMIN_REOPEN to specify that any default /MIN_REOPEN value
should be ignored.
The default value for /MIN_REOPEN is taken from the logical
KCAP$MIN_REOPEN, usually defined by KCAP_DEFAULTS.COM.
Example: $ KCAP/TRACK/REOPEN/MIN_REOPEN=10
/MIN_REOPEN is ignored for reopens done as a result of
a /TIME_OF_DAY specification.
For more information, see the KCAP Commands TRACK Subtopic:
/REOPEN
1.3 /NEW_FILE
$ KCAP/TRACK /[NO]NEW_FILE
Used to specify that a new KeyCapture file should be started.
Any current KeyCapture file is closed.
Example:
$ KCAP/TRACK=LOG.LOG ! Start logging to LOG.LOG.
$ KCAP/TRACK=NEWLOG.LOG/NEW_FILE
! Close LOG.LOG and start
! logging to NEWLOG.LOG.
1.4 /PERMANENT
$ KCAP/TRACK /PERMANENT
/NOPERMANENT (default)
Used to specify that the screen-saving (on AXP) or terminal-logging
(on AXP or VAX) cannot be shut off for the terminal concerned.
Example: $ KCAP/TRACK/PERMANENT
Also applies to terminal-logging on both VAX and AXP. E.g.
KCAP> TRACK=PERMANENT.LOG /PERMANENT
The PERMANENT qualifier disallows turning off screen-saving with the
NOTRACK command. If there is a log file for the screen-saving,
then the logging cannot be turned off if /PERMANENT is used.
A permanent screen-saver only goes away when the terminal itself goes
away (for LTAs etc which are deleted when the user logs off) or when
the system is shut down (for permanent terminals such as TTAs, etc.).
The /PERMANENT qualifier should be used with EXTREME CAUTION with
logging on direct-connect terminal such as TTA's, TXA's or OPA's
since with these terminals the log file will just continue to grow
and can't be turned off without rebooting the system.
/PERMANENT is mainly intended for security use on such things as
dial-up lines, where a log file of the terminal output is desired
and the system manager doesn't want the user to be able to stop
the logging by doing a NOTRACK command.
1.5 /REOPEN
$ KCAP/TRACK /[NO]REOPEN Used to specify that new versions of a terminal-logging file should [not] be periodically opened. Example: $ KCAP/TRACK/REOPEN /REOPEN re-opens a new version of the log file whenever it reaches a certain number of disk blocks, or whenever a certain time of day or span of time has elapsed, providing at least a certain minimum number of blocks have been written to the file. The maximum and minimum blocks and the time of day and time span are specified using the /MAX_REOPEN, /MIN_REOPEN, /SPAN and /TIME_OF_DAY qualifiers, or by defaults for these which are specified in logical names. The default /REOPEN value is taken from the logical KCAP$REOPEN. /NOREOPEN is used on the command line to override a default /REOPEN value.
1.6 /SPAN
$ KCAP/TRACK/REOPEN /SPAN = minutes
/NOSPAN
Specifies the approximate time period which should elapse before
a new version of a terminal-logging file should be started, when
/REOPEN is in effect.
Use /NOSPAN to specify that any default /SPAN value should
be ignored.
The default value for this qualifier is taken from the logical
name KCAP$SPAN.
Example: $ KCAP/TRACK/REOPEN/SPAN=10
The number of minutes can contain a decimal point. The minimum
acceptable value is 1 minute.
For more information, see the KeyCapture Commands TRACK Subtopic:
/REOPEN
1.7 /TIME_OF_DAY
$ KCAP/TRACK/REOPEN /TIME_OF_DAY = hh:mm
/NOTIME_OF_DAY
Specifies the approximate time of day when a new version of a
log file should be started (when /REOPEN is in effect).
Use /NOTIME_OF_DAY to specify that any default /TIME_OF_DAY
value should be ignored.
The default value for this qualifier is taken from the logical
name KCAP$TIME_OF_DAY.
Example: $ KCAP/TRACK/REOPEN/TIME_OF_DAY=23:59
The above command specifies that a new log file version should
be created at 1 minute before midnight each day.
Valid values for /TIME_OF_DAY are 00:00 through 23:59.
Note that all 5 characters of the hh:mm syntax are required
in all cases. Midnight would be specfied as 00:00. (The
special value /TIME_OF_DAY=-1 is the equivalent of
/NOTIME_OF_DAY and causes the qualifier to be ignored.)
Examples: The log file will be reopened at:
/TIME_OF_DAY=00:00 12:00 AM
/TIME_OF_DAY=00:01 12:01 AM
/TIME_OF_DAY=01:00 1:00 AM
/TIME_OF_DAY=12:00 12:00 PM
/TIME_OF_DAY=14:03 2:03 PM
Any /MIN_REOPEN value is ignored when reopening a file at
the /TIME_OF_DAY specified.
For more information, see the KCAP Commands TRACK Subtopic:
/REOPEN