BBI-SS PAS image log
A BBI-SS PAS image log consists of two log data sets, BBIIMAG1 and BBIIMAG2, which are used alternately. BBI-SS PAS image logging begins automatically when the BBI-SS PAS is started unless the corresponding DD statement is removed from the BBI-SS PAS JCL. For information about allocating these logs, see Allocating-BBI-SS-PAS-journal.
BBI logic tests the space available in the image log data set before the image is added. If sufficient space is not available, BBI invokes the CLOSE and OPEN routines for the image log. As a result, even though a secondary extent may exist, it will not be used.
If logging stops for any reason, it can be resumed by issuing the BBI control command START IMAGE, as described in BBI-control-commands.
A BBI-SS PAS image log records screen images that are produced automatically by timer-driven analyzer and monitor services.
Determining capacity of the BBI-SS PAS image log
Images logged to the data set are of two types with different lengths. Thus, the capacity of the log depends on the combination of records that are logged to the data set. As a guideline, the image log uses 4092 bytes to store one large image--that is, 10 per 3380 track.
Displaying the status of a BBI-SS PAS image log
The status of a BBI-SS PAS image log can be checked with the BBI control command DISPLAY IMAGE (see BBI-control-commands for more information about the DISPLAY command).
Switching BBI-SS PAS image log data sets
When one BBI-SS PAS image log data set becomes full, logging automatically switches to the alternate data set.
Logging can also be switched to the alternate data set manually with the BBI control command SWITCH IMAGE. This command could be used, for example, to synchronize the data sets with a target session, (see BBI-control-commands for more information about the SWITCH command).
Whenever logging switches, either automatically or manually, a started task BBIUSR02, is invoked to print the data set (see Creating-automatic-BBI-SS-PAS-log-handling-procedures). Any data residing on the alternate data set is overwritten.
Printing a BBI-SS PAS image log
You can print a BBI-SS PAS image log in the following ways:
Automatically
The started task, BBIILOG, is a procedure that can be scheduled automatically to print a full BBI-SS PAS image log data set.
Manually
The sample procedure in BBSAMP member ILOGJCL can be edited to replace the PROC statement with a JOB statement and submitted to print a BBI-SS PAS image log data set. Selection statements can also be defined, as described in Selecting-and-printing-image-log-records.
Handling BBI-SS PAS image log maintenance and errors
When the image log data set is full or an I/O error is encountered on the image log, a user exit named BBIUSR02 is invoked (see Creating-automatic-BBI-SS-PAS-log-handling-procedures).
After the error is corrected, logging can be resumed by issuing the BBI control command START IMAGE (see BBI-control-commands for more information about the START command).
When a BBI-SS PAS image log is restarted after being stopped for any reason, it resumes recording at the beginning of the log data set identified as BBIIMAG1. Any data on BBIIMAG1 is overwritten.