Caché ObjectScript Reference - InterSystems Documentation

Caché ObjectScript FunctionsmodeThe possible values for mode are shown in the following table. If mode is omitted, the defaultis -1. Note that some values are implementation specific. Implementation restrictions arenoted in the table.Mode0-1-2-3-5-6-7nMemory Management RegionThe view bufferThe process's partition (default)The system tableThe virtual address space for the currentprocess.Global reference and dataReserved for InterSystems' useUsed only by the integrity checking utilityWhen n is a positive number, the virtualaddress space for the running process n,where n is the pid (value of the $JOB specialvariable) for that process. Treats offset andlength the same as mode -3.Base AddressBeginning of view bufferBeginning of partitionBeginning of system table0Special. See “Using Mode -5,”later in the Notes section.Special.0The following example shows two equivalent $VIEW statements, the first of which takesthe mode and length argument defaults:OPEN 63WRITE !,$VIEW(0)WRITE !,$VIEW(0,-1,1)CLOSE 63length• When mode is 0, -1, or -2, specify a negative integer from -1 to -8192 to return that lengthof data as a string. $VIEW returns the specified number of characters (from 1 to 8192)starting at the address indicated by offset. To return the decimal value of the data, specifya positive integer from 1 to 4. $VIEW returns from one to four contiguous bytes startingat the address indicated by offset. You can also use the letter C to indicate a four-byteaddress or the letter P to indicate a four-byte word address. Specify both the P or C andthe positive integer in double quotes. To return a byte value in reverse order (low-orderbyte at lowest address) append the letter O to the length number and enclose both in310 Caché ObjectScript Reference