JXI      TITLE '    IHEJXI    INDEXER FOR INTERLEAVED ARRAYS.          *00400013
               OS/360 PL/I LIBRARY'                                     00800013
*   VERSION    FOURTH VERSION OF F-LEVEL PL/1 COMPILER                  01200015
*                                                                       01600013
*   STATUS     CHANGE LEVEL - 0.                                        02000013
*                                                                       02400013
*   SIZE       320 BYTES                                                02800015
*                                                                       03200013
*   FUNCTION   TO LOCATE THE ELEMENTS OF AN ARRAY.                      03600013
*              SEE OS/360 PL/I LIBRARY - COMPUTATIONAL SUBROUTINES,     04000013
*              FORM C28-6590, FOR DESCRIPTION OF METHOD.                04400013
*                                                                       04800013
*   ENTRY POINTS                                                        05200013
*              IHEJXII - INITIALISE TO GIVE BIT ADDRESSES, AND LOCATE   05600013
*               THE FIRST ELEMENT OF THE ARRAY, AND                     06000013
*              IHEJXIY - AS IHEJXII BUT BYTE ADDRESSES.                 06400013
*                  RA = A(ARRAY DOPE VECTOR)                            06800013
*                  RB = A(NO. OF DIMENSIONS).                           07200013
*              IHEJXIA - TO LOCATE THE NEXT ELEMENT OF THE ARRAY.       07600013
*                  (NO EXPLICIT ARGUMENTS).                             08000013
*                                                                       08400013
*   INPUT      IHEJXIA - REGISTERS STORED IN LIBRARY COMMUNICATIONS     08800013
*               AREA.   VDA USED AS WORKSPACE.                          09200013
*                                                                       09600013
*   OUTPUT     REGISTER RA CONTAINS ADDRESS OF CURRENT ELEMENT.         10000013
*              WORKING REGISTERS ARE STORED IN LCA.                     10400013
*              VDA USED AS WORKSPACE.                                   10800013
*                                                                       11200013
*   EXTERNAL MODULES                                                    11600013
*              IHESAD - GET VDA.                                        12000013
*              IHESAF - FREE VDA                                        12400013
*                                                                       12800013
*   EXITS      NORMAL - RETURN TO CALLER VIA LINK REGISTER,             13200013
*               REGISTER BR = 0.                                        13600013
*              FINAL - WHEN THE ADDRESS OF THE LAST ELEMENT WAS         14000013
*               PROVIDED ON THE PREVIOUS NORMAL RETURN.                 14400013
*               RETURN TO CALLER VIA LINK REGISTER, REGISTER BR = 4.    14800013
*                                                                       15200013
*   TABLES/WORK-AREA                                                    15600013
*              SEE OS/360 PL/I LIBRARY PLM FOR DESCRIPTION OF LCA AND   16000013
*              VDA.                                                     16400013
*              WORK-AREA IS OBTAINED FROM DYNAMIC STORAGE - LWS AND VDA 16800013
*                                                                       17200013
*   ATTRIBUTES  READ-ONLY AND REENTRANT, SERIALLY REUSEABLE FOR A GIVEN 17600013
*               TASK.                                                   18000013
*                                                                       18400013
*   PRIVATE MACROS                                                      18800013
*              IHELIB,IHEPRV,IHESDR                                     19200013
*                                                                       19600013
*   ASSEMBLY REQUIREMENTS                                               20000013
*              MUST BE ASSEMBLED BY AN ASSEMBLER WITH PSEUDO-REGISTER   20400013
*              SUPPORT E.G. O/S 360 F-ASSEMBLER.                        20800013
*                                                                       21200013
*   NOTES      SEE OS/360 PL/I LIBRARY PLM FOR LIBRARY CONVENTIONS AND  21600013
*              STANDARDS.                                               22000013
*              THE OPERATION OF THIS MODULE DOES NOT DEPEND UPON        22400013
*              A PARTICULAR INTERNAL REPRESENTATION OF THE              22800013
*              EXTERNAL CHARACTER SET.                                  23200013
*              THE OPERATION OF THIS MODULE DOES NOT DEPEND ON THE      23600013
*              ATMOSPHERIC PRESSURE.                                    24000013
         EJECT                                                          24400013
IHEJXI   CSECT                                                          24800013
           SPACE 2                                                      25200013
         IHELIB                                                         25600013
*                                  PRIVATE REGISTER ASSIGNMENTS.        26000013
         SPACE                                                          26400013
CAD      EQU   RA                                                       26800013
RUL      EQU   RB                                                       27200013
MPR      EQU   RB                                                       27600013
ADV      EQU   RC                                                       28000013
K04      EQU   RD                  K04 AND VN4 MUST BE AN EVEN-ODD PAIR 28400013
SCR      EQU   RD                                                       28800013
VN4      EQU   RE                                                       29200013
BAS      EQU   RF                                                       29600013
WSP      EQU   RG                                                       30000013
DMB      EQU   RH                                                       30400013
DMR      EQU   RI                                                       30800013
DMV      EQU   RJ                                                       31200013
XRI      EQU   RX                                                       31600013
XRB      EQU   RX                                                       32000013
NDM      EQU   RX                                                       32400013
XRA      EQU   BR                                                       32800013
         SPACE 2                                                        33200013
*                                  PRIVATE OFFSETS IN LIBRARY           33600013
*                                  COMMUNICATIONS AREA.                 34000013
         SPACE                                                          34400013
OPRA     EQU   OFC1                                                     34800013
OPRC     EQU   OPRA+8                                                   35200013
OPRH     EQU   OPRA+28                                                  35600013
         EJECT                                                          36000013
IHEJXI   CSECT                                                          36400013
         ENTRY IHEJXII                                                  36800013
         ENTRY IHEJXIY                                                  37200013
         ENTRY IHEJXIA                                                  37600013
         SPACE                                                          38000013
*                             ***************************************** 38400013
*                             * INITIALISATION TO GIVE BIT ADDRESSES  * 38800013
*                             ***************************************** 39200013
         SPACE                                                          39600013
IHEJXII  NOPR  0                                                        40000013
         SPACE 2                                                        40400013
*                             ***************************************** 40800013
*                             * INITIALISATION TO GIVE BYTE ADDRESSES * 41200013
*                             ***************************************** 41600013
         SPACE                                                          42000013
IHEJXIY  STM   LR,RX,OFLR(DR)                                           42400013
         LR    WSP,DR              SAVE SAVE AREA POINTER.              42800013
         LR    DMR,LR              SAVE LINK REG.                       43200013
         IHESDR LW1,RE                                                  43600013
         L     CAD,0(RA)           PICK UP ADDRESS OF ARRAY ORIGIN.     44000013
         BALR  BAS,0                                                    44400013
         USING *,BAS               SET BASE REG FOR REST OF PROGRAM.    44800013
         TM    OFBR+3(WSP),X'02'   WHICH ENTRY POINT.                   45200013
         BO    TC010               BRANCH IF IHEJXIY.                   45600013
         SPACE                                                          46000013
         SR    R0,R0               FORM BIT ADDRESS OF ORIGIN.          46400013
         SLDL  R0,3                                                     46800013
         OR    CAD,R0                                                   47200013
         SPACE                                                          47600013
TC010    L     NDM,0(RB)           PICK UP NO. OF DIMENSIONS = N.       48000013
         LA    VN4,0(NDM,NDM)                                           48400013
         AR    VN4,VN4             VN4=4* NO. OF DIMENSIONS = 4N.       48800013
         SPACE                                                          49200013
         LR    SCR,RA              SAVE RA.                             49600013
         LA    R0,8(VN4,VN4)       R0=8N+8.                             50000013
         AR    R0,VN4              R0=12N+8.                            50400013
         IHEPRV VDA,BR                                                  50800015
         BALR  LR,BR               GET VDA.                             51200013
         SPACE                                                          51600013
         LR    LR,DMR              RESTORE LR.                          52000013
         LR    DMR,RA              SET UP REGS TO ADDRESS PARTS OF THE  52400013
         LA    DMV,0(DMR,VN4)       VDA. (NB. CANNOT USE 1ST 8 BYTES).  52800013
         LA    DMB,0(DMV,VN4)                                           53200013
         SPACE                                                          53600013
         LR    RA,SCR              RESTORE RA.                          54000013
         SR    XRA,XRA                                                  54400013
         L     ADV,OFRA(WSP)       RELOAD ADDRESS OF ARRAY DOPE VECTOR. 54800013
TC020    LA    ADV,4(ADV)          CALCULATE THE ADDRESS OF THE FIRST   55200013
         L     MPR,0(ADV)           ELEMENT OF THE ARRAY =              55600013
         MH    MPR,2(ADV,VN4)       A(ORIGIN)+SIGMA(LBOUND*MULTIPLIER). 56000013
         AR    CAD,MPR                                                  56400013
         LH    SCR,0(ADV,VN4)      MEANWHILE, CALCULATE DIMENSION       56800013
         LH    MPR,2(ADV,VN4)       EXTENTS (=HBOUND-LBOUND+1) AND      57200013
         BCTR  MPR,0                INITIALISE SUBSCRIPT COUNTS.        57600013
         SR    SCR,MPR                                                  58000013
         ST    SCR,8(DMR,XRA)                                           58400013
         ST    SCR,8(DMV,XRA)                                           58800013
         LA    XRA,4(XRA)                                               59200013
         BCT   NDM,TC020           LOOP N TIMES.                        59600013
         SPACE                                                          60000013
         L     XRB,OFRB(WSP)       SET XRB = NO. OF DIMENSIONS.         60400013
         L     XRB,0(XRB)                                               60800013
         SR    XRA,XRA                                                  61200013
TC030    ST    CAD,8(DMB,XRA)      SET BASE ADDRESS FOR ALL DIMENSIONS  61600013
         LA    XRA,4(XRA)           EQUAL TO THE ADDRESS OF THE FIRST   62000013
         BCT   XRB,TC030            ELEMENT OF THE ARRAY.               62400013
         SPACE                                                          62800013
         LA    K04,4               K04 = 4.                             63200013
         SR    VN4,K04             VN4 = 4*N-1.                         63600013
         L     ADV,OFRA(WSP)       RELOAD A(ADV).                       64000013
         IHEPRV LCA,WSP,OP=L                                            64400013
         STM   RC,RJ,OPRC(WSP)     SAVE CONSTANT REGS FOR LATER ENTRIES 64800013
         SPACE                                                          65200013
TC050    L     RUL,8(DMR,VN4)      SET COUNT TO LOOP THROUGH NTH DIM.   65600013
TC060    STM   RA,RB,OPRA(WSP)     STORE NEW VALUES OF CAD AND RUL.     66000013
         L     DR,OFDR(DR)                                              66400013
         LM    RB,RX,OFRB(DR)                                           66800013
         SR    BR,BR               SET RETURN CODE - NORMAL RETURN.     67200013
         MVI   OFLR(DR),X'FF'                                           67600013
         BCR   15,LR               RETURN TO CALLING PROGRAM.           68000013
         EJECT                                                          68400013
*                             ***************************************** 68800013
*                             * TO LOCATE ELEMENTS AFTER THE FIRST ONE* 69200013
*                             ***************************************** 69600013
         SPACE                                                          70000013
IHEJXIA  STM   LR,RX,OFLR(DR)                                           70400013
         IHESDR LW1,WSP                                                 70800013
         IHEPRV LCA,WSP,OP=L                                            71200013
         LM    RA,RF,OPRA(WSP)     RESTORE SOME OF THE WORKING REGS.    71600013
         A     CAD,4(VN4,ADV)      ADD NTH DIM. MULTIPLIER TO GIVE NEXT 72000013
         BCT   RUL,TC060            ADDR. UNTIL COUNT REDUCED TO ZERO.  72400013
         SPACE                                                          72800013
         LTR   VN4,VN4             OUT IF ONE DIMENSIONAL ARRAY.        73200013
         BC    12,TC100                                                 73600013
         SPACE                                                          74000013
         LM    RH,RJ,OPRH(WSP)     RESTORE REMAINDER OF WORKING REGS.   74400013
         LR    XRI,VN4             I=N-1                                74800013
TC070    L     RUL,4(DMV,XRI)      REDUCE ITH DIM. COUNT BY 1.          75200013
         SH    RUL,H001                                                 75600013
         ST    RUL,4(DMV,XRI)                                           76000013
         BC    2,TC080             IS ITH DIM. COUNT NOW ZERO.          76400013
         SPACE                                                          76800013
         L     RUL,4(DMR,XRI)      YES. RESET VALUE.                    77200013
         ST    RUL,4(DMV,XRI)                                           77600013
         SR    XRI,K04             I=I-1                                78000013
         BC    12,TC100            END OF ARRAY IF WE HAVE BEEN THROUGH 78400013
         BC    15,TC070             THE RANGE OF THE FIRST DIM..        78800013
         SPACE                                                          79200013
TC080    L     CAD,4(DMB,XRI)      PICK UP PREVIOUS BASE FOR ITH DIM    79600013
         A     CAD,0(ADV,XRI)       AND ADD ITH DIM MULTIPLIER.         80000013
TC090    ST    CAD,4(DMB,XRI)      SAVE NEW BASE FOR ITH DIM AND ALL    80400013
         BXLE  XRI,K04,TC090        HIGHER NUMBERED (INNER) DIMENSIONS. 80800013
         BC    15,TC050                                                 81200013
         SPACE                                                          81600013
TC100    LR    SCR,LR              SAVE LR.                             82000013
         IHEPRV FVD,BR                                                  82400015
         BALR  LR,BR               FREE VDA.                            82800013
         LR    LR,SCR              RESTORE LR.                          83200013
         L     DR,OFDR(DR)         RESTORE SAVE AREA POINTER.           83600013
         LM    RB,RX,OFRB(DR)      RESTORE CALLER'S REGS.               84000013
         LA    BR,4                SET RETURN CODE = 4.                 84400013
         MVI   OFLR(DR),X'FF'                                           84800013
         BR    LR                  FINAL RETURN TO CALLER.              85200013
         EJECT                                                          85600013
H001     DC    H'1'                                                     86000013
         END                                                            87200013
