Renaming a log stream dynamically

Start of changeYou can rename a log stream dynamically using the NEWSTREAMNAME keyword on the IXGINVNT REQUEST=UPDATE request. Since many logging programs use a fixed log stream name, this function can be very useful for log stream recovery. For example, if a log stream fails, the system might not be able to perform any logging for the log stream that has failed. Using the log stream rename function, you can rename the failing log stream and then use IXGINVNT REQUEST=DEFINE to define a new log stream with the old name in order to start logging again. This function allows you to perform the following functions:
  • Save the current data in a renamed log stream and start logging quickly by defining a new log stream with the expected name
  • Let existing services and utilities access the data in the renamed log stream to reduce the effect of having some data missing from the log stream
  • Perform problem diagnosis, such as data missing conditions, on the original (renamed) log stream resources at the same time that new work continues
End of change

You must have an active primary TYPE=LOGR couple data formatted at an HBB7705 level or higher in order to specify the NEWSTREAMNAME parameter.