The OSMOSiS COMMON Area definition  
Previous  Top  Next

Description  
 
When creating Basic subroutines, there are several routines that are available to assist in the integration of these routines with OSMOSiS. There are several INCLUDE routines that could be useful, which reside in the file MV_INCL, a Q-Pointer to the file INCLUDE in the 'account' CAP8.  

Two of the includes are to give access to the OSMOSiS area, these are:  
 
·"NC.COMMON99" - the declarations use with programs, as it does initialise the Common.     
·"NC.COMMON" - the declarations used with sub-routines, as it does NOT initialise the Common.     
 
The COMMON block has many areas available to the developer for their specific use. There are also variables that will contain data created by OSMOSiS that can be made use of by the developer. There are areas, if the developer is very careful, that can be amended for the developer's own purposes to manipulate OSMOSiS processing.  
 
If a VB process accesses the COMMON, the variables are referred to by their index position within the area. The index is 0 to 1510, and to assist we have put the index position in the following list.  
 
There are many variables that are exclusively reserved for the developer's use, where the variable says "Available for the developer".  
 
A complete list of the COMMON area can be viewed.  
 
document Remarks  
 
There are COMMON variables that have particular significance for developers:  
 
·PORT - the general information of this port and the logon process.     
·CONTROL - the control record details     
·ITEMDET - the parameters of the field being processed on the screen     
·PTRID - printer characteristics for the printer assigned     
·RTNFLG - return flag parameters     
·SYSID - terminal characteristics for this session     

prcarrow Please note that the case of the variable is important so where it says "Mnflnm" it means exactly that and NOT "MNFLNM" or "mnflnm".  

prcarrow There are also common equates defined in NC.COMMON and NC.COMMON99: see the EQUATES list.