PSB Check report
The PSB Check report is generated in the SYSPRINT data set as a result of the consistency check for PSBs.
This report contains the following three parts:
- Library information
- Program Specification Block (PSB) information
- Program Communication Block (PCB) information
Sample report
The following figure shows an example of the PSB Check report.
Note: Even when the IMS installed level is updated to 15.2
and ACB, DBD, PSB, and RECON are generated with IMS, IMS 15.1 is still used for such
resources.
IMS LIBRARY INTEGRITY UTILITIES - CONSISTENCY CHECKER "PSB CHECK REPORT" PAGE: 1
5655-U08 DATE: 10/01/2021 TIME: 12.04.07 FABLECHK - V2.R2
LIBRARY INFORMATION
-------------------
IMS : 15.1
DFSRESLB : VOLUME=IMSVS DSNAME=IMSVS.SDFSRESL
PSBLIB : VOLUME=IMSVS DSNAME=IMSVS.PSBLIB
ACBLIB : VOLUME=IMSVS DSNAME=IMSVS.ACBLIB
MODBLKS : VOLUME=IMSVS DSNAME=IMSVS.MODBLKS SUFFIX = A IMS LIBRARY INTEGRITY UTILITIES - CONSISTENCY CHECKER "PSB CHECK REPORT" PAGE: 2
5655-U08 DATE: 10/01/2021 TIME: 12.04.07 FABLECHK - V2.R2
PSB NAME : TESTPSB1 VOLUME=IMSVS DSNAME=IMSVS.PSBLIB
PSB INFORMATION
---------------
LIBRARY CHK ITEM/FIELD CONTENTS PSBLIB
-------- --- ------------ ------------------------- -------------------------
ACBLIB ACB MBR FOUND
IMSREL 1510 1510
*** GENDATE 05/20/2021 15:31 01/12/2021 11:14
LANG ASSEM/COBOL ASSEM/COBOL
TPPCB NO 3 3
DBPCB NO 4 4
MAXQ 1 1
SSASIZE 3000 3000
IOEROPN 0 0
LOCKMAX 0 0
CMPAT YES YES
OLIC NO NO
GSROLBOK NO NO
MODBLKS PSB DEF FOUND
PGMTYPE BATCH
TPPCB INFORMATION
-----------------
P ------------------- PSBLIB / ACBLIB --------------------
PCB # CHK A LTERM/NAME PCBNAME ALTR SAME MODI EXPR LIST
----- --- - ---------- -------- ---- ---- ---- ---- ----
2 P PCBTTP1B NO NO YES NO YES
*** A TESTTP1B * PCBTTP1B NO NO NO * NO YES
LEGEND
------
PA - SHOWS 'PSBLIB / ACBLIB' DATA IS:
B: RETRIEVED FROM BOTH PSBLIB AND ACBLIB
P: RETRIEVED FROM PSBLIB
A: RETRIEVED FROM ACBLIB
DBPCB INFORMATION
-----------------
P ---------------------------- PSBLIB / ACBLIB ----------------------------
PCB # CHK A DBDNAME PCBNAME SENSEGS KEYLN PROCOPT PROCSEQ(D) VIEW LIST
----- --- - -------- -------- ------- ----- ------- -------- ----- ----
1 P TESTDB1 PCBTDB1 10 24 G TESTIDX1 YES
*** A TESTDB1 PCBTDB11* 10 24 G * YES
4 P TESTDB2 PCBTDB2 4 18 A YES
*** A TESTDB2 PCBTDB2 4 18 I * YESReport field descriptions for the library information part
This part contains information about the input libraries for the PSB check.
- IMS
- IMS version and release number retrieved from the library that is specified in DFSRESLB DD.
The following lines show the volume name and the data set name of each library.
- DFSRESLB
- IMS load library specified in DFSRESLB DD.
- PSBLIB
- PSB library specified in PSBLIB DD.
- ACBLIB
- ACB library specified in ACBLIB DD.
Unless each data set is specified in the DD statement, the line for the library is not printed.
- MODBLKS
- MODBLKS module library specified in MODBLKS DD.MODBLKS information is not printed in the following cases:
- When DRD=YES is specified in SYSIN DD.
- When the data set is not specified on the DD statement.
- When an IMS catalog PSB is processed.
- SUFFIX = (x)
- Suffix of the MODBLKS module name DFSPDIRx.
- SYSRDDS
- System RDDS specified in SYSRDDS DDSYSRDDS information is not printed in the following cases:
- When DRD=NO is specified in SYSIN DD.
- When the data set is not specified on the DD statement.
- When an IMS catalog PSB is processed.
- NSYSRDDS
- Non-system RDDS specified in NSYSRDDS DDNSYSRDDS information is not printed in the following cases:
- When DRD=NO is specified in SYSIN DD.
- When the data set is not specified on the DD statement.
- When an IMS catalog PSB is processed.
Report field descriptions for the PSB information part
This part contains information about each application program definition and the results of the consistency check.
In this part, information about only the libraries to be verified is printed.
- PSB NAME
- PSB name. Volume serial number and data set name of the library that contains the PSB member.
The columns of the table in the PSB information part are as follows:
- LIBRARY
- Library that contains each definition.
- CHK
- If any inconsistency is detected between the PSB and each definition, *** is shown.
- ITEM/FIELD
- Definition item or field.
- CONTENTS
- Contents of each field.
- PSBLIB
- Contents of the PSBs field.
The rows of the table in the PSB information part are as follows:
- ACBLIB
-
- ACB MBR
- Whether an ACB member that corresponds to the PSB is found in the ACB library.
- GENDATE
- The date and time when the ACB was generated. Notes:
- If the generation date of the PSB is later than the generation date of the ACB, Consistency Checker regards them as inconsistent.
- If the PSB was generated by IMS 3 or higher, the PSB's field is shown.
- IMSREL
- The version and release of the IMS system
that generated the ACB. Notes:
- If they are different from the version and release of the IMS system that is defined in the DFSRESLB library, Consistency Checker regards them as inconsistent.
- If the PSB was generated by IMS 3 or higher, the PSB's field is shown.
- LANG
- The compiler language.
Even if you specify LANG=blank on the PSBGEN statement, LANG=ASSEM/COBOL is shown.
- TPPCB NO
- The number of TP PCBs in the PSB.
- DBPCB NO
- The number of DB PCBs in the PSB.
- GSAMPCB NO
- The number of GSAM PCBs in the PSB.
- MAXQ
- The maximum number of database calls with Qx command codes that can be issued between synchronization points.
- SSASIZE
- The maximum total length of all SSAs used by the application program.
Unless SSASIZE is specified on the PSBGEN, Consistency Checker does not verify this field.
- IOEROPN
- The condition code that is returned to the operating system when the IMS system terminates normally, and errors that occurred on any database while running the application program.
- LOCKMAX
- The maximum number of locks that an application program can get at one time.
- CMPAT
- Whether the PSB is treated as if there were an I/O PCB.
- OLIC
- Whether the user of the PSB is authorized to run the Online Database Image Copy utility or the Surveyor utility feature that runs as a BMP against a database named in the PSB.
- GSROLBOK
- Whether an internal ROLB call should be done to roll back non-GSAM database updates.
- MODBLKS
-
- PSB DEF
- Whether an application program definition that corresponds to the PSB is found in the specified MODBLKS module.
- PGMTYPE
- The type of application program.
- TP:
- This value specifies that the IMS system schedules the program when messages processed by the program exist in the system.
- BATCH:
- This value specifies that the program can use DL/I in the system region of the IMS control program and can refer to the message queues.
MODBLKS information is not printed in the following cases:- When DRD=YES is specified in SYSIN DD.
- When the data set is not specified on the DD statement.
- When an IMS catalog PSB is processed.
- SYSRDDS
- PSB DEF
- Whether an application program definition that corresponds to the PSB is found in the specified system RDDS.
- PGMTYPE
- The type of application program.
- TP:
- This value specifies that the IMS system schedules the program when messages processed by the program exist in the system.
- BATCH:
- This value specifies that the program can use DL/I in the system region of the IMS control program and can refer to the message queues.
SYSRDDS information is not printed in the following cases:- When DRD=NO is specified in SYSIN DD.
- When the data set is not specified on the DD statement.
- When an IMS catalog PSB is processed.
- NSYSRDDS
- PSB DEF
- Whether an application program definition that corresponds to the PSB is found in the specified non-system RDDS.
- PGMTYPE
- The type of application program.
- TP:
- This value specifies that the IMS system schedules the program when messages processed by the program exist in the system.
- BATCH:
- This value specifies that the program can use DL/I in the system region of the IMS control program and can refer to the message queues.
NSYSRDDS information is not printed in the following cases:- When DRD=NO is specified in SYSIN DD.
- When the data set is not specified on the DD statement.
- When an IMS catalog PSB is processed.
Report field descriptions for the PCB information part
This part contains information about program communication block definitions, and results of the consistency check.
Notes:
- If you define TP PCBs or DB PCBs in a PSB, the TP PCB information part or the DB PCB information part is shown.
- When you specify FAILONLY=YES and PCBERRLMT=nnnn, only the inconsistent PCBs up to nnnn in each PSB will be printed, and no consistent PCBs will be shown in this part.
- TPPCB INFORMATION
The columns of the table in the TP PCB information part are as follows:
- PCB #
- The sequential number of the TP PCBs.
- CHK
- If any inconsistency is detected between each definition and the PSB, *** is printed. Additionally * is shown on the right side of each data that is determined as inconsistent.
- PA
- Identifies whether the information on the right is of PSBLIB,
ACBLIB, or both.
- B:
- The information about PSBLIB and ACBLIB are the same.
- P:
- The information is about PSBLIB.
- A:
- The information is about ACBLIB.
- PSBLIB/ACBLIB
- These columns show the following fields that are found in the
PSB and the ACB:
- LTERM/NAME
- The output message destination.
- PCBNAME (label)
- The name of the PCB or the label for the PCB.
- ALTR: ALTRESP
- Whether the PCB can be used instead of the I/O PCB.
- SAME: SAMETRM
- Whether the IMS system verifies that the logical terminal named in the response alternate PCB is assigned to the same physical terminal as the logical terminal that originated the input message.
- MODI: MODIFY
- Whether the dynamic modification of the destination name is allowed.
- EXPR: EXPRESS
- Whether messages from the PCB are to be sent or are to be backed out when the application program ends abnormally.
- LIST
- Whether the named PCB is included in the PCB list that is passed to the application program at the entry.
- DBPCB INFORMATION
The columns of the table in the DB PCB information part are as follows:
- PCB #
- The sequential number of the DB PCBs.
- CHK
- If any inconsistency is detected between each definition and the PSB, *** is printed. Additionally * is shown on the right side of each data that is determined as inconsistent.
- PA
- Identifies whether the information on the right is of PSBLIB,
ACBLIB, or both.
- B:
- The information about PSBLIB and ACBLIB are the same.
- P:
- The information is about PSBLIB.
- A:
- The information is about ACBLIB.
- PSBLIB/ACBLIB
- These columns show that the following fields are found in the
PSB and the ACB:
- DBDNAME
- DBD name.
- PCBNAME (label)
- The name of the PCB or the label for the PCB.
- SENSEGS
- The number of sensitive segments defined in the PCB.
- KEYLN
- The longest concatenated key length. Note: If the key length of the PCB for a DEDB database that is defined in the ACB is the same as that in the PSB adjusted to the fullword boundary, Consistency Checker regards them as consistent.
- PROCOPT
- The processing options on sensitive segments that are specified
on the PCB statement. Note: Even if PROCOPT=L is specified in a PCB for an HIDAM or a PHIDAM database, Consistency Checker regards it as PROCOPT=LS.
- PROCSEQ(D)
- The name of a secondary index that is used to process a database through a secondary processing sequence.
- VIEW
- Whether applications use MSDB commit view.
- LIST
- Whether the named PCB is included in the PCB list that is passed to the application program at the entry.