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


Chapter 1 Using TIBCO Object Service Broker Utilities : S6BTLFAL (Format ARCHLOG)

S6BTLFAL (Format ARCHLOG)
S6BTLFAL is used to format the ARCHLOG. The ARCHLOG is a log file that retains information vital for recovery processing.
Invocation
The S6BTLFAL 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.
ARCHLOG Information
Setup Requirements
The ARCHLOG is a fixed-block 132-byte data set that must:
Be formatted using S6BTLFAL before TIBCO Object Service Broker can use it. You can use the FORMAT1 member of the JCL data set for this original formatting.
Contents from Different Utilities
The ARCHLOG contains records of different record types. Which record types appear depends on the utilities you run. Not all types are created by all utilities:
The S6BSPJEX (Offload Journal Records) utility.
The S6BSPX35 (Merge Output Sort Exit) utility.
The S6BTLBPS (Back Up Page Data Sets) utility.
The S6BTLFCA (Format Cache Data Sets) utility.
The S6BTLFJR (Format Journal Data Sets) utility.
The S6BTLFPS (Format TDS Page Data Sets) utility.
The S6BTLRPS (Restore TDS Segment) utility.
The S6BTLUPS (Unload a Page Data Set to Backup) utility.
This is the format of the five different record types.
Identification – identifies the job and time of the task:
Summary – spin only, summaries input and output:
Input – details of input data sets:
Output – details output data sets:
Comments – spin only, report errors, and so on:
Size Requirements
Before defining the ARCHLOG, you must determine how big to make it.
The following utilities account for the majority of the data in an ARCHLOG:
To estimate your space requirements, review the activity of your system as follows:
1.
This also identifies the number of merges.
2.
3.
Refer to the chart in Contents from Different Utilities.
4.
It is recommended that you make your ARCHLOG big enough to retain a minimum of two full backup cycles.
5.
Use the audit report produced by S6BTLFAL to verify that you created an ARCHLOG big enough for the total number of ARCHLOG records you estimated.
See Also
TIBCO Object Service Broker for z/OS Managing Backup and Recovery for more information about the journal spin process.
Sample Report
The following illustrates the audit report that comes out of this utility:

 
DATASET NAME SYS1.STAR.ARCHLOG
VOLUME            STAR11
RECORD LENGTH 132
BLOCK SIZE 27984
BLOCKS/TRACK 2
RECORDS/TRACK 424
TRACK COUNT 2
TOTAL RECORDS 848

 
Return Codes
Upon termination, this utility returns one of the following codes:
Related Utility
S6BTLPAL (Print ARCHLOG Information)
See Also
TIBCO Object Service Broker for z/OS Managing Backup and Recovery for more information about the ARCHLOG.

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