Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Using TIBCO Object Service Broker Utilities : S6BTLFRL (Format Redolog)

S6BTLFRL (Format Redolog)
S6BTLFRL is used by the TIBCO Object Service Broker backup and recovery procedures to format the redolog. It can also be used to format a duplex copy of the redolog if present. If the redolog is duplexed as defined in the DBGEN statement, a single execution of S6BTLFRL formats both the primary and duplex data sets if they are empty.
S6BTLFRL by default formats only empty data sets. If you specify the FORCE parameter, S6BTLFRL formats the redolog data set even if valid data appears to be present in the log. In most situations, you should delete and redefine the data set being formatted before invoking this utility. The redolog is defined using a standard system utility such as IDCAMS.
S6BTLFRL can also be used to produce a copy of the redolog. This could be necessary, for example, if a redolog or its duplex is damaged. Before you restart TIBCO Object Service Broker, create a copy of the good data set: whichever of the redolog or its duplex that is not damaged. Refer to Invocation for Copying.
Invocation
The S6BTLFRL member of the JCL data set distributed with TIBCO Object Service Broker contains sample JCL required to run this utility. This sample is provided as a reference only; modify the JCL for your needs.
Sample Output
The following illustrates sample output from the S6BTLFRL utility:

 
+S6BKX002I DSN=TEST.STAR.REDOLOG
+S6BTL075E REDOLOG DATASET NOT EMPTY
+S6BTL056I FORMATTING DUPLEX REDOLOG
+S6BKX002I DSN=TEST.STAR.REDOLOG.DUPLEX
+S6BDB035I REDOLOG CI SIZE IS 4096 BYTES
+S6BTL073I 000018000 PAGES SUCCESSFULLY FORMATTED

 
Return Codes
Upon termination, this utility returns one of the following codes:
Redolog could not be formatted because the data set contains data. Check the job log for associated information. This return code would not appear when you use the FORCE parameter.
Results Summary
The following table summarizes the effect of invoking this utility on both primary and duplex redolog data sets:
Data Present in Primary Redolog Data Set
Data Present in Duplex Redolog Data Set
Return Code 0 Both data Sets formatted
Invocation for Copying
When copying a redolog, S6BTLFRL checks that the following are true:
The following are sample JCL statements for running S6BTLFRL to copy a redolog.

 
//COPY EXEC PGM=S6BTLFRL,PARM=’COPY’
//STEPLIB DD DSN=$HLQNONV$.$INSTVER$.LOAD,
// DISP=SHR
//DBDLIB DD DSN=$HLQVSAM$.$SLQ$.DBDLIB,
// DISP=SHR
//REDOIN DD DSN=$HLQVSAM$.$SLQ$.REDOLOG,
// DISP=SHR
//REDOOUT DD DSN=$HLQVSAM$.$SLQ$.REDOLOG.DUPLEX,
// DISP=SHR
//SYSPRINT DD SYSOUT=$SYSPRT$
//SYSIN DD DUMMY

 
See Also
TIBCO Object Service Broker for z/OS Installing and Operating for more information on defining the redolog data set.
TIBCO Object Service Broker for z/OS Managing Backup and Recovery for complete information about TIBCO Object Service Broker backup and recovery.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved