IMS DB – PCB Mask
PCB stands for Program Communication Block. PCB Mask is the second parameter used in the DL/I call. It is declared in the linkage section. Given below is the syntax of a PCB Mask −
01 PCB-NAME. 05 DBD-NAME PIC X(8). 05 SEG-LEVEL PIC XX. 05 STATUS-CODE PIC XX. 05 PROC-OPTIONS PIC X(4). 05 RESERVED-DLI PIC S9(5). 05 SEG-NAME PIC X(8). 05 LENGTH-FB-KEY PIC S9(5). 05 NUMB-SENS-SEGS PIC S9(5). 05 KEY-FB-AREA PIC X(n).
Here are the key points to note −
-
For each database, the DL/I maintains an area of storage that is known as the program communication block. It stores the information about the database that are accessed inside the application programs.
-
The ENTRY statement creates a connection between the PCB masks in the Linkage Section and the PCBs within the program’s PSB. The PCB masks used in a DL/I call tells which database to use for operation.
-
You can assume this is similar to specifying a file name in a COBOL READ statement or a record name in a COBOL write statement. No SELECT, ASSIGN, OPEN, or CLOSE statements are required.
-
After each DL/I call, the DL/I stores a status code in the PCB and the program can use that code to determine whether the call succeeded or failed.
PCB Name
Points to note −
-
PCB Name is the name of the area which refers to the entire structure of the PCB fields.
-
PCB Name is used in program statements.
-
PCB Name is not a field in the PCB.
DBD Name
Points to note −
-
DBD name contains the character data. It is eight bytes long.
-
The first field in the PCB is the name of the database being processed and it provides the DBD name from the library of database descriptions associated with a particular database.
Segment Level
Points to note −
-
Segment level is known as Segment Hierarchy Level Indicator. It contains character data and is two bytes long.
-
A segment level field stores the level of the segment that was processed. When a segment is retrieved successfully, the level number of the retrieved segment is stored here.
-
A segment level field never has a value greater than 15 because that is the maximum number of levels permitted in a DL/I database.
Status Code
Points to note −
-
Status code field contains two bytes of character data.
-
Status code contains the DL/I status code.
-
Spaces are moved to the status code field when DL/I completes the processing of calls successfully.
-
Non-space values indicate that the call was not successful.
-
Status code GB indicates end-of-file and status code GE indicates that the requested segment is not found.
Proc Options
Points to note −
-
Proc options are known as processing options which contain four-character data fields.
-
A Processing Option field indicates what kind of processing the program is authorized to do on the database.
Reserved DL/I
Points to note −
-
Reserved DL/I is known as the reserved area of the IMS. It stores four bytes binary data.
-
IMS uses this area for its own internal linkage related to an application program.
Segment Name
Points to note −
-
SEG Name is known as segment name feedback area. It contains 8 bytes of character data.
-
The name of the segment is stored in this field after each DL/I call.
Length FB Key
Points to note −
-
Length FB key is known as the length of the key feedback area. It stores four bytes of binary data.
-
This field is used to report the length of the concatenated key of the lowest level segment processed during the previous call.
-
It is used with the key feedback area.
Number of Sensitivity Segments
Points to note −
-
Number of sensitivity segments store four bytes binary data.
-
It defines to which level an application program is sensitive. It represents a count of number of segments in the logical data structure.
Key Feedback Area
Points to note −
-
Key feedback area varies in length from one PCB to another.
-
It contains the longest possible concatenated key that can be used with the program’s view of the database.
-
After a database operation, DL/I returns the concatenated key of the lowest level segment processed in this field, and it returns the length of the key in the key length feedback area.