InStackArrayDec

This is the declaration and comments associated with InStackArrayDec in the MCP 4.8.1 at 5032500.

PROCEDURE INSTACKARRAYDEC (MOTHER,FIRST_DATA_WORD,LET_IT_BE);            
      VALUE        LET_IT_BE;                                             
      DESCRIPTOR   MOTHER;                                                
      REAL         FIRST_DATA_WORD;                                       
      BOOLEAN      LET_IT_BE;     
      
  DESCRIPTION:                                                         
THE PROCEDURE INSTACKARRAYDEC CREATES AN INSTACK ARRAY. THIS   
IS ACCOMPLISHED BY TOUCHING THE WOULD BE MOM AND FORCING THE    
ADDRESS OF THE AREA DOWN THE THROAT OF ITS ASD. THE OTHER       
FIELDS IN THE ASD ARE ALSO TOUCHED UP.  THE INSTACK ARRAY       
(DESCRIPTOR AND DATA) MUST BE IN THE RUNNING STACK OR THE MCP   
STACK (SNR OR MCPSTACK).                                        
                                                                        
  PARAMETERS:                                                          
1. MOTHER - AN SIRW TO THE MOM.                                 
2. FIRST_DATA_WORD - AN SIRW TO THE FIRST DATA WORD.            
3. LET_IT_BE - TRUE IF THE ARRAY IS TO BE INSTACK AT ALL TIMES. 
                                                                        
  RESULTS:                                                             
THE MOTHER WILL BE A VALID DESCRIPTOR OF A PRESENT AREA THAT    
IS POINTED TO BY THE FIRST_DATA_WORD.                           
                                                                        
  ASSUMPTIONS:                                                         
1. THE FUNNY LINKS AROUND THE INSTACK ARRAY USED TO BE A DATA   
   DESCRIPTOR WITH PCBITSF OF '01' AND ADDRESSF OF MOM_ADDRESS. 
   IT IS NOW A TOUCHED COPY POINTING TO THE ASD SLOT. ONE MORE  
   CLEANUP AREA OR IS IT ALREADY DONE ?                         
   2. THE WORD AT MOTHER CONTAINS A VALID UNTOUCHED DESCRIPTOR.    
   3. THE STACK CELLS IMMEDIATELY BEFORE AND IMMEDIATELY AFTER     
      ARE GARBAGE CELLS THAT CAN BE USED BY INSTACKARRAYDEC FOR    
      THE FUNNY LINKS.                                             
   4. ANY BLOCK THAT CALLS THIS PROCEDURE SHOULD HAVE A TAG 6      
      WORD WITH THE ONE-DIMENSIONAL ARRAY BIT SET AND SHOULD CALL  
      BLOCKEXIT (IF IT IS NOT IN THE MCPSTACK).                    
                                                                        
  SIDE EFFECTS:                                                        
MOTHER WILL BE TOUCHED AND PRESENT ON DEPARTURE.               
 
 LOCKS:                                                              
 NONE.