01/20/85  convert_old_log

Syntax:  convert_old_log OLD_LOG {-control_args}


Function: Moves the information in a family of old (syslog/write_log_)
log segments to a new format log family.


Arguments:
OLD_LOG
   is the pathname of the first segment (most recent) of a syslog
   family.


Control arguments:
-old_history_dir DIR, -ohd DIR
   Specifies that older segments in the family are to be found in DIR.
   The default is >udd>sa>a>history.
-new_dir DIR, -nd DIR
   Specified that the current live log segment for this log is located
   in the directory DIR.  If there is no current live log segment,
   special actions specified under "notes" below are needed.  The
   default is >sc1>as_logs>LOG_NAME.
-new_history_dir DIR, -nhd DIR
   Specifies that the converted information is to be put in segments
   in the directory dir.  The default is >udd>sa>a>history.


Access required: This requires r to the old logs, sma to the new
history dir, and rw to the live log segment.


Notes:
This command creates as many new log segments in the new history dir
as needed to contain all the old information.  Then it sets the
previous log pathname in the oldest segment of the live log family to
the history dir.

The command chases through the headers of the old format logs and will
collect pointers of up to 200 logs.  Once it cannot find the previous
log, the conversion starts with the oldest log.  As each old log is
converted, a message displays the entry name.

If an old log is found to be damaged, the command will stop with an
error message to this effect.  The damaged log can be manually patched
up or moved out so that it cannot be found by the previous log
chaining.  Then just reenter the command.


If the previous chain is broken, just add the name of the log family
to the newest of the unconverted logs and then enter the same command
line in again.

If there is no live log segment family, the pathname cannot be set.
You will have to use the set_log_history_dir command to set it.  If
there will never be a live log, you should rename the segment with the
most recent timestamp in its name created in the new history dir to
have the name LOG instead of LOG.TIMESTAMP.

The conversion will require at most the same amount of quota that the
old logs occupy.  In general the new logs format allows the converted
logs to occupy less quota.


Examples:  convert_old_log >sc1>log


                                          -----------------------------------------------------------


Historical Background

This edition of the Multics software materials and documentation is provided and donated
to Massachusetts Institute of Technology by Group BULL including BULL HN Information Systems Inc. 
as a contribution to computer science knowledge.  
This donation is made also to give evidence of the common contributions of Massachusetts Institute of Technology,
Bell Laboratories, General Electric, Honeywell Information Systems Inc., Honeywell BULL Inc., Groupe BULL
and BULL HN Information Systems Inc. to the development of this operating system. 
Multics development was initiated by Massachusetts Institute of Technology Project MAC (1963-1970),
renamed the MIT Laboratory for Computer Science and Artificial Intelligence in the mid 1970s, under the leadership
of Professor Fernando Jose Corbato. Users consider that Multics provided the best software architecture 
for managing computer hardware properly and for executing programs. Many subsequent operating systems 
incorporated Multics principles.
Multics was distributed in 1975 to 2000 by Group Bull in Europe , and in the U.S. by Bull HN Information Systems Inc., 
as successor in interest by change in name only to Honeywell Bull Inc. and Honeywell Information Systems Inc. .

                                          -----------------------------------------------------------

Permission to use, copy, modify, and distribute these programs and their documentation for any purpose and without
fee is hereby granted,provided that the below copyright notice and historical background appear in all copies
and that both the copyright notice and historical background and this permission notice appear in supporting
documentation, and that the names of MIT, HIS, BULL or BULL HN not be used in advertising or publicity pertaining
to distribution of the programs without specific prior written permission.
    Copyright 1972 by Massachusetts Institute of Technology and Honeywell Information Systems Inc.
    Copyright 2006 by BULL HN Information Systems Inc.
    Copyright 2006 by Bull SAS
    All Rights Reserved