z/TPF - Group home

z/TPFDF system diagnostic improvements (PH48876)

By Daniel Jacobs posted 15 days ago

  

z/TPFDF system diagnostic improvements provide additional diagnostic information on select system errors and ensure that get and release pool logging consistently uses the application program name.

Previously, it was difficult and time consuming to determine exactly what the problem was without enough diagnostic information. For example:

  • DB0101 system errors indicated that an invalid LREC size was found, but the corrupted LREC was not readily apparent based on the available diagnostic information:

    CPSE0162E 09.32.15 IS-0001 SS-BSS SSU-BSS  SE-000200 OPR-IDB0101
    010000A TRC-QXG6        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A75000.  

    UTDF    OBJ-ub90            00002242  LOADSET-BASE

    BD90 PFA 0000000068280357 00 CFA 0000000068280357    
            

  • DB011B system errors indicated a find error while releasing a chain of pool records, but no message text was provided about why the find error occurred.

    CPSE0162E 09.46.55 IS-0001 SS-BSS SSU-BSS  SE-000201 OPR-IDB011B
    010000A TRC-QXEU        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A09000. 
    UTDF    OBJ-ub90            00002242  LOADSET-BASE            
    BD14 PFA 00000000801CB71F 2B CFA 00000000801CB71F  

  • DB017E system errors indicated a retain API was issued before an LREC was retrieved, but no diagnostic information was provided on the console at all.

    CPSE0162E 09.49.47 IS-0001 SS-BSS SSU-BSS  SE-000202 OPR-IDB017E
    010000A TRC-QXG4        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A4E000. 
    UTDF    OBJ-ub90            0000224E  LOADSET-BASE             

With z/TPFDF system diagnostic improvements, several system errors are enhanced with additional information to facilitate problem determination. For example:

 

  • DB0101 system errors are updated to provide the invalid size of the LREC and indicate whether the LREC already exists or is new.

    CPSE0162E 09.33.48 IS-0001 SS-BSS SSU-BSS  SE-000794 OPR-IDB0101      
    010000A TRC-QXG6        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A24000.               
    UTDF    OBJ-ub90            00002B5C  LOADSET-BASE                          
    BD90 PFA 0000000068280357 00 CFA 0000000068280357                              
    FAILING FILE ADDRESS 0000000068280357                                       
    THE LREC SIZE OF 1F40 IN THE NEW LREC EXCEEDS THE MAXIMUM SIZE OR IS NOT VALID.

    CPSE0162E 09.35.22 IS-0001 SS-BSS  SSU-BSS  SE-NODUMP OPR-IDB0101
    010000A TRC-QXG6        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11ABA000.      
    UTDF    OBJ-ub90            00002B5C  LOADSET-BASE                 
    C2C4 PFA 000000003220029F 00 CFA 00000000811E942F                   
    FAILING FILE ADDRESS 000000003220029F                               
    THE LREC SIZE OF 03E2 IN THE CURRENT LREC AT OFFSET 001A IS NOT VALID.


In addition, registers 14 and 15 will contain the address of the current or new LREC, respectively.  With the provided information, you can easily find the contents of the LREC in the corresponding dump.

  • Several system errors that did not have any text to indicate what the error was are updated to provide a text message that is sent to the console and included in the dump.

    CPSE0162E 09.48.17 IS-0001 SS-BSS SSU-BSS  SE-000798 OPR-IDB011B
    010000A TRC-QXEU        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A24000. 
    UTDF    OBJ-ub90            00002B5C  LOADSET-BASE             
    BD14 PFA 00000000811E943F 9B CFA 00000000811E943F               
    ID CHECK FAILURE FOR FILE ADDRESS 00000000811E946F           

 

  • Several system errors that did not have any diagnostic information are updated to provide the standard z/TPFDF dump information, which includes the file ID, prime file address, record code check, and current file address.

    CPSE0162E 09.51.24 IS-0001 SS-BSS SSU-BSS  SE-NODUMP OPR-IDB017E
    010000A TRC-QXG4        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A2D000.  
    UTDF    OBJ-ub90            00002B5C  LOADSET-BASE            
    BDDD PFA 0000000000000000 00 CFA 0000000000000000               
    A CURRENT LREC MUST BE LOCATED BEFORE THAT LREC CAN BE RETAINED.

 

  • Several system errors that might occur with a file address that is different from the prime or current file address are updated to also include the failing file address.

    CPSE0162E 09.57.51 IS-0001 SS-BSS SSU-BSS  SE-NODUMP OPR-IDB010F
    010000A TRC-QXG1        OWNER-drvrDFTDfrmCVZZ-ECBAdr:11A27000. 
    UTDF    OBJ-ub90            00002B5C  LOADSET-BASE             
    BDDD PFA 000000003220000F 00 CFA 000000003220000F               
    FAILING FILE ADDRESS 00000000811E950F                         
    AN INVALID LREC SIZE OR NAB WAS FOUND.

In addition, the get and release file requests for large logical records (LLRs) and algorithm information subfile records are stored in the ECB trace, on the logging tape, and in the record itself for display with the ZDMRD command. However, the information previously contained the name of the z/TPFDF product segment instead of the application program. Therefore, it was difficult to determine the owner of a corresponding application segment if a problem occurred.

With z/TPFDF system diagnostic improvements, the information contains the name of the application that issued the z/TPFDF APIs that resulted in the file requests. With this change, you can use the information to determine the potential problems more easily.

For more information about APAR PH48876, see the APEDIT.

0 comments
0 views