HELPLIB.HLB  —  KCAP  Commands  TRACK  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    /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.

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

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.

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.

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.

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

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
Close Help