DVU      TITLE '   IHEDVU    COMPLEX BINARY FIXED ''DIVIDE'' FUNCTION  *00020000
               OS/360 PL/I LIBRARY'                                     00040000
*   VERSION    SECOND VERSION OF F-LEVEL PL/1 COMPILER                  00060000
*                                                                       00080000
*   STATUS     CHANGE LEVEL - 0.                                        00100000
*                                                                       00120000
*   SIZE       408 BYTES                                                00140000
*                                                                       00160000
*   FUNCTION   DIVIDE(W,Z,P,Q) WHERE W AND Z ARE FIXED BINARY COMPLEX   00180000
*              AND (P,Q) IS THE TARGET PRECISION.                       00200000
*              LET Z1 = A+BI AND Z2 = C+DI, THEN                        00220000
*               REAL(Z1/Z2) = (A*C + B*D)/(C**2 + D**2)                 00240000
*               IMAG(Z1/Z2) = (B*C - A*D)/(C**2 + D**2)                 00260000
*              THE EXPRESSIONS A*C + B*D, B*C - A*D, AND C**2 + D**2    00280000
*              ARE COMPUTED TO 63 BITS IN REGISTER PAIRS. THE           00300000
*              DENOMINATOR C**2 + D**2 IS SHIFTED TO 31 SIGNIFICANT     00320000
*              BITS BY EITHER A RIGHT OR LEFT SHIFT.                    00340000
*              TWO CALLS ARE THEN MADE TO AN INCORPORATED SUBROUTINE    00360000
*              WHICH ACCEPTS A NUMERATOR AND SHIFTS IT SO THAT IT HAS   00380000
*              TWO INSIGNIFICANT LEADING DIGITS. IT THEN DIVIDES BY     00400000
*              C**2 + D**2 AND SHIFTS THE QUOTIENT TO THE REQUIRED      00420000
*              SCALE FACTOR (Q).                                        00440000
*                                                                       00460000
*   ENTRY POINTS                                                        00480000
*              IHEDVU0                                                  00500000
*                  RA = A(PLIST)                                        00520000
*                  PLIST = A(W)                                         00540000
*                          A(DED FOR W)                                 00560000
*                          A(Z)                                         00580000
*                          A(DED FOR Z)                                 00600000
*                          A(TARGET)                                    00620000
*                          A(DED FOR TARGET)                            00640000
*                                                                       00660000
*   INPUT      N/A                                                      00680000
*                                                                       00700000
*   OUTPUT     N/A                                                      00720000
*                                                                       00740000
*   EXTERNAL MODULES                                                    00760000
*              N/A                                                      00780000
*                                                                       00800000
*   EXITS      NORMAL                                                   00820000
*               RETURN TO CALLER VIA LINK REGISTER.                     00840000
*                                                                       00860000
*   TABLES/WORK-AREA                                                    00880000
*              WORK-AREA IS OBTAINED FROM DYNAMIC STORAGE (LWS).        00900000
*                                                                       00920000
*   ATTRIBUTES  READ-ONLY AND REENTRANT.                                00940000
*                                                                       00960000
*   PRIVATE MACROS                                                      00980000
*              IHELIB,IHESDR                                            01000000
*                                                                       01020000
*   ASSEMBLY REQUIREMENTS                                               01040000
*              MUST BE ASSEMBLED BY AN ASSEMBLER WITH PSEUDO-REGISTER   01060000
*              SUPPORT E.G. O/S 360 F-ASSEMBLER.                        01080000
*                                                                       01100000
*   NOTES      SEE OS/360 PL/I LIBRARY PLM FOR LIBRARY CONVENTIONS AND  01120000
*              STANDARDS.                                               01140000
*              THE OPERATION OF THIS MODULE DOES NOT DEPEND UPON        01160000
*              A PARTICULAR INTERNAL REPRESENTATION OF THE              01180000
*              EXTERNAL CHARACTER SET.                                  01200000
 EJECT                                                                  01220000
IHEDVU   CSECT                                                          01240000
 SPACE 2                                                                01260000
         IHELIB                                                         01280000
*              PRIVATE REGISTER ASSIGNMENTS                             01300000
 SPACE                                                                  01320000
SCR      EQU   R0                                                       01340000
ZEV      EQU   R0                  EVEN/ODD                             01360000
ZOD      EQU   RA                   PAIR                                01380000
INC      EQU   RA                                                       01400000
SFT      EQU   RA                                                       01420000
SHF      EQU   RA                                                       01440000
DED      EQU   RB                                                       01460000
TAR      EQU   RB                                                       01480000
CNT      EQU   RD                                                       01500000
PRM      EQU   RE                                                       01520000
PSH      EQU   RE                                                       01540000
XEV      EQU   RF                  EVEN/ODD                             01560000
XOD      EQU   RG                   PAIR                                01580000
YEV      EQU   RH                  EVEN/ODD                             01600000
YOD      EQU   RI                   PAIR                                01620000
LNK      EQU   RJ                                                       01640000
WORK     DSECT                                                          01645001
         DS    18F                                                      01650001
SAVEN    DS    F                                                        01655001
 EJECT                                                                  01660000
IHEDVU   CSECT                                                          01680000
 SPACE                                                                  01700000
*   ENTRY POINTS                                                        01720000
 SPACE                                                                  01740000
         ENTRY IHEDVU0                                                  01760000
 SPACE                                                                  01780000
         USING *,BR                                                     01800000
IHEDVU0  STM   LR,WR,OFLR(DR)      SAVE CALLERS REGISTERS               01820000
         IHESDR LW0,RB                                                  01840000
         LR    PRM,RA              SAVE A(PLIST) IN PRM                 01860000
         USING WORK,DR                                                  01865001
         L     RA,20(PRM)               GET A(TARGET DED)               01870001
         ST    RA,SAVEN                 AND SAVE IT FOR LATER USE       01875001
 SPACE                                                                  01880000
*  LET 1ST AND 2ND ARGUMENTS BE Z1 = A+IB AND Z2 = C+ID RESPECTIVELY,   01900000
*  THEN (A+IB)/(C+ID) = (A*C+B*D)/(C**2+D**2) + I(B*C-A*D)/(C**2+D**2)  01920000
 SPACE                                                                  01940000
         LM    RA,RD,0(PRM)          A(Z1) IN RA, A(Z1 DED) IN RB       01947001
*                                    A(Z2) IN RC, A(Z2 DED) IN RD       01954001
         TM    0(RB),X'10'           TEST Z1 FOR HALFWORD               01961001
         BO    LOADHZ1               BRANCH IF IT IS                    01968001
         LM    RA,RB,0(RA)           A AND B TO REGS RA AND RB          01975001
         B     TESTZ2                                                   01982001
LOADHZ1  LH    RB,2(RA)              RB=B                               01989001
         LH    RA,0(RA)              RA=A                               01996001
TESTZ2   TM    0(RD),X'10'           TEST Z2 FOR HALFWORD               02003001
         BO    LOADHZ2               BRANCH IF IT IS                    02010001
         LM    RC,RD,0(RC)           C AND D TO REGS RC AND RD          02017001
         B     SKIP                                                     02024001
LOADHZ2  LH    RD,2(RC)              RD=D                               02031001
         LH    RC,0(RC)              RC=C                               02038001
SKIP     LR    XOD,RC                                                   02045001
         MR    XEV,RA              A*C                                  02060000
         LCR   YOD,RD              -D                                   02080000
         MR    YEV,RB              -B*D                                 02100000
         SLR   XOD,YOD             SIGN HAS BEEN REVERSED IN ORDER TO   02120000
         BC    3,SKIPX              USE BCTR INSTRUCTION TO             02140000
         BCTR  XEV,0                PERFORM CARRY OUT OF LOW 32 BITS    02160000
SKIPX    SR    XEV,YEV                                                  02180000
 SPACE                                                                  02200000
*        REGISTER PAIR X CONTAINS 64 BIT A*C + B*D                      02220000
 SPACE                                                                  02240000
         LR    YOD,RC                                                   02260000
         MR    YEV,RB              B*C                                  02280000
         MR    ZEV,RD              A*D                                  02300000
         SLR   YOD,ZOD                                                  02320000
         BC    3,SKIPY                                                  02340000
         BCTR  YEV,0               CARRY                                02360000
SKIPY    SR    YEV,ZEV                                                  02380000
 SPACE                                                                  02400000
*        REGISTER PAIR Y CONTAINS 64 BIT B*C - A*D                      02420000
 SPACE                                                                  02440000
         LCR   RA,RD               -D                                   02460000
         MR    R0,RD               -D*D                                 02480000
         MR    RB,RC               C*C                                  02500000
         SLR   RC,RA                                                    02520000
         BC    3,SKIPC                                                  02540000
         BCTR  RB,0                CARRY                                02560000
SKIPC    SR    CNT,CNT                                                  02580000
         SR    RB,R0                                                    02600000
 SPACE                                                                  02620000
*        REGISTER PAIR RB/RC CONTAINS 64 BIT C*C + D*D                  02640000
 SPACE                                                                  02660000
         BNZ   TEST4               BRANCH TO TEST4 IF C*C + D*D HAS     02680000
*                                   MORE THAN 32 BITS                   02700000
         LTR   RC,RC               TEST C*C + D*D AND BRANCH PAST       02720000
         BZ    SHFOV                SHIFT IF ZERO AND BRANCH TO SHDEN   02740000
         BP    SHDEN                IF NON-ZERO AND LESS THAN 32 BITS   02760000
         SRL   RC,1                IF IT HAS 32, SHIFT RIGHT 1          02780000
         LA    CNT,1               SET SHIFT COUNT TO 1                 02800000
         B     SHFOV                                                    02820000
SHFT4    LA    CNT,4(CNT)          INCREMENT COUNT AND SHIFT C*C + D*D  02840000
         SRDL  RB,4                 RIGHT 4 MORE BITS,                  02860000
TEST4    LH    INC,HM16             IF OVERFLOW FROM                    02880000
         NR    INC,RB               LOW REGISTER MORE THAN              02900000
         BNZ   SHFT4                4 BITS.                             02920000
         IC    INC,SHFT(RB)        IF LESS THAN 4 BITS,                 02940000
         AR    CNT,INC              LOOK UP SHIFT TABLE                 02960000
         SRDL  RB,0(INC)                                                02980000
         B     SHFOV                                                    03000000
SHDEN    BALR  RA,0                SAVE PROGRAM MASK                    03020000
         SPM   CNT                 MASK OFF FIXEDOVERFLOW INTERRUPT     03040000
SDENL    SLA   RC,1                IF C*C + D*D LESS THAN 31            03060000
         BCTR  CNT,0                SIGNIFICANT BITS, SHIFT LEFT UNTIL  03080000
         BNO   SDENL                OVERFLOW OCCURS                     03100000
         AH    CNT,HONE            WHEN OVERFLOW OCCURS, BUMP CNT BY    03120000
         SRA   RC,1                 ONE AND SHIFT RIGHT ONE AND RESTORE 03140000
         O     RC,INST              LOST 1 BIT                          03160000
         SPM   RA                  RESTORE PROGRAM MASK                 03180000
 SPACE                                                                  03200000
*        C*C + D*D HAS NOW BEEN LEFT ADJUSTED IN RC BY SHIFT IN CNT     03220000
 EJECT                                                                  03240000
SHFOV    L     DED,4(PRM)          ADDRESS OF DED OF Z1 TO DED          03260000
         SR    SFT,SFT                                                  03280000
         IC    SFT,2(DED)          SCALE FACTOR OF Z1 TO SFT            03300000
         LA    CNT,128(CNT,SFT)    USING THE NECESSARY DEDS             03320000
         L     DED,12(PRM)          SET CONTENTS OF                     03340000
         IC    SFT,2(DED)           CNT = RIGHT SHIFT OF DENOMINATOR    03360000
         SR    CNT,SFT                    + 128                         03380000
         L     DED,20(PRM)                + SCALE FACTOR OF Z1          03400000
         IC    SFT,2(DED)                 - SCALE FACTOR OF Z2          03420000
         SR    CNT,SFT                    - SCALE FACTOR OF TARGET      03440000
         L     TAR,16(PRM)         ADDRESS OF TARGET TO TAR             03460000
         LA    BR,SBRTN            BRANCH TO SUBROUTINE TO COMPUTE      03480000
         BALR  LNK,BR               REAL PART OF ANSWER AND ASSIGN IT   03500000
*                                   TO THE TARGET                       03520000
         USING *,LNK                                                    03540000
         LR    XEV,YEV             NUMERATOR OF IMAGINARY PART          03560000
         LR    XOD,YOD              TO XEV AND XOD                      03580000
         L     RX,SAVEN                 RX = A(TARGET DED).             03590001
         TM    0(RX),X'10'           TEST FOR HALFWORD TARGET           03600001
         BO    HINC                  BRANCH IF IT IS                    03610001
         LA    TAR,4(TAR)            TAR=A(IMAGINARY PART OF ANSWER)    03620001
         B     COMP                                                     03630001
HINC     LA    TAR,2(TAR)                                               03640001
COMP     LA    BR,SBRTN              BRANCH TO SUBROUTINE TO COMPUTE    03650001
         BALR  LNK,BR               IMAGINARY PART OF ANSWER AND ASSIGN 03660000
*                                   IT TO THE TARGET                    03680000
         L     DR,OFDR(DR)                                              03700000
         LM    RB,RX,OFRB(DR)           RESTORE REGISTERS               03720001
         MVI   OFLR(DR),X'FF'                                           03740000
         BR    LR                  RETURN TO CALLER                     03760000
 EJECT                                                                  03780000
*        SUBROUTINE TO PERFORM DIVISION AND ASSIGN RESULT TO A TARGET   03800000
 SPACE                                                                  03820000
         USING *,BR                                                     03840000
SBRTN    SRDA  XEV,0               TEST FOR ZERO NUMERATOR              03860000
         BZ    DVIDE                AND BRANCH TO DIVIDE IF ZERO        03880000
         LR    SHF,CNT                                                  03900000
 SPACE                                                                  03920000
*        SHIFT NUMERATOR UNTIL HIGH ORDER BIT IS IN BIT POSITION 3 IN   03940000
*        XEV SO THAT DIVISION BY LEFT ADJUSTED NUMBER IN RC WILL GIVE   03960000
*        MOST ACCURATE QUOTIENT AVOIDING FIXED-POINT DIVIDE INTERRUPT   03980000
 SPACE                                                                  04000000
LSHF4    LPR   SCR,XEV                                                  04020000
         C     SCR,TSTB            SHIFT NUMERATOR LEFT 4 BITS AT A     04040000
         BH    LSHF1                TIME UNTIL HIGH ORDER BIT IS        04060000
X04M2    SLDA  XEV,4                BETWEEN BIT POSITIONS 4 TO 7        04080000
         AH    SHF,HFOR                                                 04100000
         B     LSHF4                                                    04120000
LSHF1    LPR   SCR,XEV             SHIFT NUMERATOR LEFT 1 BIT AT A      04140000
         C     SCR,TSTA             TIME UNTIL HIGH ORDER BIT IS        04160000
         BH    TSTRT                IN BIT POSITION 3                   04180000
         SLDA  XEV,1                                                    04200000
         AH    SHF,HONE                                                 04220000
         B     LSHF1                                                    04240000
TSTRT    LPR   SCR,XEV             TEST IF HIGH ORDER BIT WAS HIGHER    04260000
         C     SCR,TSTC             THAN BIT POSITION 3. IF SO SHIFT    04280000
         BNH   DVIDE                RIGHT UNTIL IT IS IN THAT POSITION  04300000
         SRDA  XEV,1                                                    04320000
         BCTR  SHF,0                                                    04340000
         B     TSTRT                                                    04360000
DVIDE    DR    XEV,RC              DIVIDE BY C*C + D*D                  04380000
         LPR   PSH,SHF             POSITIVE SHIFT TO PSH                04400000
         BZ    STORE               BRANCH IF NO SHIFT                   04420000
         CH    PSH,H063                                                 04440000
         BNH   TSTSN               IF MAGNITUDE OF SHIFT GT 63,         04460000
X63M2    LA    PSH,63               SET TO 63                           04480000
TSTSN    LTR   SHF,SHF             TEST SIGN OF SHIFT                   04500000
         BP    RSHFT               BRANCH IF PLUS (RIGHT SHIFT)         04520000
         SLA   XOD,0(PSH)          SHIFT LEFT                           04540000
         B     STORE                                                    04560000
RSHFT    LPR   XEV,XOD             FOR RIGHT SHIFT, FIRST MAKE          04580000
         SRA   XEV,0(PSH)           QUOTIENT POSITIVE BEFORE SHIFT      04600000
         LTR   XOD,XOD              AND RESTORE SIGN AFTER SHIFT        04620000
         BM    LDMIN                                                    04640000
         LCR   XEV,XEV                                                  04660000
LDMIN    LCR   XOD,XEV                                                  04680000
STORE    L     RX,SAVEN                 RX=A(TARGET DED)                04683001
*                                  ADDR OF FIRST FREE CORE BLOCK        04686001
*                                  AVAILABLE FOR GETMAIN PARM LIST      04689001
         TM    0(RX),X'10'           TEST TARGET FOR HALFWORD           04694001
         BO    STORH                 BRANCH IF IT IS                    04701001
         ST    XOD,0(TAR)            STORE FULLWORD RESULT              04708001
         BR    LNK                   RETURN                             04715001
STORH    STH   XOD,0(TAR)            STORE HALFWORD RESULT              04722001
         BR    LNK                                                      04729001
 EJECT                                                                  04740000
*              CONSTANTS                                                04760000
 SPACE                                                                  04780000
HFOR     EQU   X04M2+2                                                  04800000
H063     EQU   X63M2+2                                                  04820000
HM16     DC    H'-16'                                                   04840000
HONE     DC    H'1'                                                     04860000
         DS    0F                                                       04880000
TSTA     DC    X'0FFFFFFF'                                              04900000
TSTB     DC    X'00FFFFFF'                                              04920000
TSTC     DC    X'1FFFFFFF'                                              04940000
INST     DC    X'40000000'                                              04960000
SHFT     DC    X'0002030304040404'                                      04980000
         DC    X'0505050505050505'                                      05000000
 SPACE 4                                                                05020000
         END                                                            05040000
