The following describes the format of a partitioned data set (PDS) directory entry. It is returned in simulated 256-byte blocks when BSAM or QSAM is used to read a PDSE directory entry This format shows the control block on entry to the STOW macro. You can use the IHAPDS macro to map this control block.
| Decimal Offsets | Hex Offsets | Type/Value | Len | Name (Dim) | Description |
|---|---|---|---|---|---|
| 0 | (0) | CHARACTER | 8 | PDS2NAME | - LOAD MODULE MEMBER NAME OR ALIAS |
| 8 | (8) | CHARACTER | 3 | PDS2TTRP | - TTR OF FIRST BLOCK OF NAMED MEMBER |
| 11 | (B) | BITSTRING | 1 | PDS2INDC | - INDICATOR BYTE |
| 1... .... | PDS2ALIS | "BIT0"- NAME IN THE FIRST FIELD IS AN ALIAS | |||
| .11. .... | PDS2NTTR | "BIT1+ BIT2"- NUMBER OF TTR'S IN THE USER DATA FIELD | |||
| ...1 1111 | PDS2LUSR | "BIT3+ BIT4+ BIT5+ BIT6+ BIT7" - LENGTH OF USER DATA FIELD IN HALF WORDS | |||
| 12 | (C) | CHARACTER | 1 | PDS2USRD (0) | - START OF VARIABLE LENGTH USER DATA FIELD |
| 12 | (C) | CHARACTER | 3 | PDS2TTRT | - TTR OF FIRST BLOCK OF TEXT |
| 15 | (F) | CHARACTER | 1 | PDS2ZERO | - ZERO |
| 16 | (10) | CHARACTER | 3 | PDS2TTRN | - TTR OF NOTE LIST OR SCATTER/TRANSLATION TABLE. USED FOR MODULES IN SCATTER LOAD FORMAT OR OVERLAY STRUCTURE ONLY. |
| 19 | (13) | SIGNED | 1 | PDS2NL | - NUMBER OF ENTRIES IN NOTE LIST FOR MODULES IN OVERLAY STRUCTURE |
| 20 | (14) | BITSTRING | 2 | PDS2ATR (0) | - TWO-BYTE MODULE ATTRIBUTE FIELD |
| 20 | (14) | BITSTRING | 1 | PDS2ATR1 | - FIRST BYTE OF MODULE ATTRIBUTE FIELD |
| 1... .... | PDS2RENT | "BIT0"- REENTERABLE | |||
| .1.. .... | PDS2REUS | "BIT1"- REUSABLE | |||
| ..1. .... | PDS2OVLY | "BIT2"- IN OVERLAY STRUCTURE | |||
| ...1 .... | PDS2TEST | "BIT3"- MODULE TO BE TESTED - TESTRAN | |||
| .... 1... | PDS2LOAD | "BIT4"- ONLY LOADABLE | |||
| .... .1.. | PDS2SCTR | "BIT5"- SCATTER FORMAT | |||
| .... ..1. | PDS2EXEC | "BIT6"- EXECUTABLE | |||
| .... ...1 | PDS21BLK | "BIT7"- IF ZERO, MODULE CONTAINS MULTIPLE RECORDS WITH AT LEAST ONE BLOCK OF TEXT. — IF ONE, MODULE CONTAINS NO RLD ITEMS AND ONLY ONE BLOCK OF TEXT. | |||
| 21 | (15) | BITSTRING | 1 | PDS2ATR2 | - SECOND BYTE OF MODULE ATTRIBUTE FIELD |
| 1... .... | PDS2FLVL | "BIT0"- IF ZERO, MODULE CAN BE PROCESSED BY ALL LEVELS OF LINKAGE EDITOR. — IF ONE, MODULE CAN BE PROCESSED ONLY BY F LEVEL OF LINKAGE EDITOR. | |||
| .1.. .... | PDS2ORG0 | "BIT1"- LINKAGE EDITOR ASSIGNED ORIGIN OF FIRST BLOCK OF TEXT IS ZERO. | |||
| ..1. .... | PDS2EP0 | "BIT2"- ENTRY POINT ASSIGNED BY LINKAGE EDITOR IS ZERO | |||
| ...1 .... | PDS2NRLD | "BIT3"- MODULE CONTAINS NO RLD ITEMS | |||
| .... 1... | PDS2NREP | "BIT4"- MODULE CANNOT BE REPROCESSED BY LINKAGE EDITOR | |||
| .... .1.. | PDS2TSTN | "BIT5"- MODULE CONTAINS TESTRAN SYMBOL CARDS | |||
| .... ..1. | PDS2LEF | "BIT6"- MODULE CREATED BY LINKAGE EDITOR F | |||
| .... ...1 | PDS2REFR | "BIT7"- REFRESHABLE MODULE | |||
| 22 | (16) | SIGNED | 3 | PDS2STOR | - TOTAL CONTIGUOUS VIRTUAL STORAGE REQUIREMENT OF MODULE |
| 25 | (19) | SIGNED | 2 | PDS2FTBL | - LENGTH OF FIRST BLOCK OF TEXT |
| 27 | (1B) | ADDRESS | 3 | PDS2EPA | - ENTRY POINT ADDRESS ASSOCIATED WITH MEMBER NAME OR WITH ALIAS NAME IF ALIAS INDICATOR IS ONE |
| 30 | (1E) | ADDRESS | 3 | (0) | - LINKAGE EDITOR ASSIGNED ORIGIN OF FIRST BLOCK OF TEXT (when bit 0 is off) |
| 30 | (1E) | BITSTRING | 3 | PDS2FTBO (0) | - FLAG BYTES (VS/1-VS/2 USE OF FIELD) |
| 30 | (1E) | BITSTRING | 1 | PDS2FTB1 | - BYTE 1 OF PDS2FTBO |
| 1... .... | PDSAOSLE | "BIT0"- MODULE HAS BEEN PROCESSED BY VS/1-VS/2 LINKAGE EDITOR | |||
| .1.. .... | PDS2BIG | "BIT1" THIS MODULE REQUIRES 16M OR MORE OF VIRTUAL STORAGE. | |||
| ..1. .... | PDS2PAGA | "BIT2"- PAGE ALIGNMENT REQUIRED FOR LOAD MODULE | |||
| ...1 .... | PDS2SSI | "BIT3"- SSI INFORMATION PRESENT | |||
| .... 1... | PDSAPFLG | "BIT4"- INFORMATION IN PDSAPF IS VALID | |||
| .... .1.. | PDS2LFMT | "BIT5"- MODULE IS IN PROGRAM OBJECT FORMAT. THE PDS2FTB3 FIELD IS VALID AND CONTAINS ADDITIONAL FLAGS | |||
| .... ..1. | PDS2SIGN | "BIT6" - PROGRAM OBJECT IS SIGNED. | |||
| .... ...1 | PDS2XATR | "BIT7" - PDS2XATTR SECTION PRESENT | |||
| 31 | (1F) | BITSTRING | 1 | PDS2FTB2 | - BYTE 2 OF PDS2FTBO |
| 1... .... | PDS2ALTP | "BIT0:"- ALTERNATE PRIMARY FLAG. INDICATES THE PRIMARY NAME WAS GENERATED BY THE BINDER. | |||
| ...1 .... | PDSLRMOD | "BIT3:"- PROGRAM RESIDENCE MODE (1=RMODE=ANY, 0=RMODE=24) | |||
| .... 11.. | PDSAAMOD | "BIT4+ BIT5"- ALIAS ENTRY POINT ADDRESSING MODE (00=AMODE=24, 10=AMODE=31, 01=AMODE=64, 11=AMODE=ANY) | |||
| .... ..11 | PDSMAMOD | "BIT6+ BIT7"- MAIN ENTRY POINT ADDRESSING MODE (SAME BIT SETTINGS AS PDSAAMOD) | |||
| 32 | (20) | BITSTRING | 1 | PDS2RLDS (0) | NUMBER OF RLD/CONTROL RECORDS WHICH FOLLOW THE FIRST BLOCK OF TEXT |
| 32 | (20) | BITSTRING | 1 | PDS2FTB3 | - BYTE 3 OF PDS2FTBO |
| 1... .... | PDS2NMIG | "BIT0"- THIS PROGRAM OBJECT LOAD MODULE CANNOT BE CONVERTED TO RECORD FORMAT | |||
| .1.. .... | PDS2PRIM | "BIT1"- FETCHOPT PRIME WAS SPECIFIED | |||
| ..1. .... | PDS2PACK | "BIT2"- FETCHOPT PACK WAS SPECIFIED | |||
| X'21' | PDSBCEND | "*"- END OF BASIC SECTION | |||
| X'21' | PDSBCLN | "PDSBCEND-PDS2"- LENGTH OF BASIC SECTION | |||
| THE FOLLOWING SECTION IS FOR LOAD MODULES WITH SCATTER LOAD | |||||
| X'21' | PDSS01 | "*"- START OF SCATTER LOAD SECTION | |||
| 33 | (21) | SIGNED | 2 | PDS2SLSZ | - NUMBER OF BYTES IN SCATTER LIST |
| 35 | (23) | SIGNED | 2 | PDS2TTSZ | - NUMBER OF BYTES IN TRANSLATION TABLE |
| 37 | (25) | CHARACTER | 2 | PDS2ESDT | - IDENTIFICATION OF ESD ITEM (ESDID) OF CONTROL SECTION TO WHICH FIRST BLOCK OF TEXT BELONGS |
| 39 | (27) | CHARACTER | 2 | PDS2ESDC | - IDENTIFICATION OF ESD ITEM (ESDID) OF CONTROL SECTION CONTAINING ENTRY POINT |
| X'29' | PDSS01ND | "*"- END OF SCATTER LOAD SECTION | |||
| X'8' | PDSS01LN | "PDSS01ND-PDSS01"- LENGTH OF SCATTER LOAD SECTION | |||
| THE FOLLOWING SECTION IS FOR LOAD MODULES WITH ALIAS NAMES | |||||
| X'29' | PDSS02 | "*"- START OF ALIAS SECTION | |||
| 41 | (29) | ADDRESS | 3 | PDS2EPM | - ENTRY POINT FOR MEMBER NAME |
| X'29' | DEENTBK | "PDS2EPM"— ALIAS | |||
| 44 | (2C) | CHARACTER | 8 | PDS2MNM | - MEMBER NAME OF LOAD MODULE. WHEN THE FIRST FIELD (PDS2NAME) IS AN ALIAS NAME, THIS FIELD CONTAINS THE ORIGINAL NAME OF THE MEMBER EVEN AFTER THE MEMBER HAS BEEN RENAMED. |
| X'34' | PDSS02ND | "*"- END OF ALIAS SECTION | |||
| X'B' | PDSS02LN | "PDSS02ND-PDSS02"- LENGTH OF ALIAS SECTION | |||
| THE FOLLOWING SECTION IS FOR SSI INFORMATION AND IS ON A HALFWORD BOUNDARY | |||||
| 52 | (34) | SIGNED | 2 | PDSS03 (0) | - FORCE HALFWORD ALIGNMENT FOR SSI SECTION |
| 52 | (34) | CHARACTER | 4 | PDSSSIWD (0) | - SSI INFORMATION WORD |
| 52 | (34) | SIGNED | 1 | PDSCHLVL | - CHANGE LEVEL OF MEMBER |
| 53 | (35) | BITSTRING | 1 | PDSSSIFB | - SSI FLAG BYTE |
| .1.. .... | PDSFORCE | "BIT1"- A FORCE CONTROL CARD WAS USED WHEN EXECUTING THE IHGUAP PROGRAM | |||
| ..1. .... | PDSUSRCH | "BIT2"- A CHANGE WAS MADE TO MEMBER BY THE INSTALLATION, AS OPPOSED TO AN IBM-DISTRIBUTED CHANGE | |||
| ...1 .... | PDSEMFIX | "BIT3"- SET WHEN AN EMERGENCY IBM-AUTHORIZED PROGRAM 'FIX' IS MADE, AS OPPOSED TO CHANGES THAT ARE INCLUDED IN AN IBM-DISTRIBUTED MAINTENANCE PACKAGE | |||
| .... 1... | PDSDEPCH | "BIT4"- A CHANGE MADE TO THE MEMBER IS DEPENDENT UPON A CHANGE MADE TO SOME OTHER MEMBER IN THE SYSTEM | |||
| .... .11. | PDSSYSGN | "BIT5+ BIT6"- FLAGS THAT INDICATE WHETHER OR NOT A CHANGE TO THE MEMBER WILL NECESSITATE A PARTIAL OR COMPLETE REGENERATION OF THE SYSTEM | |||
| .... .... | PDSNOSGN | "X'00'"- NOT CRITICAL FOR SYSTEM GENERATION | |||
| .... ..1. | PDSCMSGN | "BIT6"- MAY REQUIRE COMPLETE REGENERATION | |||
| .... .1.. | PDSPTSGN | "BIT5"- MAY REQUIRE PARTIAL REGENERATION | |||
| .... ...1 | PDSIBMMB | "BIT7"- MEMBER IS SUPPLIED BY IBM® | |||
| 54 | (36) | CHARACTER | 2 | PDSMBRSN | - MEMBER SERIAL NUMBER |
| X'38' | PDSS03ND | "*"- END OF SSI SECTION | |||
| X'4' | PDSS03LN | "PDSS03ND-PDSS03"- LENGTH OF SSI SECTION | |||
| THE FOLLOWING SECTION IS FOR APF INFORMATION | |||||
| X'38' | PDSS04 | "*"- START OF APF SECTION | |||
| 56 | (38) | CHARACTER | 2 | PDSAPF (0) | - PROGRAM AUTHORIZATION FACILITY (APF) FIELD |
| 56 | (38) | SIGNED | 1 | PDSAPFCT | - LENGTH OF PROGRAM AUTHORIZATION CODE (PDSAPFAC) IN BYTES |
| 57 | (39) | CHARACTER | 1 | PDSAPFAC | - PROGRAM AUTHORIZATION CODE |
| X'3A' | PDSS04ND | "*"- END OF APF SECTION | |||
| X'2' | PDSS04LN | "PDSS04ND-PDSS04"- LENGTH OF APF SECTION | |||
| THE FOLLOWING SECTION IS FOR LARGE PROGRAM OBJECTS (LPO) | |||||
| X'3A' | PDSLPO | "*"- START OF LPO SECTION LENGTH | |||
| 58 | (3A) | SIGNED | 1 | PDS2LPOL | - LPO SECTION LENGTH |
| 59 | (3B) | SIGNED | 4 | PDS2VSTR | - VIRTUAL STORAGE REQUIREMENT FOR THIS MODULE |
| 63 | (3F) | SIGNED | 4 | PDS2MEPA | - MAIN ENTRY POINT OFFSET |
| 67 | (43) | SIGNED | 4 | PDS2AEPA | - ALIAS ENTRY POINT OFFSET. ONLY VALID IF THIS IS AN DIRECTORY ENTRY IS FOR AN ALIAS |
| X'47' | PDSLPOND | "*"- END OF LPO SECTION | |||
| X'D' | PDSLPOLN | "PDSLPOND-PDSLPO"- LENGTH OF LPO SECTION | |||
| THE FOLLOWING SECTION IS FOR EXTENDED ATTRIBUTE (PDS2XATTR) | |||||
| X'47' | PDS2XATTR | "*"- START OF EXTENDED ATTRIBUTE SECTION | |||
| 71 | (47) | SIGNED | 1 | PDS2XATTRBYTE0 | - EXTENDED ATTRIBUTE BYTE 0 |
| 1111 .... | - RESERVED | ||||
| X'0F' | PDS2XATTR_OPTN _MASK BIT | - NUMBER OF BYTES (COULD BE 0) STARTING AT PDS2XATTR_OPT | |||
| 72 | (48) | BITSTRING | 1 | PDS2XATTRBYTE1 | - EXTENDED ATTRIBUTE BYTE 1 |
| 1... .... | PDS2LONGPARM | "BIT 0" - PARM > 100 CHARS ALLOWED | |||
| .111 1111 | "BIT1 - BIT7" - RESERVED | ||||
| 73 | (49) | CHARACTER | 1 | - RESERVED | |
| 74 | (4A) | CHARACTER | * | PDS2XATTR_OPT | "*" - START OF OPTIONAL CHARACTERS. NUMBER IS IN PDS2XATTR_OPTN_MASK |