1 :Info: convert_old_log:  1985-01-20  convert_old_log
 2 
 3 Syntax as a command:  convert_old_log OLD_LOG {-control_args}
 4 
 5 
 6 Function: Moves the information in a family of old (syslog/write_log_)
 7 log segments to a new format log family.
 8 
 9 
10 Arguments:
11 OLD_LOG
12    is the pathname of the first segment (most recent) of a syslog
13    family.
14 
15 
16 Control arguments:
17 -old_history_dir DIR, -ohd DIR
18    Specifies that older segments in the family are to be found in DIR.
19    The default is >udd>sa>a>history.
20 -new_dir DIR, -nd DIR
21    Specified that the current live log segment for this log is located
22    in the directory DIR.  If there is no current live log segment,
23    special actions specified under "notes" below are needed.  The
24    default is >sc1>as_logs>LOG_NAME.
25 -new_history_dir DIR, -nhd DIR
26    Specifies that the converted information is to be put in segments
27    in the directory dir.  The default is >udd>sa>a>history.
28 
29 
30 Access required: This requires r to the old logs, sma to the new
31 history dir, and rw to the live log segment.
32 
33 
34 Notes:
35 This command creates as many new log segments in the new history dir
36 as needed to contain all the old information.  Then it sets the
37 previous log pathname in the oldest segment of the live log family to
38 the history dir.
39 
40 The command chases through the headers of the old format logs and will
41 collect pointers of up to 200 logs.  Once it cannot find the previous
42 log, the conversion starts with the oldest log.  As each old log is
43 converted, a message displays the entry name.
44 
45 If an old log is found to be damaged, the command will stop with an
46 error message to this effect.  The damaged log can be manually patched
47 up or moved out so that it cannot be found by the previous log
48 chaining.  Then just reenter the command.
49 
50 
51 If the previous chain is broken, just add the name of the log family
52 to the newest of the unconverted logs and then enter the same command
53 line in again.
54 
55 If there is no live log segment family, the pathname cannot be set.
56 You will have to use the set_log_history_dir command to set it.  If
57 there will never be a live log, you should rename the segment with the
58 most recent timestamp in its name created in the new history dir to
59 have the name LOG instead of LOG.TIMESTAMP.
60 
61 The conversion will require at most the same amount of quota that the
62 old logs occupy.  In general the new logs format allows the converted
63 logs to occupy less quota.
64 
65 
66 Examples:  convert_old_log >sc1>log
67 
68 
69 :hcom:
70 
71 
72 
73 /****^  HISTORY COMMENTS:
74   1) change(2020-12-14,GDixon), approve(2021-02-22,MCR10088),
75      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
76       A) Change "Syntax:" to "Syntax as a command:" in command info seg
77          last changed after 1984.
78                                                    END HISTORY COMMENTS */
79 
80 
81