HP 3000 Manuals HP 3000 Manuals
Chapter 12 HP Menu Intrinsics If you already use HP Menu Intrinsics and you want to start using them with HP DeskManager, this chapter explains how to do it. The Intrinsics which can be used with HP Desk are a slightly modified version of those used for HP Menu. They define information necessary to run an application already installed on your HP 3000. To use these Intrinsics, the account, group and program must have Data Segment Handling (DS) capability. Some operations (for example, Interrupt Mode and File Passing) also require Process Handling (PH) capability. The Intrinsics fall into four categories, those which deal with: * The scratchpad area * User capabilities and name * The current object * Status The Scratchpad Area This is a 256 word area used for applications to communicate with each other, or to store application dependent information. The area is accessed with the OLGetOneScratch and OLSetOneScratch Intrinsics. An application can perform any operations on an item in the Scratchpad Area as long as the value can be expressed as 16-bit words. User Capabilities and Name Applications can retrieve a user's capabilities and name using the Intrinsics OLGetPassword (for capabilities) and OLGetUserId (for name). Capabilities are stored in an 8 character string, interpreted as a 64-bit packed structure. The username is stored in the format: name,location,sublocation where: name is 36 characters location is 6 characters sublocation is 2 characters Current Object This refers to a value or values that can be passed from one application to another. These values can be file names or an object name (an item within a file). There are twenty values that may be defined for Hewlett-Packard products and five that are reserved for non-Hewlett-Packard products. The Intrinsics allow you to store current object values before exiting an application, or to pass a current object value from one application to another. A current object is manipulated by using Intrinsics which reference the number associated with that object. Note that all current object information is retained in the current object file after HP Desk is exited. The &EXPORT script file directive can alter the content of a current object. The &IMPORT directive can reference the object. See Chapter 10 for more information. Status The OLMenuStatus Intrinsics can be used within an application to find out whether the application was invoked by HP Desk or HP Menu. The intrinsic returns a value of -1 if the application was invoked by HP DeskManager, 0 if it was not. If it was, the application can use the current object stored by HP Desk. The current object is passed in the Extra Data Segment (XDS). The format of the XDS is given in Chapter 11 .