User's Guide

DSPLOG

Print or display a TAE session log

Function:

Displays a TAE session log. Three subcommands allow the user different processing options. The -ALL subcommand writes the session log from beginning to end. The -TIME subcommand writes records from the session log based on a starting date (mm/dd/yr) and time (hh:mm:ss) to an ending date and time. The -DIR subcommand displays a directory listing of session logs.

Parameters:

Subcommand -ALL:
Displays the session log from beginning to end. The entire default or specified session log is output to the appropriate destinations.

INFILE(--)
Input file. Name of the TAE session log file to be processed. The default name is SESSION.TSL.

PRINT(TERM)
Output destination. The destination of the output. 


  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent
               to the user-supplied file with the 
               extension ".prt".
Subcommand -TIME:
Displays the session log based on date and time. Selected records (based on user input dates and times) from the default or specified session log are output to the appropriate destinations.

INFILE(--)
Input file. Name of the TAE session log file to be processed. The default name is SESSION.TSL.

BEGDATE(--)
Beginning date. BEGDATE has the format mm/dd/yy, where mm, dd and yy are month, day and year. Leading zeroes are not required for single digit numbers but all three values are required. Valid month values are 1 to 12, valid day values are 1 to 31 and valid year values are 0 to 99. A null value indicates a beginning date is not used to determine whether a given record is to be displayed (i.e. a record is not discarded because its date is too early).

ENDDATE(--)
Ending date. ENDDATE has the format mm/dd/yy, where mm, dd and yy are month, day and year. Leading zeroes are not required for single digit numbers but all three values are required. Valid month values are 1 to 12, valid day values are 1 to 31 and valid year values are 0 to 99. A null value indicates an ending date is not used to determine whether a given record is to be displayed (i.e. a record is not discarded because its date is too late).

BEGTIME(--)
Beginning time. BEGTIME has the format hh:mm:ss, where hh, mm and ss are hours, minutes and seconds, respectively, on a 24-hour clock. Leading zeroes are not required for single digit numbers and omitted values are defaulted to zeroes (i.e. 8:56 implies 08:56:00). Valid hour values are 1 to 24, valid minute values are 0 to 59 and valid second values are 0 to 59. A null value indicates a beginning time is not used to determine whether a given record is to be displayed (i.e. a record is not discarded because its time stamp is too early).

ENDTIME(-- )
Ending time. ENDTIME has the format hh:mm:ss, where hh, mm and ss are hours, minutes and seconds, respectively, on a 24-hour clock. Leading zeroes are not required for single digit numbers and omitted values are defaulted to zeroes (i.e. 8:56 implies 08:56:00). Valid hour values are 1 to 24, valid minute values are 0 to 59 and valid second values are 0 to 59. A null value indicates an ending time is not used to determine whether a given record is to be displayed (i.e. a record is not discarded because its time stamp is too late).

PRINT(TERM)
Output destination. The destination of the output. 


  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent
               to the user-supplied file with the 
               extension ".prt".
Subcommand -DIR:
Displays a directory listing of session logs. A listing of all files in the current directory with the extension .TSL are output to the appropriate destinations.

PRINT(TERM)
Output destination. The destination of the output. 


  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent
               to the user-supplied file with the 
               extension ".prt".

Examples:

  1. LAS> dsplog-all print=lp

    Lists the entire current session log at the line printer.

  2. LAS> dsplog-time infile=save.tsl begtime=10:15

    Displays selected records from the session log SAVE.TSL at the terminal. Any record with a time stamp of 10:15 AM or later (regardless of the date) is displayed.

  3. LAS> dsplog-time infile=save.tsl begdate=6/15/90

    Displays selected records from the session log SAVE.TSL at the terminal. Any record with a date of June 15, 1990 or later (regardless of the time) is displayed.

  4. LAS> dsplog-time begdate=7/1/90 begtime=8:45

    Displays selected records from the session log SESSION.TSL at the terminal. Any record with a date and time stamp of July 1, 1990 8:45 AM or later is displayed.

  5. LAS> dsplog-time begtime=8:45 endtime=16:00

    Displays selected records from the session log SESSION.TSL at the terminal. Any record with a time stamp later than 8:45 AM and earlier than 4:00 PM (regardless of the date) is displayed.

  6. LAS> dsplog-time begdate=9/15/91 enddate=9/20/90 begtime=9:15 endtime=14:00 print=(term,lp)

    Lists records from the 15th of September whose time stamp is 9:15 AM or later to the 20th of September whose time stamp is 2:00 PM or earlier at the terminal and on the line printer.

  7. LAS> dsplog-dir

    Displays a list of session log files at the user's terminal with the time and date of each.

Description/Algorithm:

DSPLOG first disables TAE session logging. If the subcommand -DIR was selected, a directory listing of files with the extension .TSL from the current directory is output to the appropriate destinations. If the subcommands -ALL or -TIME are selected, the specified or most recent (if the parameter INFILE is defaulted) SESSION.TSL file is then read line by line. If subcommand -TIME is specified, only those records recorded within the specified date and time range are processed. DSPLOG then displays these records on the terminal, line printer or to a user specified file. Finally, DSPLOG always enables session logging even if logging was disabled before running DSPLOG. Users may then disable session logging if so desired.

Nonfatal Error Message:

    None.

Fatal Error Messages:

  1. [dsplog-clsfil] Error closing session log file, Error closing print file

    An error occurred while attempting to close the temporary print file, the user specified print file or the session log file. Contact the system manager.

  2. [dsplog-fatal] Fatal error encountered

    A fatal error was encountered during processing. The error message that is displayed immediately preceding this message is the specific error that was encountered.

  3. [dsplog-invdate] Invalid date format

    An invalid date was entered for the BEGDATE or ENDDATE parameter. The correct format for date specifications is mm/dd/yy. Leading zeroes are not required for single digit numbers but all three portions of the date (month, day and year) are required. Valid month values are 1 to 12, valid day values are 1 to 31 and valid year values are 0 to 99.

  4. [dsplog-invtime] Invalid time format

    An invalid time was entered for the BEGTIME or ENDTIME parameter. The correct format for time specifications is hh:mm:ss. Leading zeroes are not required for single digit numbers and omitted portions are defaulted to zeroes (i.e. 8:56 implies 08:56:00). Valid hour values are 1 to 24, valid minute values are 0 to 59 and valid second values are 0 to 59.

  5. [dsplog-opnprt] Error opening print file

    An error occurred while attempting to open the temporary print file or the user specified file. Be sure the user has write permission for the current directory and that there is disk space available or contact the system manager.

  6. [dsplog-opnses] Error opening session log file

    The SESSION.TSL file or the user specified session log file either does not exist because session logging was never enabled in TAE or there was a system error while attempting to open the file. Be sure the session log file exists. If it does, try again or contact the system manager.

  7. [dsplog-range] No records found within the specified date and time range

    The subcommand -TIME will output this error if no records in the input session log file meet the criteria established by the parameters BEGDATE, ENDDATE, BEGTIME and ENDTIME. Respecify these parameters or use the subcommand -ALL to print all records from the session log file.

User Notes:

  1. When the user specifies beginning and/or ending times for the subcommand -TIME but does not specify beginning or ending dates, the date of the record from the session log is disregarded.

  2. Not all records from the TAE session log are output. Only those records indicating the function executed as well as the date and time of execution, the parameter values the function was run with and informational and error messages are output. This results in a more readable format than the standard session log.