900 Series HP 3000 Computer Systems MPE/iX Architected Interface Facility: Operating System Reference Manual ABCDE HP Part No. 36374-90001 Printed in U.S.A.
Notice: This document is licensed only for use by software developers and may not be transferred to end-user customers. Architected Interfaces Notice The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability or tness for a particular purpose.
Printing History The following table lists the printings of this document, together with the respective release dates for each edition. The software version indicates the version of the software product at the time this document was issued. Many product releases do not require changes to the document. Therefore, do not expect a one-to-one correspondence between product releases and document editions.
Preface MPE/iX, Multiprogramming Executive with Integrated POSIX, is the latest in a series of forward-compatible operating systems for the HP 3000 line of computers. In HP documentation and in talking with HP 3000 users, you will encounter references to MPE XL, the direct predecessor of MPE/iX. MPE/iX is a superset of MPE XL. All programs written for MPE XL will run without change under MPE/iX.
Conventions UPPERCASE In a syntax statement, commands and keywords are shown in uppercase characters. The characters must be entered in the order shown; however, you can enter the characters in either uppercase or lowercase.
Conventions (continued) [ ... ] In a syntax statement, horizontal ellipses enclosed in brackets indicate that you can repeatedly select the element(s) that appear within the immediately preceding pair of brackets or braces. In the example below, you can select parameter zero or more times. Each instance of parameter must be preceded by a comma: [,parameter][...
Contents 1. Introduction Intended Use for Architected Interfaces . . . . . Who Uses Architected Interfaces? . . . . . . . Installing Operating System Architected Interfaces INSTOS . . . . . . . . . . . . . . . . . . AIFINTR . . . . . . . . . . . . . . . . . How to Ship Products That Use Operating System Architected Interfaces . . . . . . . . . . . Using INSTOS . . . . . . . . . . . . . . . Using AIFGLOBINSTALL . . . . . . . . . .
Contents-2 2. Using Operating System Architected Interfaces Data Type Naming Convention . . . . . . . Data Type Mappings to Languages . . . . . . Error Management . . . . . . . . . . . . . Status Data Type . . . . . . . . . . . . Overall Status . . . . . . . . . . . . . . Item Status . . . . . . . . . . . . . . . Item Veri cation Status . . . . . . . . . . Hierarchical File System . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 2-2 2-3 2-3 2-4 2-4 2-4 2-5 3.
Printer Device Item Descriptions Tape Device Item Descriptions . Disk Device Item Descriptions . AIFFILEGGET . . . . . . . . Syntax . . . . . . . . . . . Parameters . . . . . . . . . Operation Notes . . . . . . . AIFFILEGPUT . . . . . . . . Syntax . . . . . . . . . . . Parameters . . . . . . . . . Operation Notes . . . . . . . AIFFILEGGET/PUT Items . . . Item Summary . . . . . . . . Item Descriptions . . . . . . . AIFFILELGET . . . . . . . . Syntax . . . . . . . . . . . Parameters . . . . . . . . .
Syntax . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . Operation Notes . . . . . . . . . . . AIFJSGET . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . Operation Notes . . . . . . . . . . . AIFJSPUT . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . Operation Notes . . . . . . . . . . . AIFJSGET/PUT Items . . . . . . . . . Item Summary . . . . . . . . . . . . Item Descriptions . . . . .
AIFMOGET/PUT Item Descriptions . AIFMOMOUNT . . . . . . . . . . . Syntax . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . Operation Notes . . . . . . . . . . MOUTIL . . . . . . . . . . . . Volume Set . . . . . . . . . . . Media Label . . . . . . . . . . . AIFMOMOUNT Notes . . . . . . AIFMOMOUNT Item Descriptions . . AIFPORTCLOSE . . . . . . . . . . Syntax . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . Operation Notes . . . . . . . . . . AIFPORTINT . . . . . . . . . . . .
Syntax . . . . . . . . . . . Parameters . . . . . . . . . Operation Notes . . . . . . . Item Descriptions . . . . . . . AIFSCGET . . . . . . . . . . Syntax . . . . . . . . . . . Parameters . . . . . . . . . Operation Notes . . . . . . . AIFSCPUT . . . . . . . . . . Syntax . . . . . . . . . . . Parameters . . . . . . . . . Operation Notes . . . . . . . AIFSCGET/PUT Items . . . . . Item Summary . . . . . . . . Item Descriptions . . . . . . . AIFSPFGET . . . . . . . . . Syntax . . . . . . . . . . .
AIFSPPRELEASE . . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . Operation Notes . . . . . . . . . . . . . . . AIFSPPRESUME . . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . Operation Notes . . . . . . . . . . . . . . . AIFSPPSHUTQ . . . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . Operation Notes . .
Device Criteria Item Descriptions . . . . . . . . Device Class Criteria Item Descriptions . . . . . Console Reply Information Criteria Item Descriptions Workgroup Criteria Item Descriptions . . . . . . AIFTIME . . . . . . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . Operation Notes . . . . . . . . . . . . . . . AIFWGADD . . . . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . .
B. AIF Data Structures C. Programming Examples Example 1 - SEND1S, send data . . . . Example 2 - RECV1S, receive data . . . Example 3 - ASYNC1, asynchronous ports Example 4 - ASYNC2, asynchronous ports Example 5 - Retrieving HFS pathnames . Example 6 - HFS directory traversal . . Example 7 - Using Magneto-Optical AIFs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2 C-6 C-11 C-23 C-29 C-37 C-42 D.
Tables 2-1. 3-1. 3-2. 3-3. 3-4. 3-5. 3-6. 3-7. 3-8. 3-9. 3-10. 3-11. 3-12. 3-13. 3-14. 3-15. 3-16. 3-17. 3-18. 3-19. 3-20. 3-21. 3-22. 3-23. 3-24. 3-25. 3-26. 3-27. 3-28. 3-29. 3-30. 3-31. 3-32. Contents-10 Data Type Naming Convention . . . . . . . . Accounting Information Item Summary . . . . . Accounting Information: User Item Descriptions . Accounting Information: Group Item Descriptions Accounting Information: Account Item Descriptions AIFDEVCLASSGET - Device Criteria Items from System Tables . . . .
3-33. AIFSPFPUT Spool File Information Item Descriptions . . . . . . . . . . . . . . . 3-34. Spooler Process Information Item Summary . . . 3-35. AIFSPPGET Spooler Process Information Item Descriptions . . . . . . . . . . . . . . . 3-36. AIFSPPPUT Spooler Process Information Item Descriptions . . . . . . . . . . . . . . . 3-37. AIFSYSWIDEGET Parameter Information . . . 3-38. AIFSYSWIDEGET Job or Session Criteria Item Descriptions . . . . . . . . . . . . . . . 3-39.
1 Introduction The MPE/iX Architected Interface Facility provides reliable, high-performance development tools for 900 Series HP 3000 system management suppliers. The MPE/iX Architected Interface Facility provides specialized procedures, architected interfaces (AIFs), for use by software suppliers and internal and external solutions creators. AIFs provide easy and high-performance access, manipulation, or interception of Hewlett-Packard proprietary operating system and subsystem processes.
Intended Use for Architected Interfaces Hewlett-Packard provides two layers of programmatic access into the MPE/iX operating system, allowing software suppliers to select the layer that best meets their needs: AIFs provide high-performance access. System intrinsics provide totally secure access.
The primary audience of the Architected Interface Facility is third-party developers outside of Hewlett-Packard. The secondary audience is Hewlett-Packard internal operating system, subsystem, and application developers. Who Uses Architected Interfaces? MPE/iX Architected Interface Facility products are available for purchase by any third party developer.
How to Ship Products That Use Operating System Architected Interfaces Using INSTOS In order to ship code using operating system AIFs to customer sites, you must accomplish one of the two following actions: Use the INSTOS utility when you install your product on a 900 Series HP 3000 computer system. Use the AIFGLOBINSTALL AIF in your product to programmatically execute the INSTOS utility. If you want to install your application using INSTOS, you must perform the following steps: 1.
Types of Operating System Architected Interfaces Access Management Architected Interfaces The MPE/iX Architected Interface Facility: Operating System product provides three types of AIFs: Access management AIFs Information access AIFs Functional access AIFs Access management AIFs provide a mechanism, the user ID, to validate user access to operating system AIFs. User IDs Each purchaser of the Architected Interface Facility: Operating System product is assigned a unique user ID.
Information Access Architected Interfaces Information access AIFs provide access to MPE/iX internal table information while abstracting the structure from the user. The information access AIFs provide a single AIF, AIFSYSWIDEGET, that is normally the starting point for information retrieval. AIFSYSWIDEGET returns information on the current state of the system. For example, it can provide a list of objects that currently exist on the system and meet a speci ed set of criteria.
System-Wide Information The system wide information AIF is AIFSYSWIDEGET The AIFSYSWIDEGET AIF is normally the rst AIF called. It returns information about a whole class of objects, instead of information about a particular object as the other AIFs do. The AIFSYSWIDEGET AIF enables you to specify an object class as well as a list of criteria that you wish to apply to the objects in that class.
Global File Information. Global le information AIFs are AIFFILEGGET AIFFILEGPUT Global le information AIFs use le names and UFIDs as input keys. Job or Session Information Job or session information AIFs are AIFJSGET AIFJSPUT Job or session AIFs return or update information associated with jobs and sessions. They accept job numbers or session numbers as input keys, returning or updating job or session information associated with the keys.
Spooler Information There are two types of spooler information AIFs spool le information AIFs spooler process AIFs Spool File Information. Spool le information AIFs are AIFSPFGET AIFSPFPUT The AIFSPFGET and AIFSPFPUT AIFs accept a le name or an address as input keys and return or update information about les that have been spooled. Spooler Process Information.
Functionality Access Architected Interfaces The Architected Interface Facility: Operating System product provides AIFs to manage special functionality normally available only to operating system internals.
Spooler Management Spooler management AIFs are: AIFSPFLINK AIFSPFLIST AIFSPPOPENQ AIFSPPRELEASE AIFSPPRESUME AIFSPPSHUTQ AIFSPPSTART AIFSPPSTOP AIFSPPSUSPEND Spooler management AIFs enable you to manage spool les and spooler processes. For example, you can start, stop, resume, or suspend devices. In addition, you can link les to the MPE/iX spooler facility.
Utilities Utility AIFs provide miscellaneous functionality useful to application developers. AIFCHANGELOGON enables you to change the logon environment of a process. AIFCLOSE enables you to save les across account boundaries. AIFCONVADDR converts compatibility mode relative addresses to corresponding native mode virtual addresses. AIFGLOBINSTALL is the programmatic equivalent of executing the INSTOS installation utility.
2 Using Operating System Architected Interfaces This chapter provides information required for the correct use of operating system architected interfaces. Included in this chapter are discussions about: Data type naming conventions used in this manual Data type mappings to languages Error management Note Data Type Naming Convention Please read and understand fully the information provided in this chapter before using operating system architected interfaces.
Data Type Mappings to Languages Most of the information exchange across AIFs is accomplished through the use of scalar types, which do not require any special treatment. The scalar types include integers, short integers, and booleans. For record types, appendix B provides the Pascal record declarations as well as the packing of the elds as implemented by the HP Pascal/iX compiler. This information should su ce to make the call usable from both Pascal and C.
Error Management While error checking is minimized in order to increase AIF performance, architected interfaces provide comprehensive error management. Architected interfaces provide parameters that return information about the success or failure of the call. Each status parameter uses the data type status_type to return status information.
Note Overall Status Status variables must be initialized to zero before calling the AIF. AIFs use the parameter overall status to indicate the status of the overall call. If an AIF call is successful, zero is returned in overall status . If an error has occurred, a negative number is returned. A positive number returned indicates the index of the last element in the items array parameter that caused an error.
The ver item statuses is an array of status_type. This array returns status information concerning the success or failure of veri cation on each item speci ed in the ver item nums parameter and the data pointed to by the ver items parameter. There is a one-to-one correspondence between elements in ver item statuses and elements in ver item nums . For example, the eighth element of ver item statuses returns status information about the eighth element of ver item nums .
If the pathname returned is too large to t in the user bu er as speci ed by the length in the rst word, then an error will be returned to the user application. Note For each AIF which accepts or returns a lename, new parameters or items have been added to support HFS pathnames. Existing items which are de ned as MPE names ( le.group.account) will not be e ected. The idea is that eventually most applications will convert over to use the new HFS items, but they will not be forced to convert over immediately.
3 Architected Interface Descriptions This chapter describes operating system architected interfaces, arranged alphabetically.
AIFACCTGET Returns system accounting information. AIFACCTGET Syntax REC AIFACCTGET (overall status, RECA I32A @64A itemnum array, item array, REC I32 itemstatus array, directory name, user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFACCTGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. directory name Array type: status_type (Refer to appendix B.
AIFACCTPUT Modi es system accounting information. AIFACCTPUT Syntax REC AIFACCTPUT (overall status, RECA I32A @64A itemnum array, item array, REC I32 itemstatus array, directory name, user id, I32A @64A RECA ver item nums, ver items, ver item statuses); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFACCTPUT item array 64-bit address array by reference (required) An array where each element is a 64-bit address pointing to a data structure containing new information to be passed to the operating system. Information and its required data type are de ned by the item number passed in the corresponding element in itemnum array.
AIFACCTPUT ver item nums 32-bit signed integer array by reference (optional) An array of integers where each element is an item number indicating the operating system information to be veri ed before proceeding with modi cation. Veri cation information must be located in a data structure pointed to by the corresponding element in ver items . If n items are being veri ed, element n +1 must be a zero to indicate the end of the item list.
AIFACCTGET/PUT Items AIFACCTGET/PUT Items The following two tables provide summary and detailed descriptions of the item numbers associated with accounting information.
AIFACCTGET/PUT Items Item Summary The following table summarizes the item numbers associated with accounting information. For more detailed information about these item numbers, refer to the table of accounting information item descriptions. Table 3-1.
AIFACCTGET/PUT Items Table 3-1.
AIFACCTGET/PUT Items Item Descriptions The following three tables provide detailed descriptions of item numbers and corresponding items associated with user, group, and account information. Table 3-2. Accounting Information: User Item Descriptions Item Number 6001 Item Name (Data Type) Put; Verify; Release First Available Description User name (CA16) Put: No; Verify: Yes; Release 3.0 Returns the user name (left-justi ed and padded with blanks). 6002 Password (CA16) Put: Yes; Verify: Yes; Release 3.
AIFACCTGET/PUT Items Table 3-2. Accounting Information: User Item Descriptions (continued) Item Number 6004 Item Name (Data Type) Put; Verify; Release First Available Description Maximum priority (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the priority that is the maximum allowed for the user. The maximum priority for a user is speci ed by using the MAXPRI parameter of the NEWUSER and ALTUSER commands.
AIFACCTGET/PUT Items Table 3-2. Accounting Information: User Item Descriptions (continued) Item Number 6014 Item Name (Data Type) Put; Verify; Release First Available Description User Password Required? (B) Put: No; Verify: Yes; Release 5.0 Returns true if the user password is required and false when it is not. The required password is set via the USERPASS=REQ option on the NEWACCT and ALTACCT commands when the HP Security Monitor is installed.
AIFACCTGET/PUT Items Table 3-2. Accounting Information: User Item Descriptions (continued) Item Number 6021 Item Name (Data Type) Put; Verify; Release First Available Description User Password Aging Minimum Days (I32) Put: No; Verify: Yes; Release 5.0 Returns the minimum period in days a new or changed user password cannot be altered. Password aging is enforced only on REQUIRED user passwords. This value is used only when item 6022 (maximum days) is greater than zero.
AIFACCTGET/PUT Items Table 3-3. Accounting Information: Group Item Descriptions Item Number 6101 Item Name (Data Type) Put; Verify; Release First Available Description Group name (CA16) Put: No; Verify: Yes; Release 3.0 Returns the name of the group (left-justi ed and padded with blanks). 6102 Password (CA16) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the password of the speci ed group. The HP 3000 Security Monitor/iX Product available on Release 5.0 provides password encryption.
AIFACCTGET/PUT Items Table 3-3. Accounting Information: Group Item Descriptions (continued) Item Number 6104 Item Name (Data Type) Put; Verify; Release First Available Description Access (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the group access/security mask.
AIFACCTGET/PUT Items Table 3-3. Accounting Information: Group Item Descriptions (continued) Item Number 6108 Item Name (Data Type) Put; Verify; Release First Available Description Maximum CPU (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the maximum amount of CPU seconds allowed for this group. 6109 Accumulated connect (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the accumulated connect time in minutes for this group.
AIFACCTGET/PUT Items Table 3-4. Accounting Information: Account Item Descriptions Item Number 6201 Item Name (Data Type) Put; Verify; Release First Available Description Account name (CA16) Put: No; Verify: Yes; Release 3.0 Returns the account name (left-justi ed and padded with blanks). 6202 Password (CA8) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the password of the speci ed account. The HP 3000 Security Monitor/iX Product available on Release 5.0 provides password encryption.
AIFACCTGET/PUT Items Table 3-4. Accounting Information: Account Item Descriptions (continued) Item Number 6204 Item Name (Data Type) Put; Verify; Release First Available Description Access (I32) Put: Yes; Verify: Yes; Release 3.
AIFACCTGET/PUT Items Table 3-4. Accounting Information: Account Item Descriptions (continued) Item Number 6212 Item Name (Data Type) Put; Verify; Release First Available Description Account UDC Index (I32) Put: No; Verify: Yes; Release 5.0 The o set into COMMAND.PUB.SYS for account UDCs. COMMAND.PUB.SYS re ects the UDC environment that takes e ect the next time the user logs on. 6213 System UDC Index (I32) Put: No; Verify: Yes; Release 5.0 The o set into COMMAND.PUB.SYS for system UDCs. COMMAND.PUB.
AIFCHANGELOGON AIFCHANGELOGON Changes the logon environment of a process. Syntax REC CA REC I32 AIFCHANGELOGON (overall status, logon cmd, logon desc, options, REC I32 error status, user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFCHANGELOGON logon desc record by reference (optional) Required if logon cmd is not passed. Passes the target logon environment in a variable declared as a logon_desc_type. If the group is not speci ed in the group_name eld, the target user.account's home group is returned in that eld. If logon cmd is passed, logon desc can be passed to return the target logon environment (including the home group name) in the logon_desc_type format. (Refer to appendix B.
AIFCHANGELOGON Bit (2:1) Bit (3:1) Bit (4:1) Bit (5:1) Bit (6:1) Bit (7:1) Bit (8:24) Default: 0 3-22 Architected Interface Descriptions displays the new user and account names of the local process, and the SHOWJOB command displays the original logon user and account names (the same one that would have been displayed before the AIFCHANGELOGON). Do not change the global group name. When this bit is set, only the process local group name is updated.
AIFCHANGELOGON error status record by reference (optional) Returns a valid error number only if -2510 is returned in the info eld of overall status, indicating that the target logon environment passed in logon cmd is not syntactically valid. You can pass error status to the HPERRMSG intrinsic to return a syntax error message. Refer to the MPE/iX Intrinsics Reference Manual (32650-90028) for a description of HPERRMSG. Record type : status_type (Refer to appendix B.
AIFCHANGELOGON a programmatic DELETEVAR or SETVAR command for the same variable name, the SETVAR issued by the rst process is deleted or overwritten. The AIFCHANGELOGON AIF does not create private (process-local) variables. System Variables Most system variables (HP@) are actually implemented as \active functions", and they function correctly after a process executes an AIFCHANGELOGON. They should re ect the changes for the process. A few system variables are not implemented as active functions.
AIFCHANGELOGON JOBINFO If a process calls AIFCHANGELOGON, then information about the process local logon environment (created my AIFCHANGELOGON) will not be accessible via the JOBINFO intrinsic. The information returned by JOBINFO always re ects the global (jobwide or sessionwide) logon environment. If options to update global information are not selected, the global information is going to be di erent from the process local information.
AIFCLOSE Allows les to be saved across account boundaries. AIFCLOSE Syntax REC AIFCLOSE (overall status, Parameters I16 I16 I16 I32 le number, disposition, sec code, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFCLOSE sec code 16-bit signed integer by value (required) user id Passes the type of security initially applied for new permanent les. 0 Unrestricted access. 1 Private le creator security. 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON .
AIFCONVADDR Converts compatibility mode relative addresses to the corresponding native mode virtual addresses. AIFCONVADDR Syntax REC AIFCONVADDR (overall status, @64A I32A RECA mode array, inaddress array, I32A I32 outaddress array, convstatus array, user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFCONVADDR outaddress array convstatus array 64-bit address array by reference (required) An array where each element returns a 64-bit address that is the result of the conversion performed on a CM address located in the corresponding element in inaddress array. Array type: globalanyptr record array by reference (required) An array where each element returns the status of the conversion operation performed in the corresponding element in inaddress array. A zero indicates a successful operation.
AIFDEVCLASSGET AIFDEVCLASSGET Returns information for a device class. Syntax AIFDEVCLASSGET (overall REC I32A RECA CA16 @64A status, itemnum array, item array, I32 itemstatus array, device class, device class key, I32 user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFDEVCLASSGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. device class Array type: status_type (Refer to appendix B.
AIFDEVCLASSGET Items AIFDEVCLASSGET Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with device criteria items used by AIFDEVCLASSGET. Table 3-5. AIFDEVCLASSGET - Device Criteria Items from System Tables Item Number 13501 Item Name (Data Type) Get; Put; Verify; Release First Available Description Devices (Record) Get: Yes; Put: No; Verify: Yes; Release 4.0 This item returns the LDEVs in the device class.
AIFDEVICEGET Returns characteristics for devices. AIFDEVICEGET Syntax REC I32A I64A AIFDEVICEGET (overall status, itemnum array, item array, I32A I32 REC itemstatus array, ldev, device key, I32 user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFDEVICEGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. ldev Array type: status_type (Refer to appendix B.
AIFDEVICEGET The AIFs perform many of the same operations as FCONTROL and FDEVICECONTROL . They do not provide capabilities that are not already available through these interfaces. On MPE/iX Release 5.0 there are performance improvements to the FCONTROL and FDEVICECONTROL paths for DTC terminal connections that are not available through the I/O interfaces used by the AIFs. Therefore, the recommendation is to use the DTC terminal control functions provided by FCONTROL and FDEVICECONTROL on Release 5.
AIFDEVICEPUT Modi es device characteristics or performs various control operations on con gured devices. AIFDEVICEPUT Syntax REC AIFDEVICEPUT (overall I32A @64A status, itemnum array, item array, I32A I32 REC itemstatus array, ldev, device key, I32 I32A @64A user id, ver item nums, ver items, I32 ver item statuses); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFDEVICEPUT itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. ldev Array type: status_type (Refer to appendix B.
AIFDEVICEPUT ver items 64-bit address array by reference (optional) An array where each element is a 64-bit address pointing to a data structure containing information to be veri ed against current operating system information. Information and its required data type are de ned by the item number passed in the corresponding element in ver item nums .
AIFDEVICEPUT The AIFs perform many of the same operations as FCONTROL and FDEVICECONTROL . They do not provide capabilities that are not already available through these interfaces. On MPE/iX Release 5.0 there are performance improvements to the FCONTROL and FDEVICECONTROL paths for DTC terminal connections that are not available through the I/O interfaces used by the AIFs. Therefore, the recommendation is to use the DTC terminal control functions provided by FCONTROL and FDEVICECONTROL on Release 5.
AIFDEVICEGET/PUT Items AIFDEVICEGET/PUT Items 3-40 The following tables provide detailed descriptions of item numbers and corresponding items used by AIFDEVICEGET and AIFDEVICEPUT .
AIFDEVICEGET/PUT Items Device Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with device criteria items used by AIFDEVICEGET and AIFDEVICEPUT . Table 3-6. AIFDEVICEGET/PUT - Device Criteria Items from System Tables Item Number 13001 Item Name (Data Type) Get; Put; Verify; Release First Available Description LDEV (I32) Get: Yes; Put: No; Verify: Yes; Release 4.0 This is the LDEV for the device.
AIFDEVICEGET/PUT Items Table 3-6. AIFDEVICEGET/PUT - Device Criteria Items from System Tables (continued) Item Number 13012 Item Name (Data Type) Get; Put; Verify; Release First Available Description BOT (B) Get: Yes; Put: No; Verify: Yes; Release 4.0 Returns true when the tape is at Load Point (beginning of tape); otherwise it returns false. 13013 Interactive (B) Get: Yes; Put: Yes; Verify: Yes; Release 4.0 True when the device requires human intervention for all input operations.
AIFDEVICEGET/PUT Items Table 3-6. AIFDEVICEGET/PUT - Device Criteria Items from System Tables (continued) Item Number 13023 Item Name (Data Type) Get; Put; Verify; Release First Available Description Formal File Name Designator (CA8) Get: Yes; Put: No; Verify: Yes; Release 4.0 Returns the formal device le designator (for example, $STDIN). This name is left-justi ed and is padded with blanks to the right. 13024 J/S Key (I32) Get: Yes; Put: No; Verify: Yes; Release 4.
AIFDEVICEGET/PUT Items Table 3-6. AIFDEVICEGET/PUT - Device Criteria Items from System Tables (continued) Item Number 13027 Item Name (Data Type) Get; Put; Verify; Release First Available Description Security Downed Device (B) Get: Yes; Put: No; Verify: Yes; Release 5.0 Returns true when the device has been downed by Security. This is a feature of the HP Security Monitor. For more information see the MPE/iX Security Features System Manager's Guide .
AIFDEVICEGET/PUT Items Terminal Device Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with terminal device items used by AIFDEVICEGET and AIFDEVICEPUT . Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem Item Number 13101 Item Name (Data Type) Get; Put; Verify; Release First Available Description Terminal Type (I32) Get: Yes; Put: Yes; Verify: No; Release 4.
AIFDEVICEGET/PUT Items Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem (continued) Item Number 13104 Item Name (Data Type) Get; Put; Verify; Release First Available Description Parity Setting (I32) Get: Yes; Put: Yes; Verify: No; Release 4.0 This item returns or modi es the parity setting. 0 1 2 3 4 Forced to zero Forced to one Even Odd None The behavior of this item varies with the connection type (for example, DTC direct connect, PAD, or Telnet/iX).
AIFDEVICEGET/PUT Items Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem (continued) Item Number 13109 Item Name (Data Type) Get; Put; Verify; Release First Available Description Unedited Terminal Mode - Subsystem Break (C) Get: Yes; Put: Yes; Verify: No; Release 4.0 This item allows the user to replace the subsystem break character in unedited (transparent) terminal mode. Unedited mode is nearly binary; an EOR, subsystem break character, and the AEORs are the only special characters.
AIFDEVICEGET/PUT Items Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem (continued) Item Number 13116 Item Name (Data Type) Get; Put; Verify; Release First Available Description Read Timer (I32) Get: Yes; Put: No; Verify: No; Release 4.0 Returns the amount of time used for completion of the last read in hundreths of a second. The behavior of this item varies with the connection type (for example, DTC direct connect, PAD, or Telnet/iX).
AIFDEVICEGET/PUT Items Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem (continued) Item Number 13122 Item Name (Data Type) Get; Put; Verify; Release First Available Description Enable/Disable Typeahead (B) Get: Yes; Put: Yes; Verify: No; Release 4.0 This item returns or modi es the typeahead enable status. If this item is set to true, then typeahead is enabled. On false, typeahead is disabled.
AIFDEVICEGET/PUT Items Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem (continued) Item Number 13128 Item Name (Data Type) Get; Put; Verify; Release First Available Description XOFF Timer (I32) Get: Yes; Put: Yes; Verify: No; Release 4.0 This item returns or modi es the XOFF timer. A positive value, representing a time limit in seconds, enables the timer. A zero or negative value, disables the timer.
AIFDEVICEGET/PUT Items Table 3-7. AIFDEVICEGET/PUT TERMINAL Device Items from I/O Subsystem (continued) Item Number 13134 Item Name (Data Type) Get; Put; Verify; Release First Available Description Enable/Disable Form Feed Character (B) Get: Yes; Put: Yes; Verify: No; Release 4.0 This item returns or modi es the directive to allow the substitution of the form feed character in the output stream.
AIFDEVICEGET/PUT Items Printer Device Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with Printer device criteria items used by AIFDEVICEGET and AIFDEVICEPUT . Table 3-8. AIFDEVICEGET/PUT PRINTER Device Items from I/O Subsystem Item Number 13201 Item Name (Data Type) Get; Put; Verify; Release First Available Description Left Margin (I32) Get: No; Put: Yes; Verify: No; Release 4.
AIFDEVICEGET/PUT Items Tape Device Item Descriptions The following table provides detailed descriptions of item numbers and correspon ding items associated with TAPE device criteria items used by AIFDEVICEGET and AIFDEVICEPUT . Table 3-9. AIFDEVICEGET/PUT TAPE Device Items from I/O Subsystem Item Number 13301 Item Name (Data Type) Get; Put; Verify; Release First Available Description Fatal Errors (I32) Get: Yes; Put: No; Verify: No; Release 4.
AIFDEVICEGET/PUT Items Table 3-9. AIFDEVICEGET/PUT TAPE Device Items from I/O Subsystem (continued) Item Number 13308 Item Name (Data Type) Get; Put; Verify; Release First Available Description Track Error (B) Get: Yes; Put: No; Verify: No; Release 4.0 If it returns true, a single track was found in error. 13309 Unit Online (B) Get: Yes; Put: No; Verify: No; Release 4.0 If it returns true, the tape drive is online. 13310 Write Protect (B) Get: Yes; Put: No; Verify: No; Release 4.
AIFDEVICEGET/PUT Items Table 3-9. AIFDEVICEGET/PUT TAPE Device Items from I/O Subsystem (continued) Item Number 13319 Item Name (Data Type) Get; Put; Verify; Release First Available Description Set Density (I32) Get: No; Put: Yes; Verify: No; Release 4.
AIFDEVICEGET/PUT Items Table 3-9. AIFDEVICEGET/PUT TAPE Device Items from I/O Subsystem (continued) Item Number 13328 Item Name (Data Type) Get; Put; Verify; Release First Available Description Remote Online (No value needed) Get: No; Put: Yes; Verify: No; Release 4.0 This places the drive online. If this item is done to a drive with no tape, or the door is open (7980), the request does not complete until a tape is inserted or the door is closed. Not valid for the HP 7974, HP 7978A/B.
AIFFILEGGET Returns global le information. AIFFILEGGET Syntax REC AIFFILEGGET (overall status, RECA I32A @64A itemnum array, item array, REC REC B itemstatus array, UFID, lename, temp le, I32 REC REC user id, path identi er, pathname); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFFILEGGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. UFID Array type: status_type (Refer to appendix B.) record by reference (optional) Required if lename is omitted.
AIFFILEGGET temp le boolean by value (optional) Indicates whether or not the le speci ed is a temporary le. If true, the le is a temporary le. If false, or if this parameter is omitted, the le is a permanent le. (If the le UFID is passed in the UFID parameter, this parameter is ignored.) user id Default: false 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
AIFFILEGGET Operation Notes Use UFID instead of lename for greater performance. The hierarchical le system (HFS) was incorporated into MPE/iX with release 4.5. The following Operation Notes describe dealing with MPE syntax and HFS syntax les. MPE Syntax Files When interested in only those les that can be represented by MPE syntax, the following item keys and items should be used. These items continue to work exactly as they did before the introduction of the hierarchical le system.
AIFFILEGGET Note Only one item key should be speci ed. If multiple item keys are speci ed, then only one key is used and the rest are ignored. The following keys are in order of precedence: 1. 2. 3. 4. path identi er pathname UFID lename For example, if you specify both the pathname and the UFID parameters, the UFID parameter is ignored. If you specify the path identi er and the pathname parameters, then the pathname parameter will be ignored.
AIFFILEGPUT Modi es system global le information. AIFFILEGPUT Syntax REC AIFFILEGPUT (overall status, RECA I32A @64A itemnum array, item array, REC REC B I32 itemstatus array, UFID, lename, temp le, user id, I32A @64A REC REC RECA ver item nums, ver items, ver item statuses, path identi er, pathname); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFFILEGPUT itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. UFID Array type: status_type (Refer to appendix B.) record by reference (optional) Required if lename is omitted.
AIFFILEGPUT temp le Boolean by value (optional) Indicates whether or not the le speci ed is a temporary le. If true, the le is a temporary le. If false, or if this parameter is omitted, the le is a permanent le. user id Default: false 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON .
AIFFILEGPUT ver item statuses record array by reference (optional) An array where each element returns the status of the veri cation performed in the corresponding element in ver items . A zero indicates a successful veri cation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. Array type: status_type (Refer to appendix B.
AIFFILEGGET/PUT Items AIFFILEGGET/PUT Items 3-66 The following two tables provide summary and detailed descriptions of the item numbers associated with global le information.
AIFFILEGGET/PUT Items Item Summary The following table summarizes the item numbers associated with global le information. For more detailed information about these item numbers, refer to the table of global le item descriptions. Table 3-11.
AIFFILEGGET/PUT Items Table 3-11.
AIFFILEGGET/PUT Items Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with global le information. Table 3-12. Global File Information Item Descriptions Item Number 5001 Item Name (Data Type) Put; Verify; Release Available Description MPE File Name (REC) Put: No; Verify: Yes; Release 3.0 Returns the fully quali ed le name in the record format de ned by filename_type .
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5007 Item Name (Data Type) Put; Verify; Release Available Description File Allocation Timestamp (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the number of microseconds from January 1, 1970 to the time that the le was allocated. Record type: longint_type (Refer to appendix B.) 5008 File Code (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the le code of the le.
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5014 Item Name (Data Type) Put; Verify; Release Available Description Released (B) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es whether the le is released or secure. True when the le is released and false when the le is secure. This le aspect can be changed using the RELEASE and SECURE commands if you are the le's creator. 5015 Temporary (B) Put: No; Verify: Yes; Release 3.
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5024 Item Name (Data Type) Put; Verify; Release Available Description Message File Open/Close Record Count (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of open/close records. This is valid for message les only. For non-message les this value is zero. 5025 Number of Users (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of users that have this le open on the system.
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5032 Item Name (Data Type) Put; Verify; Release Available Description Group Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the group access rights.
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5035 Item Name (Data Type) Put; Verify; Release Available Description Account Librarian Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the account librarian access rights.
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5040 Item Name (Data Type) Put; Verify; Release Available Description Record type (U32) Put: No; Verify: Yes; Release 4.5 Returns the le record type.
AIFFILEGGET/PUT Items Table 3-12. Global File Information Item Descriptions (continued) Item Number 5046 Item Name (Data Type) Put; Verify; Release Available Description Current Link Count (U32) Put: No; Verify: Yes; Release 4.5 Returns the current number of links (hard links) for this le. 5047 Number of extents (I32) Put: No; Verify: Yes; Release 4.5 Number of extents used by the le. 5048 Number of Sectors (I32) Put: No; Verify: Yes; Release 4.5 Number of sectors used by a le.
AIFFILELGET Returns process-speci c le information. AIFFILELGET Syntax REC AIFFILELGET (overall status, RECA I32A @64A itemnum array, item array, I32 REC REC I32 itemstatus array, fnum, PID, UFID, user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFFILELGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. fnum Array type: status_type (Refer to appendix B.
AIFFILELGET Operation Notes The fnum parameter passes the le number returned by the le system to the calling process at open (FOPEN/HPFOPEN) time. It is the number used to invoke the various le system intrinsics. PID passes the PID of the process that issued the FOPEN/HPFOPEN call. PID is optional and defaults to the calling process's PID. If there is no active process associated with PID , AIFFILELGET returns an error condition.
AIFFILELGET Operation Notes - HFS MPE Files When you are interested in MPE le names only, the following items should be used. These items will continue to work exactly as they did before the introduction of the Hierarchical File System. ITEMS Item 4001 - lename Item 4002 - UFID Note that the UFID item will still return valid data for an HFS le since a UFID is still unique for every le on the system.
AIFFILELPUT Modi es process-speci c le information. AIFFILELPUT Syntax REC AIFFILELPUT (overall status, RECA I32A @64A itemnum array, item array, I32 REC REC I32 itemstatus array, fnum, PID, UFID, user id, I32A @64A RECA ver item nums, ver items, ver item statuses); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFFILELPUT item array 64-bit address array by reference (required) An array where each element is a 64-bit address pointing to a data structure containing new information to be passed to the operating system. Information and its required data type are de ned by the item number passed in the corresponding element in itemnum array.
AIFFILELPUT user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON . ver item nums Default: 0 32-bit signed integer array by reference (optional) An array of integers where each element is an item number indicating the operating system information to be veri ed before proceeding with modi cation.
AIFFILELPUT Operation Notes The fnum parameter passes the le number returned by the le system to the calling process at open (FOPEN/HPFOPEN) time. It is the number used to invoke the various le system intrinsics. PID passes the PID of the process that issued the FOPEN/HPFOPEN call. PID is optional and defaults to the calling process's PID. If there is no active process associated with PID , AIFFILELGET returns an error condition.
AIFFILELGET/PUT Items AIFFILELGET/PUT Items The following two tables provide summary and detailed descriptions of the item numbers associated with local (process-speci c) les.
AIFFILELGET/PUT Items Item Summary The following table summarizes the item numbers associated with local (process-speci c) le information. For more detailed information about these item numbers, refer to the table of local le item descriptions. Table 3-13.
AIFFILELGET/PUT Items Table 3-13.
AIFFILELGET/PUT Items Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with local (process-speci c) le information. Table 3-14. Local File Information Item Descriptions Item Number 4001 Item Name (Data Type) Put; Verify; Release First Available Description MPE File Name (REC) Put: No; Verify: Yes; Release 3.0 Returns the fully quali ed le name of the MPE le.
AIFFILELGET/PUT Items Table 3-14. Local File Information Item Descriptions (continued) Item Number 4006 Item Name (Data Type) Put; Verify; Release First Available Description Bu ered access? (B) Put: No; Verify: Yes; Release 3.0 Returns the le's bu ering status. True indicates that the le system uses bu ering to access the speci ed le. False indicates no bu ered access. Bu ered access is set at open time.
AIFFILELGET/PUT Items Table 3-14. Local File Information Item Descriptions (continued) Item Number 4014 Item Name (Data Type) Put; Verify; Release First Available Description Multiaccess type (I32) Put: No; Verify: Yes; Release 3.0 Returns the type of multiaccess speci ed for the speci ed le at open time, indicating how the record pointer is to be shared. For FOPEN it corresponds to aoptions (5:2) and for HPFOPEN, to item 14.
AIFFILELGET/PUT Items Table 3-14. Local File Information Item Descriptions (continued) Item Number 4019 Item Name (Data Type) Put; Verify; Release First Available Description Number of logical writes (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the number of logical writes made against the speci ed le. This information is kept for accounting and measurement interface purposes. Modifying this information a ects only the concerned statistics. Valid only for NM les.
AIFFILELGET/PUT Items Table 3-14. Local File Information Item Descriptions (continued) Item Number 4026 Item Name (Data Type) Put; Verify; Release First Available Description Access rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es a bit mask indicating the access rights for the speci ed le. File access rights dictate the kind of operations permitted to the process. If a bit is set to 1, the process has that right. It is speci ed at open time.
AIFFILELGET/PUT Items Table 3-14. Local File Information Item Descriptions (continued) Item Number 4029 Item Name (Data Type) Put; Verify; Release First Available Description Access privileged level (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the maximum privileged level for accessing the speci ed le. This is set at open time. For FOPEN, it defaults to the user's privileged level. For HPFOPEN, it corresponds to item 29.
AIFFILELGET/PUT Items Table 3-14. Local File Information Item Descriptions (continued) Item Number 4035 Item Name (Data Type) Put; Verify; Release First Available Description Bytes written (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the number of bytes written. This information is kept for accounting and measurement interface purposes. Modifying this information a ects only the concerned statistics. Valid only for NM les. Note: This item re ects the actual number of bytes written to disk.
AIFGLOBACQ Allocates an object of a speci ed size and places a pointer to that object in the Architected Interface Facility: Operating System internal data area. AIFGLOBACQ Syntax REC AIFGLOBACQ (overall status, Parameters I32 I32 REC user id, size, user cell); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFGLOBACQ Operation Notes The acquired object can be released by AIFGLOBREL The acquired object does not survive system reboots. The user cell parameter can also contain an address from the previous call, a bit map, or a customer 64-bit representation. It is the application designer's responsibility to save and manage this eld. AIFGLOBACQ, AIFGLOBREL, AIFGLOBGET, and AIFGLOBPUT all access the user cell. The user cell is a 64-bit data area which is located in the AIF internal area.
AIFGLOBGET Returns the contents of the user cell in the Architected Interface Facility: Operating System internal data area. AIFGLOBGET Syntax REC AIFGLOBGET (overall Parameters I32 REC status, user id, user cell); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFGLOBINSTALL AIFGLOBINSTALL Installs the user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. AIFGLOBINSTALL enables an application to execute operating system AIF code located on the target 900 Series HP 3000 computer system. Syntax REC AIFGLOBINSTALL (overall status, Parameters I32 user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFGLOBLOCK Restrict access to the user cell located in the Architected Interface Facility: Operating System internal data area. AIFGLOBLOCK Syntax REC AIFGLOBLOCK (overall Parameters I32 status, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFGLOBPUT Places a user-de ned value (for example, a pointer or a bit map) in the user cell of the Architected Interface Facility: Operating System internal data area. AIFGLOBPUT Syntax REC AIFGLOBPUT (overall status, Parameters I32 REC user id, user cell); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFGLOBREL Releases the object in the Architected Interface Facility: Operating System internal data area associated with the speci ed user ID (previously created by AIFGLOBACQ). AIFGLOBREL Syntax REC AIFGLOBREL (overall Parameters I32 status, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFGLOBUNLOCK AIFGLOBUNLOCK Releases the lock on the user cell in the Architected Interface Facility: Operating System internal data area obtained by AIFGLOBLOCK . Syntax REC AIFGLOBUNLOCK (overall status, Parameters I32 user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFJSGET Returns job and/or session information. AIFJSGET Syntax REC I32A AIFJSGET (overall status, itemnum array, REC I32 I32 JSNum, JSKey, user id); Parameters overall status @64A RECA item array, itemstatus array, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFJSGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. JSNum Array type: status_type (Refer to appendix B.
AIFJSPUT Modi es job and/or session information. AIFJSPUT Syntax REC I32A @64A RECA AIFJSPUT (overall status, itemnum array, item array, itemstatus REC I32 I32 I32A @64A JSNum, JSKey, user id, ver item nums, ver items, RECA ver item statuses); Parameters overall status array, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFJSPUT item array 64-bit address array by reference (required) An array where each element is a 64-bit address pointing to a data structure containing new information to be passed to the operating system. Information and its required data type are de ned by the item number passed in the corresponding element in itemnum array.
AIFJSPUT ver item nums 32-bit signed integer array by reference (optional) An array of integers where each element is an item number indicating the operating system information to be veri ed before proceeding with modi cation. Veri cation information must be located in a data structure pointed to by the corresponding element in ver items . If n items are being veri ed, element n +1 must be a zero to indicate the end of the item list.
AIFJSGET/PUT Items AIFJSGET/PUT Items 3-108 The following two tables provide summary and detailed descriptions of the item numbers associated with job/session information.
AIFJSGET/PUT Items Item Summary The following table summarizes the item numbers associated with job/session information. For more detailed information about these item numbers, refer to the table of job/session information item descriptions. Table 3-15.
AIFJSGET/PUT Items Table 3-15.
AIFJSGET/PUT Items Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with job/session information. Table 3-16. Job or Session Information Item Descriptions Item Number 1001 Item Name (Data Type) Put; Verify; Release First Available Description Job name (CA16) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the identi er given to a job or session. It must be left-justi ed, all capitals, and padded with blanks.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1008 Item Name (Data Type) Put; Verify; Release First Available Description Output priority (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the current output priority (OUTPRI) of the job. When a job's OUTPRI is higher than the outfence of the output device, the spool le that is associated with the $STDLIST for that job is sent to the device. The output should be a value in the range 0..14.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1015 Item Name (Data Type) Put; Verify; Release First Available Description Start time (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the time that the job or session rst logged on. If it is for a scheduled job, it is the time that the job is scheduled to start.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1023 Item Name (Data Type) Put; Verify; Release First Available Description Programmatic session? (B) Put: No; Verify: Yes; Release 3.0 Returns or modi es the programmatic session status of a session. True when a session is a programmatic session (created using the STARTSESS command or the STARTSESS intrinsic). 1024 Maximum account job priority (I32) Put: No; Verify: Yes; Release 3.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1026 Item Name (Data Type) Put; Verify; Release First Available Description Group security (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the security mask for the group that the job or session is logged on to. The group security mask can also be set using the ALTSEC command. Not valid for jobs in the WAIT state.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1027 Item Name (Data Type) Put; Verify; Release First Available Description Home group (CA16) Put: No; Verify: Yes; Release 3.0 Returns the name of the home group for the user that the job or session is logged on to. This is left-justi ed and padded with blanks. Not valid for jobs in the WAIT state. 1028 CPU count (I32) Put: No; Verify: Yes; Release 3.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1032 Item Name (Data Type) Put; Verify; Release First Available Description General resource capabilities (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the general resources capability mask for the job or session. This mask contains the general resource capabilities for the user that the job or session is logged on to. Not valid for jobs in the WAIT state.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1035 Item Name (Data Type) Put; Verify; Release First Available Description Logon time stamp (I64) Put: No; Verify: Yes; Release 3.0 Returns the time stamp for the time that the job or session logged on. The value is in microseconds. Not valid for jobs in the WAIT state. 1036 CI time out (I32) Put: Yes; Verify: Yes; Release 3.
AIFJSGET/PUT Items Table 3-16. Job or Session Information Item Descriptions (continued) Item Number 1044 Item Name (Data Type) Put; Verify; Release First Available Description Job submitter job/session number (REC) Put: No; Verify: Yes; Release 4.0 Returns submitter information for both jobs and sessions. The job/session number is returned for the user who streamed the job or created the session. For system processes the job/session number returned is 0. Record type: jsnum type (Refer to appendix B).
AIFKSMCREATE Returns a raw KSAM/XL le structure based on the le-speci c information passed in the user bu er. AIFKSMCREATE Syntax I32 lenum := REC A AIFKSMCREATE (overall status, bu er, I32 A A user id, group name, acct name, CA36 B I16 creator, old date, dev num, A A A vol class, vol name, vol set name, REC directory, le name); Functional Return lenum I32 bytes, 32-bit signed integer by reference (required) Returns an integer value used to identify the opened le in subsequent AIF VVVcalls.
AIFKSMCREATE user id 32-bit signed integer by value (optional) group name The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. Character array by reference (optional) Speci es an existing group where the KSAM/XL le will be created. If this parameter is not provided, the default group is where the KSAM/XL le being read resides. acct name Array type: mpe_name_type (Refer to appendix B.
AIFKSMCREATE vol class Character array by reference (optional) Speci es a volume class name on which the KSAM/XL le will be created. vol name Array type: t_vol_class_name (Refer to appendix B.) Character array by reference (optional) Speci es the volume class on which the KSAM/XL le will be created. vol set name Array type: t_volume_name (Refer to appendix B.) Character array by reference (optional) Speci es the volume set on which the KSAM/XL le will be created.
AIFKSMCREATE Operation Notes The AIFKSMCREATE call creates a raw KSAM/XL le using the information contained in the bu er. The rst AIFKSMREAD of a KSAM/XL le must be called before AIFKSMCREATE to obtain the necessary information in bu er for creating the le. At the end of AIFKSMCREATE , the data pointer is positioned to the next physical byte to be written, or at the end of the le if the entire le has been completely written.
AIFKSMREAD Sequentially reads a physical block of user-speci ed size from a KSAM/XL le. AIFKSMREAD Syntax I32 lgth REC := AIFKSMREAD (overall status, I32 I32 bytes, user id); Functional Return lgth I32 A lenum, bu er, 32-bit signed integer by reference (required) Returns a positive integer value indicating the length of the information transferred. Parameters overall status lenum bu er record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFKSMREAD user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. Operation Notes The AIFKSMREAD call reads a block from a KSAM/XL le in its physical sequence. The KSAM/XL le must have been opened in copy mode with MR and NOBUF options and read-only access in order to call this procedure.
AIFKSMWRITE Sequentially writes a block of data to a KSAM/XL le in the physical order. AIFKSMWRITE Syntax REC AIFKSMWRITE (overall status, I32 I32 bytes, user id); Parameters I32A lenum, bu er, overall status lenum A record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. Refer to appendix A for meanings of status values.
AIFKSMWRITE Operation Notes The AIFKSMWRITE call writes a block of data to the KSAM/XL le. The contents are contained in the array bu er, which was obtained from an AIFKSMREAD call. AIFKSMWRITE writes the le in its physical sequence. It writes the indexes of the le, skips the unused index area, then writes the data records.
AIFMOALLOCATE AIFMOALLOCATE Allocates a magneto-optical media drive. Syntax REC I32 AIFMOALLOCATE(overall status, ldev, I32A @64A itemnum array, item array, RECA I32 itemstatus array, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFMOALLOCATE is supplied, the itemnum array parameter and the itemstatus array parameter must both be supplied. Array type: globalanyptr (Refer to Appendix B.) itemstatus array Default: nil record array by reference (optional) If problems are detected with the speci c items, an error status is placed in the corresponding element of this array for each item with an error. The overall status parameter indicates whether any individual items contained errors, and the element of the last detected error.
AIFMOALLOCATE Allocating an optical drive does not prevent other processes from accessing media mounted on the allocated drive, but it does prevent other processes from dismounting the current media and mounting another piece of media, unless they know the pin used to allocate the drive. If the process performing the allocate terminates before the deallocate of the drive is performed the deallocate will occur during normal process termination clean up.
AIFMOALLOCATE Items AIFMOALLOCATE Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFMOALLOCATE . Table 3-17. AIFMOALLOCATE Item Descriptions Item Number 17101 Item Name (Data Type) Release First Available Description Pin (I32); Release 5.0 Returns the pin of the calling process. The pin can be used with other magneto-optical AIF's for veri cation of ownership for an optical media drive.
AIFMODEALLOCATE AIFMODEALLOCATE Deallocates a previously allocated magneto-optical media drive. Syntax REC I32 I32A AIFMODEALLOCATE(overall status, ldev, itemnum array, @64A RECA I32 item array, itemstatus array, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFMODEALLOCATE item array 64-bit address array by reference (optional) An array with the same number of elements as the itemnum array parameter, each of which is a globalanyptr that points to the appropriate type needed by each particular item number. The value used for each option is taken from the location pointed to by the globalanyptr in this array. When this parameter is supplied, the itemnum array parameter and the itemstatus array parameter must both be supplied.
AIFMODEALLOCATE Operation Notes AIFMODEALLOCATE provides a way to deallocate a magneto-optical drive that has been previously allocated. Once the drive is deallocated, it becomes available for other users. If the pin item is not speci ed, this AIF will deallocate the drive on behalf of the calling process. If the process that performed the allocate terminates before the deallocate of the drive is performed the deallocate will occur during normal process termination clean up.
AIFMODEALLOCATE Items AIFMODEALLOCATE Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFMODEALLOCATE. Table 3-18. AIFMODEALLOCATE Item Descriptions Item Number 17201 Item Name (Data Type) Release First Available Description Pin(I32); Release 5.0 Passes the pin for the process that allocated the speci ed optical drive. This is used for veri cation of ownership for an optical media drive.
AIFMODISMOUNT AIFMODISMOUNT Logically and physically dismounts previously mounted magneto-optical media from a magneto-optical drive. Syntax REC I32 I32A AIFMODISMOUNT(overall status, ldev, itemnum array, @64A RECA I32 item array, itemstatus array, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFMODISMOUNT item array 64-bit address array by reference (optional) An array with the same number of elements as the itemnum array parameter, each of which is a globalanyptr that points to the appropriate type needed by each particular item number. The value used for each option is taken from, or returned to, the location pointed to by the globalanyptr in this array. When this parameter is supplied, the itemnum array parameter and the itemstatus array parameter must both be supplied.
AIFMODISMOUNT Operation Notes AIFMODISMOUNT provides a way to dismount magneto-optical media that has been previously mounted. Volume management is called to close the volume set. Closing the volume set, dismounts it from the active system volume sets. All les on the volume set must be closed in order for the dismount to succeed.
AIFMODISMOUNT Items AIFMODISMOUNT Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFMODISMOUNT . Table 3-19. AIFMODISMOUNT Item Descriptions Item Number 17401 Item Name (Data Type) Release First Available Description Pin (I32) Release 5.0 Passes the pin for the process that allocated the speci ed optical drive. This is used for veri cation of ownership for an optical media drive.
AIFMOGET Returns magneto-optical disk library system information. AIFMOGET Syntax REC I32 I32A AIFMOGET(overall status, ldev, itemnum array, @64A RECA item array, itemstatus array, I32 I32 pin, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFMOGET item array 64-bit address array by reference (required) An array where each element is a 64-bit address pointing to a data structure where information is to be returned. Information and its required data type are de ned by the item number passed in the corresponding element in itemnum array . itemstatus array Array type: globalanyptr (Refer to Appendix B.
AIFMOPUT Modi es magneto-optical disk library system information. AIFMOPUT Syntax REC I32 I32A AIFMOPUT(overall status, ldev, itemnum array, @64A RECA I32 item array, itemstatus array, pin, I32A @64A ver item nums, ver items, RECA I32 ver item statuses, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFMOPUT item array 64-bit address array by reference (required) An array where each element is a 64-bit address pointing to a data structure containing new information to be passed to the operating system. Information and its required data type are de ned by the item number passed in the corresponding element in itemnum array . itemstatus array Array type: globalanyptr (Refer to Appendix B.
AIFMOPUT ver items 64-bit address array by reference (optional) An array where each element is a 64-bit address pointing to a data structure containing information to be veri ed against current magneto-optical disk library system information. Information and its required data type are de ned by the item number passed in the corresponding element in ver item nums. Array type: globalanyptr (Refer to Appendix B.
AIFMOGET/PUT Items AIFMOGET/PUT Item Descriptions The following tables provide a summary and detailed descriptions of the items associated with optical drives. Table 3-20. AIFMOGET/PUT Item Descriptions when ldev is an Optical Drive Item Number 17001 Item Name (Data Type) Put; Verify; Release Description Media Label (REC) Put: YES; Verify: YES; Release 5.0 Returns or modi es the media label. The media label is a record consisting of a media name, subname1, and subname2.
AIFMOGET/PUT Items Table 3-21. AIFMOGET/PUT Item Descriptions when ldev specifies an Autochanger Item Number 17003 Item Name (Data Type) Put; Verify; Release Description Number of storage slots (I32) Put: NO; Verify: NO; Release 5.0 Returns the number of storage slots. 17004 Number of drives (I32) Put: NO; Verify NO; Release 5.0 Returns the number of drives. The rst word of the bu er will be expected to hold the size, in words, of the rest of the bu er area.
AIFMOMOUNT Physically and logically mounts magneto-optical media by loading it into a magneto-optical drive and mounting it into the le system. AIFMOMOUNT Syntax REC I32 REC AIFMOMOUNT(overall status, ldev, media label, I32A @64A RECA itemnum array, item array, itemstatus array, I32 user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFMOMOUNT itemnum array Record type: media_label_type (Refer to Appendix B.) 32-bit signed integer array by reference (optional) This is an array of integers, terminated by an element containing the value zero, used to de ne the corresponding option given in the item array parameter. If this optional parameter is speci ed, the item array parameter and the itemstatus array parameter must both be supplied.
AIFMOMOUNT user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON . Default: 0 Operation Notes AIFMOMOUNT provides a way to physically mount a speci c piece of magneto-optical media in a magneto-optical drive and then logically mount it in the le system.
AIFMOMOUNT The volume set described here is the same as a volume set managed through Volume Management. The only di erences include the following. The optical media volume set is formatted through the MOUTIL utility as opposed to the VOLUTIL utility, and it is indirectly mounted through the Media Manager. Another di erence is that an optical media volume set can only consist of a single volume, the master volume.
AIFMOMOUNT AIFMOMOUNT Notes Attempting to mount media will fail with an error if the speci ed drive is not currently allocated (using AIFMOALLOCATE). If media is mounted in a drive and no one is accessing the media (that is, no les are open), the media can be dismounted and another media mounted. If the pin item is not speci ed an attempt is made to mount the media on behalf of the calling process.
AIFMOMOUNT Items The following table provides detailed descriptions of item numbers and corresponding items associated with AIFMOMOUNT. AIFMOMOUNT Item Descriptions Table 3-22. AIFMOMOUNT Item Descriptions Item Number 17301 Item Name (Data Type) Release First Available Description Pin (I32) Release 5.0 Passes the pin for the process that allocated the speci ed optical drive. This is used for veri cation of ownership for an optical media drive. If 0 is passed, the pin of the calling process is used.
AIFMOMOUNT Items Table 3-22. AIFMOMOUNT Item Descriptions (continued) Item Number 17304 Item Name (Data Type) Release First Available Description Nowait identi er (I32) Release 5.0 This item allows the user to initiate a mount request and to have control returned before completion of the mount. When a 0 is passed specifying 'initiation', the call to this AIF will initiate the mount but will return before it completes.
AIFPORTCLOSE AIFPORTCLOSE Removes a connection to a port opened by a call to AIFPORTOPEN. Syntax REC AIFPORTCLOSE (overall status, Parameters I32 I32 port id, access mode); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values. port id Record type: status_type (Refer to appendix B.
AIFPORTCLOSE Operation Notes For every AIFPORTOPEN performed during the life of a process, a corresponding AIFPORTCLOSE should be performed. In the event of a process abort, or if the process neglects to call AIFPORTCLOSE for any or all of the ports it has open, the ports are closed automatically during the process termination sequence. If the port is not speci ed to be a permanent port by the last process to open the port, it is destroyed when the last opener closes the port.
AIFPORTINT Allows the user to change the interrupt handler state of one or more asynchronous ports. The caller of this routine must be the receiver of the port. AIFPORTINT Syntax REC AIFPORTINT (overall Parameters I32A BA BA status, port list, newstates, oldstates); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFPORTINT oldstates Boolean array by reference (optional) An array of booleans, that upon return from a successful call contains a value of TRUE for each port in port list that had interrupts enabled prior to this call, and FALSE for each port that had interrupts disabled. This array must contain as many elements as are contained in port list.
AIFPORTOPEN Creates and/or opens a port. The port can be opened to allow for the asynchronous receipt of incoming messages by enabling a user speci ed handler.
AIFPORTOPEN port name character array by reference (required) Passes name used to identify this particular port. This name must be unique across the entire system. It should be padded on the right with blanks if it is fewer than 16 characters. The name will be upshifted, so it is not case sensitive. If a totally blank port name is speci ed, a unique name is established, a port with that name is created, and the name is returned in the port name parameter.
AIFPORTOPEN itemnum array 32-bit signed integer array by reference (optional) This is an array of integers, terminated by an element containing the value zero, used to de ne the corresponding option given in the item array parameter. If this optional parameter is speci ed, the item array parameter and the itemstatus array parameter must both be supplied.
AIFPORTOPEN Operation Notes The AIF Port Facility is an application interface that provides a fast means of interprocess communication by sending messages from one process to another. Messages can be received in a synchronous or asynchronous fashion. The ability to receive messages asynchronously is determined when the port is created. The remaining notes will reference details from the AIFPORTOPEN item descriptions (Table 3-16). Please review the item descriptions before reading further.
AIFPORTOPEN The creator of an asynchronous port is the only process that may receive messages from this port, and must provide the handler address when opening the port. If the creating process abnormally terminates, subsequent sends to the port will return an error. AIF ports that do NOT specify a handler at creation time, receive messages synchronously and allow multiple receivers. In addition, synchronous ports can be permanent, however, asynchronous ports are always temporary.
AIFPORTOPEN Special Considerations The asynchronous receipt of incoming messages has been implemented through Process Interrupts. A process interrupt is generated to signal the arrival of a message on an asynchronous port. The process interrupt will \interrupt" the creator process transferring control to the user supplied interrupt handler. As with other types of process interrupts (eg.
AIFPORTOPEN Example 2 The user opens an asynchronous port. AIFPORTINT is called to disable port interrupt handling around critical areas in the user code. Also AIFPORTINT is used in the handler to disable interrupt handling after entry, and later re-enabled before exiting the handling routine. Again, the message is queued to the port when the send request is issued. If the receiver is not currently waiting on the port, the process interrupt will occur.
AIFPORTOPEN AIFPORTOPEN Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFPORTOPEN. Table 3-23. AIFPORTOPEN Item Descriptions Item Number 11201 Item Name (Data Type) Release First Available Description Create option (I32); Release 3.0 Passes a port creation option. Values and their meanings are as follows: 1 2 3 Create a new port if the named port does not exist; otherwise, open the existing port.
AIFPORTOPEN Table 3-23. AIFPORTOPEN Item Descriptions (continued) Item Number 11205 Item Name (Data Type) Release First Available Description Make permanent (B); Release 3.0 Passes a value specifying the nal disposition of the port (whether permanent or removed) after the last process has done a close on it. If the port is to remain after the last process has done a close on it, a value of true must be passed with this parameter for all opens of the port.
AIFPORTRECEIVE AIFPORTRECEIVE Receives a message through a previously opened port. Syntax REC I32 CA I32 AIFPORTRECEIVE (overall status, port id, message bu er, message length, I32 I32 I32A @64A envelope code, message id, itemnum array, item array, RECA itemstatus array); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFPORTRECEIVE message length 32-bit signed integer by reference (required) envelope code Returns the actual length of the message returned in message bu er if the actual length is shorter than the value passed. 32-bit signed integer by reference (optional) Passes the length, in bytes, of message bu (If the message returned is longer than this length, the message is truncated.) er. Returns an integer code associated with the envelope portion of the message.
AIFPORTRECEIVE item array 64-bit address array by reference (optional) An array with the same number of elements as the itemnum array parameter, each of which is a globalanyptr that points to the appropriate type needed by each particular item number. The value used for each option is taken from, or returned to, the location pointed to by the globalanyptr in this array. When this parameter is supplied, the itemnum array parameter and the itemstatus array parameter must both be supplied.
AIFPORTRECEIVE There is an exception, however: when AIFPORTINT was used to disable port interrupt handling, newly arriving messages do not cause the handler to be invoked. Interrupt handling is delayed, and a pending count is incremented. After AIFPORTINT is used inside the handler, the rst receive should pick up the message that caused the handler to be called. The user can then issue another receive with item 11007 to get a message with a pending count.
AIFPORTRECEIVE AIFPORTRECEIVE Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFPORTRECEIVE . Table 3-24. AIFPORTRECEIVE Item Descriptions Item Number 11001 Item Name (Data Type) Release First Available Description Priority mask (I32); Release 3.0 Passes a priority bit mask that determines which messages are received. A message can be sent at any of 32 possible priorities.
AIFPORTRECEIVE Table 3-24. AIFPORTRECEIVE Item Descriptions (continued) Item Number 11004 Item Name (Data Type) Release First Available Description Sender PID (I32); Release 3.0 Returns the sender's process ID (PID). 11005 Sender PIN (I32); Release 3.0 Returns the sender's process identi cation number (PIN). The PIN is a 16-bit value, but is returned as an 32-bit integer. 11006 Actual priority (I32); Release 3.0 Returns the priority of the message.
AIFPORTSEND Sends a message to another process through a previously opened port. AIFPORTSEND Syntax REC I32 CA I32 AIFPORTSEND (overall status, port id, message bu er, message length, I32 I32 I32A @64A envelope code, message id, itemnum array, item array, RECA itemstatus array); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFPORTSEND envelope code 32-bit signed integer by value (optional) Passes an integer code associated with the envelope portion of the message. The use of this value is application dependent; for example, it can be used to identify the type of message being sent, so the receiving process can identify the message type without accessing the actual message bu er. If this parameter is not supplied, envelope code is defaulted to zero.
AIFPORTSEND itemstatus array record array by reference (optional) If problems are detected with speci c items, an error status is placed in the corresponding element of this array for each item with an error. The overall status parameter indicates whether any individual items contained errors, and the element of the last detected error. This array must contain as many elements as are contained in the itemnum array and item array parameters.
AIFPORTSEND AIFPORTSEND Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFPORTSEND. Table 3-25. AIFPORTSEND Item Descriptions Item Number 11101 Item Name (Data Type) Release First Available Description Time out seconds (I32); Release 3.0 Passes a value that sets a timeout in seconds.
AIFPROCGET Returns process information. AIFPROCGET Syntax AIFPROCGET( overall REC I32A status, itemnum array, @64A RECA item array, itemstatus array, I32 REC I32 PIN, PID, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFPROCGET PIN 32-bit signed integer by value (optional) Passes the process identi cation number (PIN) of the process for which information is desired. PID Default 0 Record by value (optional) Passes the process identi er (PID) of the process for which information is desired. Record type: longint type user id Default 0 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
AIFPROCPUT Modi es process information AIFPROCPUT Syntax AIFPROCPUT(overall REC I32A status, itemnum array, @64A RECA item array, itemstatus array, I32 REC I32 PIN, PID, user id, I32A @64A RECA ver item nums, ver items, ver item statuses ) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFPROCPUT itemstatus array Record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. PIN Array type: status type 32-bit signed integer by value (optional) Passes the process identi cation number (PIN) of the process whose information is to be modi ed.
AIFPROCPUT ver items 64-bit address array by reference (optional) An array where each element is a 64-bit address pointing to a data structure containing information to be veri ed against current operating system information. Information and its required data type are de ned by the item number passed in the corresponding element in ver item nums.
AIFPROCGET/PUT Items AIFPROCGET/PUT Items 3-182 The following two tables provide summary and detailed descriptions of the items associated with process information.
AIFPROCGET/PUT Items Item Summary The following table summarizes the item numbers associated with process information. For more detailed information about these item numbers, refer to the table of process information item descriptions. Table 3-26.
AIFPROCGET/PUT Items Table 3-26.
AIFPROCGET/PUT Items Table 3-26.
AIFPROCGET/PUT Items Table 3-26.
AIFPROCGET/PUT Items Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with process information. Table 3-27. Process Information Item Descriptions Item Number 2001 Item Name (Data Type) Put; Verify; Description PID (REC) Put: No; Verify: Yes; Release 3.0 Returns the PID of the process. Record type: longint_type (Refer to appendix B.) 2002 PIN (I32) Put: No; Verify: Yes; Release 3.0 Returns the PIN of the process.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2009 Item Name (Data Type) Put; Verify; Description JSmain PID (REC) Put: No; Verify: Yes; Release 3.0 Returns the PID of the JSmain process of the tree to which this process belongs. For system processes, a 0 is returned. For Jsmains in use, its own PID is the also JSmain PID. Record type: longint_type (Refer to appendix B.) 2010 JSmain PIN (I32) Put: No; Verify: Yes; Release 3.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2016 Item Name (Data Type) Put; Verify; Description Scheduling state (I32) Put: No; Verify: Yes; Release 3.0 Returns the state of the process, as viewed by the dispatcher. It is the rst item that should be interrogated to ascertain a process's state.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2019 Item Name (Data Type) Put; Verify; Description Priority (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the priority of the process. This is an MPE/iX priority. It is very transient for user processes. For processes whose priority is not xed, this value should be interpreted as the priority at which the process was last dispatched.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2022 Item Name (Data Type) Put; Verify; Description Process state (I32) Put: No; Verify: Yes; Release 3.0 Returns the state of the process from the viewpoint of process management. In general, it should be alive for most processes. The other states are generally very transient. The data returned is valid mainly for the alive case.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2025 Item Name (Data Type) Put; Verify; Description Reason for waiting (I32) Put: No; Verify: Yes; Release 3.0 Returns reasons that a process is not currently executing.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2025 Item Name (Data Type) Put; Verify; Description Reason for waiting (continued from previous page); Release 3.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2025 Item Name (Data Type) Put; Verify; Description Reason for waiting (continued from previous page); Release 3.0 80 81 82 83 84 85 86 87 100 101 2026 sql bu er wait long pause wait memory manager freeze and other release deferred preempt memory manager pseudo ioread memory manager pseudo iowrite other wait dispatcher not blocked dead process Last NM error entry number (I32) Put: Yes; Verify: Yes; Release 3.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2033 Item Name (Data Type) Put; Verify; Description Process type (U32) Put: No; Verify: Yes; Release 3.0 Returns the type of the process.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2041 Item Name (Data Type) Put; Verify; Description Space ID of the stack (I32) Put: No; Verify: Yes; Release 3.0 Returns the space ID for SR5. This space consists of, among other things, the NM area, the XRT area, and the CM area. 2042 XRT area base (@64) Put: No; Verify: Yes; Release 3.0 Returns a pointer to the base of the XRT area. 2043 XRT area limit (@64) Put: No; Verify: Yes; Release 3.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2053 Item Name (Data Type) Put; Verify; Description CM stack DST number (I32) Put: No; Verify: Yes; Release 3.0 Returns the DST number assigned to the CM area in the process local space. It is initialized at process creation time, once and for all. The address of the CM area base, in split stack mode, can be obtained through the CM area base and NM SID items. 2054 DB (@64) Put: No; Verify: Yes; Release 3.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2063 Item Name (Data Type) Put; Verify; Description File numbers of the open les (REC) Put: No; Verify: No; Release 3.0 Returns an array of the NM le numbers of all the les opened by the process. The maximum number of les can be 1024, including the standard les. Note that this item returns le numbers for both MPE syntax and HFS syntax les. Item 2064 only supports names that can be represented using MPE syntax.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2065 Item Name (Data Type) Put; Verify; Description UFIDs of les (REC) Put: No; Verify: No; Release 3.0 Returns a list of UFIDs (unique identi ers) for the open les. These can then be used as input to the other AIFs. For device les and standard les, the UFID will be blanks. You should pass an area of appropriate size.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2072 Item Name (Data Type) Put; Verify; Description Critical code depth (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of nested calls to enter critical code. 2073 Number of CM intrinsic errors (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the number of errors during the last call to a CM intrinsic. Values are in the range 0..6. This item is zeroed out upon entry into a CM intrinsic.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2079 Item Name (Data Type) Put; Verify; Description NM arithmetic trap mask (I32) Put: No; Verify: Yes; Release 3.0 Returns the mask for arithmetic traps raised in NM. This mask is set by the compiler.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2084 Item Name (Data Type) Put; Verify; Description NM system trap privileged level (I32) Put: No; Verify: Yes; Release 3.0 Returns the privileged level at which the trap handler executes. 2085 NM system trap handler (@64) Put: No; Verify: Yes; Release 3.0 Returns the address of the trap handler to be invoked in case of a system trap in NM.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2092 Item Name (Data Type) Put; Verify; Description CPU time, in milliseconds (REC) Put: No; Verify: Yes; Release 3.0 Returns the CPU time, in milliseconds, used by the process. Record type: longint_type (Refer to appendix B.) 2093 Does process have a SIR? (B) Put: No; Verify: Yes; Release 3.0 Returns true if this process is currently holding a SIR, and false otherwise.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2106 Item Name (Data Type) Put; Verify; Description Execution Mode (B) Put: No; Verify: Yes; Release 4.0 Returns the execution mode of the speci ed process. Note that the process' execution changes dynamically, therefore this is just a \snapshot" of the process' execution mode. True indicates the execution mode is CM, a false value indicates NM execution. 2107 CM Maxdata (I32) Put: No; Verify: Yes; Release 4.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2115 Item Name (Data Type) Put; Verify; Description Account Security (I32) Put: Yes; Verify: Yes; Release 4.5 Returns or modi es the security mask for the account that the job or session is logged on to. This information is local to the process. The account security mask can also be set using the ALTSEC command. Not valid for jobs in the WAIT state.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2116 Item Name (Data Type) Put; Verify; Description Group security (I32) Put: Yes; Verify: Yes; Release 4.5 Returns or modi es the security mask for the group that the job or session is logged on to. This information is local to the process. The group security mask can also be set using the ALTSEC command. Not valid for jobs in the WAIT state.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2119 Item Name (Data Type) Put; Verify; Description User Capabilities (I32) Put: Yes; Verify: Yes; Release 4.5 Returns or modi es the user capability mask for the job or session. Not valid for jobs in the WAIT state. This information is local to the process.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2121 Item Name (Data Type) Put; Verify; Description Allow Mask (BA96) Put: Yes; Verify: Yes; Release 4.5 Returns or modi es the commands allowed for this session in a packed array of 96 booleans. True is returned if the command is allowed for the job or session. Not valid for jobs in the WAIT state. This information is local to the process.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2125 Item Name (Data Type) Put; Verify; Description Fork Process (B) Put: No; Verify: Yes; Release 4.5 Returns true if the process was created using the fork() function. 2126 UID (I32) Put: Yes; Verify: Yes; Release 4.5 Returns the process' real user ID. This POSIX attribute is assigned to each user on the system. Every process created by a user has that user's real user ID.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2133 Item Name (Data Type) Put; Verify; Description Break Request Cancel (I32) Put: No; Verify: Yes; Release 4.5 Returns counter used by process management to indicate whether a pending process management break interrupt message just received is to be ignored or not. 2134 Break Request Pending (I32) Put: No; Verify: Yes; Release 4.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2144 Item Name (Data Type) Put; Verify; Description Workgroup name (CA256) Put: Yes; Verify: Yes Returns or modi es the name of the workgroup to which the speci ed process belongs. The workgroup name will be left justi ed and terminated by a NULL character (ASCII 0). AIFPROCPUT with this item number will move the target process to the speci ed workgroup.
AIFPROCGET/PUT Items Table 3-27. Process Information Item Descriptions (continued) Item Number 2148 Item Name (Data Type) Put; Verify; Description Fixed Priority? (I32) Put: Yes; Verify: NO Fixes the priority of the process at the value passed. This item will return a warning for AIFPROCGET. A valid MPE/iX priority is in the range 0 .. 32767. This priority can be mapped to MPE V priority by the following formula: MPEVPri= (32767 - MPEXLPri) DIV 128 (All formula values are decimal.
AIFREPLYGET Returns information on a speci ed pending reply request. AIFREPLYGET Syntax REC AIFREPLYGET (overall status, RECA I32A @64A I32 I32 itemnum array, item array, itemstatus array, reply request id, user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFREPLYGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. reply request id Array type: status_type (Refer to appendix B.
AIFREPLYGET Table 3-28. Reply Information Item Descriptions Item Number 14001 Item Name (Data Type) Release First Available Description Is entry active? (B) Release 3.0 Returns true if the reply request is active, and false when the reply request is inactive. 14002 Process type (I32) Release 3.0 Returns the type of the process that requested the reply. Values and their meanings are as follows: 1 2 14003 System process User process Creation time (I32) Release 3.
AIFREPLYGET Table 3-28. Reply Information Item Descriptions (continued) Item Number 14008 Item Name (Data Type) Release First Available Description Message length (I32) Release 3.0 Returns the length of the message returned in item 14006. 14009 Request set number (I16) Release 3.0 Returns the message set number in the message catalog for the speci ed request.
AIFSCGET Returns system con guration information AIFSCGET Syntax AIFSCGET(overall REC I32A status, itemnum array, @64A RECA item array, itemstatus array, I32 user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item. A positive value indicates the last element in itemstatus array, signaling an error condition.
AIFSCGET user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON. Default: 0 Operation Notes 3-218 AIFSCGET does not require any speci c inputs because the information returned is global to the system.
AIFSCPUT Modi es system con guration information AIFSCPUT Syntax AIFSCPUT(overall REC I32A status, itemnum array, @64A RECA item array, itemstatus array, I32 I32A user id, ver item nums, @64A RECA ver items, ver item statuses ) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFSCPUT itemstatus array Record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. user id Array type: status type 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
AIFSCPUT ver item statuses record array by reference (optional) An array where each element returns the status of the veri cation performed in the corresponding element in ver items. A zero indicates a successful veri cation. A negative value indicates an error condition. A positive value indicates a warning.
AIFSCGET/PUT Items AIFSCGET/PUT Items 3-222 The following two tables provide summary and detailed descriptions of the items numbers associated with system con guration information.
AIFSCGET/PUT Items Item Summary The following table summarizes the item numbers associated with system con guration information. For more detailed information about these item numbers, refer to the table of system con guration information item descriptions. Table 3-29.
AIFSCGET/PUT Items Table 3-29.
AIFSCGET/PUT Items Table 3-29.
AIFSCGET/PUT Items Table 3-29.
AIFSCGET/PUT Items Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with system con guration information.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions Item Number 3001 Item Name (Data Type) Put; Verify; Description Job fence (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the current jobfence on the system, a value in the range 0..14. If a job's input priority (INPRI) is higher than the system jobfence, that job attempts to log on. The jobfence can also be set using the JOBFENCE command. 3002 Job limit (I32) Put: Yes; Verify: Yes; Release 3.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3009 Item Name (Data Type) Put; Verify; Description Single user mode (B) Put: No; Verify: Yes; Release 3.0 Returns true if the system is in single-user mode, and false if the system is in multiuser mode. 3010 Out of resources (B) Put: No; Verify: Yes; Release 3.0 Returns true if a logon has failed because the needed resources were not available.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3016 Item Name (Data Type) Put; Verify; Description System logging mask (BA64) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es a packed array of 64 booleans indicating the system logging mask. True indicates that the logging type is on.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3021 Item Name (Data Type) Put; Verify; Description BS queue base (I32) Put: No; Verify: Yes; Release 3.0 Returns the base of the BS queue. This value is the highest priority that any process in the BS queue can have. This priority can be mapped to MPE V by the following formula: MPEVPri = (32767 - MPEiXPri) DIV 128 3022 (All formula values are decimal.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3028 Item Name (Data Type) Put; Verify; Description ES queue limit (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the ES queue limit. This value is the lowest priority that any process in the ES queue can have. It can also be set using the TUNE command.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3040 Item Name (Data Type) Put; Verify; Description Total number of DST entries (I32) Put: No; Verify: Yes; Release 3.0 Returns the total number of DST entries on the system. 3041 Available number of DST entries (I32) Put: No; Verify: Yes; Release 3.0 Returns the total number of unused DST entries on the system. 3042 Rounding factor (I32) Put: No; Verify: Yes; Release 3.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3051 Item Name (Data Type) Put; Verify; Description DS boost property (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the current boost property of the DS queue. Values and their meanings are as follows: 0 1 3052 Decay Oscillate DS queue timeslice (I32) Put: Yes; Verify: Yes; Release 3.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3059 Item Name (Data Type) Put; Verify; Description Maximum number of processors (I32) Put: No; Verify: Yes; Release 4.0 Returns the maximum number of processors allowed on the system. This number is system speci c and de ned by the OS. 3060 Autoboot toggle (B) Put: Yes; Verify: Yes; Release 4.0 Returns or modi es the autoboot ag in the PDC stable storage.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3071 Item Name (Data Type) Put; Verify; Description Machine type (CA80) Put: No; Verify: Yes; Release 5.0 Returns the hardware type on which the system is running. For example, Series 955. 3072 Network Node Name (CA256) Put: No; Verify: Yes; Release 5.0 Returns the node name of the system in the communication network. This is the local domain name used during NS Con guration in NMMGR.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3079 Item Name (Data Type) Put; Verify; Description FOPEN Logging Extension (B) Put: No; Verify: Yes; Release 5.0 Returns true when all FOPEN calls are logged and false for FOPEN FAILURE ONLY logging. This feature is set in the Global Security Options Menu of the HP Security Monitor. For more information see the MPE/iX Security Features System Manager's Guide .
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3085 Item Name (Data Type) Put; Verify; Description Password Expiration Warning (I32) Put: No; Verify: Yes; Release 5.0 Returns the warning interval in days for all user passwords that are set to expire on the next global expiration date. A valid range of values is 0 to 364 days. This feature is set in the Global Security Options Menu of the HP Security Monitor.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3090 Item Name (Data Type) Put; Verify; Description Maximum File Protection (B) Put: No; Verify: Yes; Release 5.0 Returns true when maximum le protection is enabled. When enabled, if no ACD is attached to a newly created le, a system default ACD is automatically de ned for the le.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3096 Item Name (Data Type) Put; Verify; Description Disabled User Timeout (B) Put: No; Verify: Yes; Release 5.0 Returns the user ID timeout value in seconds. When the timeout expires for the invalid user the Security process will enable the user. Changing this value does not impact any user timeouts currently in e ect. The valid range of values is 0 to 32766 seconds.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3103 Item Name (Data Type) Put; Verify; Description Upper job number limit (I32) Put: Yes; Verify: Yes; Release 5.0 Returns or modi es the upper limit of the range of job numbers to be assigned. Job numbers will be assigned outside of this range only when all job numbers within the range are in use.
AIFSCGET/PUT Items Table 3-30. System Configuration Information Item Descriptions (continued) Item Number 3109 Item Name (Data Type) Put; Verify; Description Lower output spoolid limit (I32) Put: Yes; Verify: Yes; Release 5.0 Returns or modi es the lower limit of the range of output spoolids to be assigned. Output spoolids will be assigned outside of this range only when all output spoolids within the range are in use.
AIFSPFGET Returns spool le information. AIFSPFGET Syntax REC I32A AIFSPFGET (overall status, itemnum array, @64 REC I32 spf addr, spf id, user id); Parameters overall status @64A RECA item array, itemstatus array, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFSPFGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. spf addr Array type: status_type (Refer to appendix B.
AIFSPFGET Operation Notes AIFSPFGET accepts as an input key a spool le ID and/or a spool le address, which identi es the spool le that the information is to be returned on. The spool le address is the faster mechanism of the two. If both are provided, the address and the spool le ID are checked against each other to make sure that they match the same spool le. If they don't match, the spool le ID will be used as it is the unique key while the spool le address is reusable and not unique.
AIFSPFGET AIFSPFGET Items 3-246 The following two tables provide summary and detailed descriptions of the item numbers associated with spool le information.
AIFSPFGET Item Summary The following table summarizes the item numbers associated with spool le information. For more detailed information about these item numbers, refer to the tables of AIFSPFGET and AIFSPFPUT item descriptions. Table 3-31.
AIFSPFGET Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with spool le information returned by AIFSPFGET. Table 3-32. AIFSPFGET Spool File Information Item Descriptions Item Number 8501 Item Name (Data Type) Release First Available Description File state (I32) Release 3.0 Returns the state of the spool le.
AIFSPFGET Table 3-32. AIFSPFGET Spool File Information Item Descriptions (continued) Item Number 8506 Item Name (Data Type) Release First Available Description Forms message? (I32) Release 3.0 Returns whether the spool le has a forms message associated with it. Valid only for output spool les. Values and their meanings are as follows: 0 1 8507 No forms message associated Yes forms message associated Incomplete? (I32) Release 3.0 Returns whether the spool le is incomplete.
AIFSPFGET Table 3-32. AIFSPFGET Spool File Information Item Descriptions (continued) Item Number 8513 Item Name (Data Type) Release First Available Description Ready time (REC) Release 3.0 Returns the time (hours/minutes/seconds/tenths of seconds) when the spool le was created. All elds are 0's if the spool le is not yet ready or is not out of the active/create state. The format returned in the 32-bit integer is the same as that returned by the CLOCK intrinsic.
AIFSPFGET Table 3-32. AIFSPFGET Spool File Information Item Descriptions (continued) Item Number 8519 Item Name (Data Type) Release First Available Description File designator (CA16) Release 3.0 Returns the formal le designator of the spool le. 8520 Target device (REC) Release 3.0 Returns the destination device name or device class for the spool le. Record type: device_name_type (Refer to appendix B.) 8521 Device record size (REC) Release 3.
AIFSPFGET Table 3-32. AIFSPFGET Spool File Information Item Descriptions (continued) Item Number 8529 Item Name (Data Type) Release First Available Description Number of sectors (I32) Release 3.0 Returns the number of sectors in the spool le. 8530 Environment File Name (CA36) Release 3.0 Returns the environment le name of the spool le. This eld is valid only if the system has not been rebooted since the le was created. Valid only for output spool les. 8531 Foptions (REC) Release 3.
AIFSPFLINK Programmatically executes the MPE/iX command SPOOLF spool id ;PRINT. AIFSPFLINK Syntax REC REC REC REC AIFSPFLINK (overall status, source spf, linked spf id, linked spf u d, REC I32 I32 I32 I32 target device, priority, copies, spsave, defer, CA I32 spf lockword, user id); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call.
AIFSPFLINK linked spf u d record by reference (optional) Returns the UFID of the spool le created and linked to the HPSPOOL account. Record type: ufid_type (Refer to appendix B.) target device Default: nil Record by reference (optional) Passes the device name used as the new target device for printing the spool le. Whether this parameter is speci ed or not, the spool le queue for the device must be open, or an error results. The device name should be left-justi ed and padded with blanks.
AIFSPFLINK defer 32-bit signed integer by value (optional) Passes the le state of newly created spool le. If defer is speci ed, the spool le is not printed. The default is not to defer the printing of the spool le. The values are as follows: 0 No defer 1 Yes defer spf lockword Default: 0 character array by reference (optional) Passes the lockword for spool le speci ed in source spf. Array type: pac16 (Refer to appendix B.
AIFSPFLINK To link a spool le for printing, the spool le must rst be copied to the HPSPOOL account and linked into the spool le directory. AIFSPFLINK provides both the copying and the linking as described. AIFSPFLINK works for both a linked or an unlinked spool le, but if a spool le is already linked, it is not necessary to call AIFSPFLINK to get extra copies of the spool le printed.
AIFSPFLIST Returns the virtual address and the spool le IDs of spool les that meet the speci ed selection criteria. AIFSPFLIST Syntax REC AIFSPFLIST (overall I32 REC @64A RECA status, seleq, spf addr array, spf id array, I32 B spf count, user id, stop search); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFSPFLIST spf addr array 64-bit address array by reference (optional) Returns virtual addresses speci c to the spool les qualifying the selection criteria. If more qualifying spool les are found than can be returned in this array, it is only lled to its maximum capacity. However, the total number of qualifying spool les found is returned in spf count . Array type: globalanyptr spf id array Default: nil record array by reference (optional) Returns the le IDs of the spool les selected.
AIFSPFLIST user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON . stop search Default: 0 Boolean by value (optional) If true, search will stop after spf count number of quali ed spool les have been found. Default is searching for all the quali ed spool les on the system.
AIFSPFPUT Modi es spool le information. AIFSPFPUT Syntax REC AIFSPFPUT (overall @64 I32A @64A RECA status, itemnum array, item array, itemstatus array, spf addr, RECA REC I32 I32A @64A spf id, user id, ver item nums, ver items, ver item statuses); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFSPFPUT item array 64-bit address array by reference (required) An array where each element is a 64-bit address pointing to a data structure containing new information to be passed to the operating system. Information and its required data type are de ned by the item number passed in the corresponding element in itemnum array.
AIFSPFPUT ver item nums 32-bit signed integer array by reference (optional) An array of integers where each element is an item number indicating the operating system information to be veri ed before proceeding with modi cation. Veri cation information must be located in a data structure pointed to by the corresponding element in ver items . If n items are being veri ed, element n +1 must be a zero to indicate the end of the item list.
AIFSPFPUT Operation Notes AIFSPFPUT accepts a spool le ID or spool le address that identi es the spool le and modi es the information in the spool le directory and le label extension. If both the address and the spool le ID are provided, they are checked against each other to make sure that they match the same le. If they don't match, the spool le ID will be used as it is the unique key while the spool le address is reusable and not unique.
AIFSPFPUT AIFSPFPUT Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with spool le information modi ed by AIFSPFPUT. Table 3-33. AIFSPFPUT Spool File Information Item Descriptions Item Number 8501 Item Name (Data Type) Put; Verify; Release First Available Description File state (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the state of the spool le.
AIFSPFPUT Table 3-33. AIFSPFPUT Spool File Information Item Descriptions (continued) Item Number 8504 Item Name (Data Type) Put; Verify; Release First Available Description Disposition (I32) Put: Yes; Verify: Yes; Release 3.0 Indicates whether the spool le is to be saved or purged after it has been printed. It is illegal to change the disposition of a private spool le to save. Values and their meanings are as follows: 1 2 8507 Save Purge Incomplete? (I32) Put: Yes; Verify: Yes; Release 3.
AIFSPFPUT Table 3-33. AIFSPFPUT Spool File Information Item Descriptions (continued) Item Number 8513 Item Name (Data Type) Put; Verify; Release First Available Description Ready time (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the time (hours/minutes/seconds/tenths of seconds) when the spool le was created.This item cannot be modi ed if the le is in the create or active state. The format passed in the 32-bit integer is the same as that returned by the CLOCK intrinsic.
AIFSPFPUT Table 3-33. AIFSPFPUT Spool File Information Item Descriptions (continued) Item Number 8519 Item Name (Data Type) Put; Verify; Release First Available Description Spool le designator (CA16) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the formal le designator of the spool le. The le designator should be upshifted, left-justi ed, and padded with blanks. 8520 Target device (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modi es the destination logical device for the spool le.
AIFSPPGET Returns spooler process information. AIFSPPGET Syntax REC I32A AIFSPPGET (overall status, itemnum REC I32 spooler device, user id); Parameters overall status @64A RECA array, item array, itemstatus array, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFSPPGET itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. spooler device Array type: status_type (Refer to appendix B.
AIFSPPGET AIFSPPGET Items 3-270 The following two tables provide summary and detailed descriptions of the item numbers associated with spooler process information.
AIFSPPGET Item Summary The following table summarizes the item numbers associated with spooler process information. For more detailed information about these item numbers, refer to the tables of AIFSPPGET and AIFSPPPUT spooler process information item descriptions. Table 3-34.
AIFSPPGET Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with spooler process information returned by AIFSPPGET. Table 3-35. AIFSPPGET Spooler Process Information Item Descriptions Item Number 8001 Item Name (Data Type) Release First Available Description LDEV number (I32) Release 3.0 Returns the LDEV number of the speci ed device. 8002 Process PIN (I32) Release 3.
AIFSPPGET Table 3-35. AIFSPPGET Spooler Process Information Item Descriptions (continued) Item Number 8006 Item Name (Data Type) Release First Available Description Finishing strategy (I32) Release 3.0 Returns the nishing strategy of the device. This is one of the options that can be speci ed for the SPOOLER nn ;STOP/SUSPEND command. It is only valid when the spooler process is being suspended or stopped.
AIFSPPOPENQ Opens the spool queue for the speci ed logical device number (LDEV), device name, or device class. AIFSPPOPENQ Syntax REC AIFSPPOPENQ (overall Parameters REC I32 status, spooler device, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFSPPPUT Modi es spooler process information. AIFSPPPUT Syntax REC I32A @64A RECA AIFSPPPUT (overall status, itemnum array, item array, itemstatus REC I32 I32A @64A spooler device, user id, ver item nums, ver items, RECA ver item statuses) Parameters overall status array, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFSPPPUT itemstatus array record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values. spooler device Array type: status_type (Refer to appendix B.
AIFSPPPUT ver items 64-bit address array by reference (optional) An array where each element is a 64-bit address pointing to a data structure containing information to be veri ed against current operating system information. Information and its required data type are de ned by the item number passed in the corresponding element in ver item nums .
AIFSPPPUT Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with spooler process information modi ed by AIFSPPPUT. Table 3-36. AIFSPPPUT Spooler Process Information Item Descriptions Item Number 8009 Item Name (Data Type) Release First Available Description Device outfence (I32) Release 3.0 Modi es the outfence of the device. Values are in the range 1..14.
AIFSPPRELEASE AIFSPPRELEASE Releases the spool le that is currently kept by the speci ed suspended spooler. Syntax REC REC AIFSPPRELEASE (overall status, spooler I32 I32 q state, user id); Parameters overall status I32 I32 device, direction, o set, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFSPPRELEASE o set 32-bit signed integer by value (optional) Passes a value representing a page o set, either absolute or relative, within the spool le. Together with the direction parameter, it tells the spooler where to resume when the le is picked up again for printing. If absolute is speci ed in direction , printing resumes at that page, absolute from the beginning of the le.
AIFSPPRELEASE Operation Notes AIFSPPRELEASE closes the spool le and returns it to the ready state. An o set may be speci ed to change the resumption point of the spool le the next time it is selected for printing. AIFSPPRELEASE is the programmatic interface for executing the command SPOOLER dev ;RELEASE.
AIFSPPRESUME AIFSPPRESUME Resumes a suspended spooling process. Syntax REC REC AIFSPPRESUME (overall status, spooler I32 I32 q state, user id) Parameters overall status I32 I32 device, direction, o set, record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFSPPRESUME o set 32-bit signed integer by value (optional) Passes a value representing a page o set, either absolute or relative, within the spool le. Together with the direction parameter, it tells the spooler where to resume when the le is picked up again for printing. If absolute is speci ed in direction , printing resumes at that page, absolute from the beginning of the le.
AIFSPPRESUME Operation Notes 3-284 The spooler must be in the suspend state. If the spooler retained a spool le when it was suspended and the spool le was not subsequently released, the o set parameter can be speci ed. If it is not speci ed, output resumes where it was left o . AIFSPPRESUME is the programmatic interface for executing the commands RESUMESPOOL and SPOOLER dev ;RESUME.
AIFSPPSHUTQ Closes the spool queue for the speci ed logical device number, device name, or device class. AIFSPPSHUTQ Syntax REC AIFSPPSHUTQ (overall Parameters REC I32 status, spooler device, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.
AIFSPPSTART Creates and activates a new spooler process to handle spool les destined for the speci ed logical device number, device name, or device class. AIFSPPSTART Syntax REC AIFSPPSTART (overall status, Parameters REC I32 I32 spooler device, q state, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFSPPSTART user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON . Default: 0 Operation Notes An Openq is done by default when AIFSPPSTART is invoked, unless the q state parameter speci es Shutq. AIFSPPSTART is the programmatic interface for executing the commands STARTSPOOL and SPOOLER dev ;START.
AIFSPPSTOP Terminates spooling to the speci ed logical device number, device name, or device class. The spooling processes associated with the devices are also terminated. AIFSPPSTOP Syntax REC AIFSPPSTOP (overall status, Parameters REC I32 I32 I32 spooler device, nish, q state, user id); overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call.
AIFSPPSTOP q state 32-bit signed integer by reference (optional) Passes a value that indicates whether the spooling queue is to remain open or disabled when the spooling process terminates. The default is Shutq for terminating a spooler process. If Openq is speci ed, it allows users to generate spool les on that device even when the spooling process has been terminated.
AIFSPPSUSPEND AIFSPPSUSPEND Suspends the spooling processes for the speci ed logical device number, device name, or device class. Associated spooler processes remain alive, but inactive. Syntax REC REC AIFSPPSUSPEND (overall status, spooler I32 I32 I32 o set, q state, user id); Parameters overall status device, I32 I32 I32 nish, keep, direction, record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFSPPSUSPEND keep 32-bit signed integer by reference (optional) Passes a value that tells the spooler whether to retain ownership of the currently printing spool le or to close the le and return it to the ready state. The valid inputs and their meanings are as follows: 1 Keep (default) 2 No keep Do not pass both the nish end of copy and the Keep ags. Also, do not pass nish-end-of-copy and pass a non-zero o set.
AIFSPPSUSPEND q state 32-bit signed integer by reference (optional) Passes a value that indicates whether the spooling queue is to be opened or disabled when the spooling process is suspended. The default is not to change the current q state of the spooler process.
AIFSYSWIDEGET AIFSYSWIDEGET Returns system information (for example, PIDs and UFIDs) to be used as input keys by other AIFs to access more detailed information. Syntax REC I32 A A AIFSYSWIDEGET (overall status, aif area, return array1, return array2, I32 I32A @64A num entries, itemnum array, item array, RECA REC I32 itemstatus array, search key, user id, @64 bu er ptr); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call.
AIFSYSWIDEGET return array1 array by reference (optional) Returns system information keys (for example, PIDs and UFIDs). The keys can also be used by other AIFs to access more detailed information associated with the key. The size and type of key is dependent on the information area speci ed in aif area . The size and type of keys are speci ed in Table 3-37. If a nil address (the default value) is passed, no keys are returned.
AIFSYSWIDEGET itemnum array 32-bit signed integer array by reference (optional) An array of integers where each element is an item number indicating the class of selection criteria located in the corresponding element in item array . Valid items depend upon the information area speci ed in aif area . For example, if information is desired about processes, then the criteria may be process-state, capabilities, and so on.
AIFSYSWIDEGET search key record by reference (optional) In the event that return array1 and return array2 are not large enough to contain all the returned values of the speci ed criteria, a search key is returned. On a subsequent call to AIFSYSWIDEGET, the search key eliminates duplicating values that have already been returned. No search key is returned for spool les. The initialization value of search key is determined by the information area speci ed in aif area prior to the rst call to AIFSYSWIDEGET .
AIFSYSWIDEGET Operation Notes The following information is speci ed in Table 3-37: A value corresponding to each speci ed information area to be passed in the aif area parameter. The data type required to be passed in return array1 and/or return array2 that corresponds to the information area speci ed in the aif area parameter. The data type and initialization value to be passed in the search key parameter. The search key for ascii strings must be initialized to blanks. Table 3-37.
AIFSYSWIDEGET Refer to appendix B for descriptions of the indicated data types. If a criteria item is of type integer, a range of values can be requested by passing the same criteria item number in consecutive elements of itemnum array , and passing the lower and upper limits in the corresponding consecutive elements of item array . The rst value must be the lower limit (>=) and the second value the upper limit (<=).
AIFSYSWIDEGET The information in this return array can be used to index directly into the bu er of pathnames if you wish to perform binary searches for example. It can also be used in conjunction with a Pascal STRMOVE to easily retrieve a pathname from the bu er.
AIFSYSWIDEGET If the leset begins with a ./, then the pathname is assumed to be a relative pathname. Operation Notes - HFS Directory Security With the new AIFSYSWIDEGET HFS le item, you must have the appropriate security access rights to traverse (TD - traverse directory) and read (RD - read directory) directories protected by an ACD. This is because the lower level directory traversal routines enforce security checking.
AIFSYSWIDEGET Some errors (for example, bad UFID) will now only be detected if you pass in criteria such as record type or le type which requires AIFSYSWIDEGET to retrieve the le label pointer and look in the le label for a matching criteria. This is like doing a LISTFILE as compared to a LISTFILE,-3 (for example, LISTFILE,-3 will report an error when there is a bad UFID, but LISTFILE will not). This change will improve performance since there is no need to go to the le label in all cases.
AIFSYSWIDEGET Programming Examples Example Three - Number of output spool files Following is an example of a call to AIFSYSWIDEGET to obtain the number of output spool les with priority greater than 7.
AIFSYSWIDEGET Programming Examples Example Five - Configured devices for a device class Following is an example of a call to AIFSYSWIDEGET to obtain a list of con gured devices for a device class.
AIFSYSWIDEGET Programming Examples Example Seven - Configured devices on the system Following is an example of a call to AIFSYSWIDEGET to obtain a list of con gured devices on the system.
AIFSYSWIDEGET Item Descriptions The following tables provide detailed descriptions of the item numbers associated with system wide information. AIFSYSWIDEGET Item Descriptions Job/Session Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with job/session criteria used by AIFSYSWIDEGET . Table 3-38.
AIFSYSWIDEGET Item Descriptions Table 3-38. AIFSYSWIDEGET Job or Session Criteria Item Descriptions (continued) Item Number 1008 Item Name (Data Type) Range Capability; Release First Available Description Output priority (I32) Range capability: Yes; Release 3.0 Passing this criteria returns the job/session keys and/or job/session numbers of jobs/sessions whose output priorities (OUTPRI) equal the speci ed criteria value(s). A value must be in the range 0..14.
AIFSYSWIDEGET Item Descriptions Table 3-38. AIFSYSWIDEGET Job or Session Criteria Item Descriptions (continued) Item Number 1039 Item Name (Data Type) Range Capability; Release First Available Description Session? (B) Range capability: No; Release 3.0 Passing this criteria returns the job/session keys and/or job/session numbers of either jobs or sessions. Values and their meanings are as follows: False True 1043 Jobs Sessions HP DTC Portid (CA17) Put:No; Verify:Yes; Release 4.
AIFSYSWIDEGET Item Descriptions Process Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with process criteria used by AIFSYSWIDEGET . Table 3-39. AIFSYSWIDEGET Process Criteria Item Descriptions Item Number 2015 Item Name (Data Type) Range capability; Release First Available Description Job/session number (REC) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions Table 3-39. AIFSYSWIDEGET Process Criteria Item Descriptions (continued) Item Number 2017 Item Name (Data Type) Range capability; Release First Available Description Scheduling queue (I32) Range capability: Yes; Release 3.0 Passing this criteria returns the PIDs of processes belonging to the speci ed scheduling queue(s).
AIFSYSWIDEGET Item Descriptions Table 3-39. AIFSYSWIDEGET Process Criteria Item Descriptions (continued) Item Number 2065 Item Name (Data Type) Range capability; Release First Available Description Open le (REC) Range capability: No; Release 3.0 Passing this criteria returns the PIDs of processes accessing the speci ed le. Valid only for NM les. Record type: ufid_type (Refer to appendix B.) 2070 Capabilities (I32) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions File Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with le criteria used by AIFSYSWIDEGET . Table 3-40. AIFSYSWIDEGET File Criteria Item Descriptions Item Number 5001 Item Name (Data Type) Range capability; Release First Available Description MPE le name (REC) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions Table 3-40. AIFSYSWIDEGET File Criteria Item Descriptions (continued) Item Number 5039 Item Name (Data Type) Range capability; Release First Available Description File type (U32) Range capability: No; Release 4.5 Passing this criteria returns the les (MPE lename or HFS pathname) and unique le identi ers (UFID or path identi er) of all les whose le type meets the speci ed criteria.
AIFSYSWIDEGET Item Descriptions Table 3-40. AIFSYSWIDEGET File Criteria Item Descriptions (continued) Item Number 5050 Item Name (Data Type) Range capability; Release First Available Description Ignore non-fatal errors? (B) Range capability: No; Release 5.0 Speci es whether or not the directory traversal should continue even if an non-fatal error is detected. An example of a non-fatal error is if a bad UFID is detected of if the user does not have the appropriate security (no TD) to traverse a directory.
AIFSYSWIDEGET Item Descriptions Accounting Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with accounting criteria used by AIFSYSWIDEGET . Table 3-41. AIFSYSWIDEGET Accounting Criteria Item Descriptions Item Number 6001 Item Name (Data Type) Range capability; Release First Available Description User name (CA16) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions Table 3-41. AIFSYSWIDEGET Accounting Criteria Item Descriptions (continued) Item Number 6008 Item Name (Data Type) Range capability; Release First Available Description Local attributes (I32) Range capability: No; Release 3.0 Passing this criteria returns the directory names whose group user-de nable attributes equal the speci ed criteria value. Criteria items 6001 and 6201 must also be speci ed. 6101 Group name (CA16) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions Table 3-41. AIFSYSWIDEGET Accounting Criteria Item Descriptions (continued) Item Number 6201 Item Name (Data Type) Range capability; Release First Available Description Account name (CA16) Range capability: No; Release 3.0 Passing this criteria returns the directory names whose account names equal the speci ed criteria value. The format is a 16-byte character array containing the identi er of the account name (left-justi ed and padded with blanks).
AIFSYSWIDEGET Item Descriptions Spool File Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with spool le criteria used by AIFSYSWIDEGET . Table 3-42. AIFSYSWIDEGET Spool File Criteria Item Descriptions Item Number 8501 Item Name (Data Type) Range capability; Release First Available Description File state (I32) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions Table 3-42. AIFSYSWIDEGET Spool File Criteria Item Descriptions (continued) Item Number 8509 Item Name (Data Type) Range capability; Release First Available Description STDLIST of aborted job (I32) Range capability: No; Release 3.
AIFSYSWIDEGET Item Descriptions Table 3-42. AIFSYSWIDEGET Spool File Criteria Item Descriptions (continued) Item Number 8517 Item Name (Data Type) Range capability; Release First Available Description Job/session # (REC) Range capability: No; Release 3.0 Passing this criteria returns the spool le address and/or spool le number of spool les whose creator job/session numbers equal the speci ed criteria value.
AIFSYSWIDEGET Item Descriptions Table 3-42. AIFSYSWIDEGET Spool File Criteria Item Descriptions (continued) Item Number 8528 Item Name (Data Type) Range capability; Release First Available Description Number of records (I32) Range capability: Yes; Release 3.0 Passing this criteria returns the spool le address and/or spool le number of spool les with the number of records equal to the speci ed criteria value(s).
AIFSYSWIDEGET Item Descriptions Device Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with device criteria used by AIFSYSWIDEGET . Table 3-43. AIFSYSWIDEGET Device Criteria Item Descriptions Item Number 13001 Item Name (Data Type) Range Capability; Release First Available Description Logical Device Number (I32) Range Capability: Yes; Release 4.0 This is the LDEV number for the device.
AIFSYSWIDEGET Item Descriptions Device Class Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with device class criteria used by AIFSYSWIDEGET . Table 3-44. AIFSYSWIDEGET Device Criteria Item Descriptions Item Number 13501 Item Name (Data Type) Range Capability; Release First Available Description Logical Device Number (I32) Range Capability: Yes; Release 4.0 This is the LDEV number for the device.
AIFSYSWIDEGET Item Descriptions Console Reply Information Criteria Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with console reply criteria used by AIFSYSWIDEGET. Table 3-45. AIFSYSWIDEGET Console Reply Information Criteria Item Descriptions Item Number 14002 Item Name (Data Type) Range Capability; Release First Available Description Process Type (I32) Range capability:No; Release 4.
AIFSYSWIDEGET Item Descriptions Workgroup Criteria Item Descriptions The following table provides detailed descriptions of the item numbers and corresponding items associated with the new criteria, workgroup used by AIFSYSWIDEGET . The return value for the workgroup area is workgroup name(s). Table 3-46.
AIFSYSWIDEGET Item Descriptions Table 3-46. AIFSYSWIDEGET Workgroup Criteria Item Descriptions (continued) Item Number 19006 Item Name, Data Type, and Description Queue (I32) Range capability: Yes Passing this criteria returns all the workgroups that have the speci ed queue as one of its membership criteria.
AIFSYSWIDEGET Item Descriptions Table 3-46. AIFSYSWIDEGET Workgroup Criteria Item Descriptions (continued) Item Number 19009 Item Name, Data Type, and Description Minimum Quantum (I32) Range capability: Yes Passing this criteria returns all the workgroups that have the speci ed minimum quantum value(s). Values for minimum quantum range from 0 to 32767 milliseconds.
AIFSYSWIDEGET Item Descriptions Table 3-46. AIFSYSWIDEGET Workgroup Criteria Item Descriptions (continued) Item Number 19013 Item Name, Data Type, and Description Minimum CPU Percentage (I32) Range capability: Yes Passing this criteria returns all the workgroups that have the speci ed Minimum CPU Percentage value(s). The value can range from 0% to 100%.
AIFTIME Converts ticks or microseconds to a meaningful time such as date time, clock time, or a string format. AIFTIME Syntax REC REC REC REC AIFTIME (overall status, ticks, microsecs, clock, REC REC I32 REC date, date str, user id, ticks since 1970, REC microsecs since 1970); Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call.
AIFTIME date record by reference (optional) Returns the time in year, month, and day of month. date str Record type: date_type (Refer to appendix B.) record by reference (optional) user id Returns the time in string format for month and day of the week. Record type: datestr_type (Refer to appendix B.) 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
AIFWGADD Adds a new workgroup to the current list of workgroups. AIFWGADD Syntax AIFWGADD(overall REC I32A status, itemnum array, @64A RECA CA item array, itemstatus array, workgroup name, CA I32 position, user id ) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFWGADD itemstatus array Record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. workgroup name Array type: status type 256-byte character array by reference (required) Passes the name of the workgroup to be added.
AIFWGADD Operation Notes AIFWGADD adds a new workgroup in the current list of workgroups. When creating a new workgroup, it is necessary to specify one of the membership criteria and the required scheduling characteristics of Base and Limit. The rest of the membership criteria or scheduling characteristics can either be speci ed or allowed to take their default values. Table 4-6 provides detailed description of items.
AIFWGADD Workgroup Information Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFWGADD Table 3-47. AIFWGADD Item Descriptions Item Number 19003 Item Name, Data Type, and Description Logon/User speci cation (CA256); Passes the logon category of the new workgroup. The logon membership criteria speci es the job/session, user and account name (LOGON = [job/sessionname,]username.accountname ) of potential workgroup members.
AIFWGADD Table 3-47. AIFWGADD Item Descriptions (continued) Item Number 19007 Item Name, Data Type, and Description Base priority (I32); Passes the base priority of the speci ed workgroup. This value is the highest priority that any process which is a member of this workgroup can have. Can be set for any user-de ned workgroups. This priority can be mapped to MPE V by the following formula: MPEVPri = (32767 - MPE/iXPri) DIV 128 (All formula values are decimal.
AIFWGADD Table 3-47. AIFWGADD Item Descriptions (continued) Item Number 19013 Item Name, Data Type, and Description Maximum CPU Percentage (I32); Passes the upper bound for the amount of CPU the processes in a workgroup can consume relative to to other workgroups. The value can range from 0% to 100%. The default value is 100%. The maximum CPU percentage control may result in system idling if the workgroup hits its maximum CPU percentage and there are no other users who want CPU.
AIFWGGET Returns workgroup information about a particular workgroup. AIFWGGET Syntax AIFWGGET(overall REC I32A status, itemnum array, @64A RECA CA I32 item array, itemstatus array, workgroup name, user id) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFWGGET workgroup name 256-byte character array by reference (required) user id Passes the name of the workgroup for which information is desired. The workgroup name follows the convention for CI variables and Job Control Words(JCW's) and can be a maximum of 255 alphanumeric characters or underscores, where the rst character cannot be numeric. The user-speci ed name (including case) is preserved, though comparisions are case insensitive. The workgroup name is terminated by a NULL character (ASCII 0).
AIFWGPURGE Purges a workgroup from the current list of workgroups. AIFWGPURGE Syntax REC CA AIFWGPURGE(overall status, workgroup name, B I32 purgescan, user id ) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFWGPURGE user id 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON. Default: 0 Operation Notes AIFWGPURGE deletes a workgroup from the current list of workgroups. A user can call AIFWGPURGE with the default \scan" option and the last call of AIFWGPURGE with purge-pending scan option.
AIFWGPUT Modi es workgroup information. AIFWGPUT Syntax AIFWGPUT(overall REC I32A status, itemnum array, @64A RECA CA I32 I32A @64A item array, itemstatus array, workgroup name, user id, RECA ver item nums, ver items, ver item statuses ) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not speci c to any particular item.
AIFWGPUT itemstatus array Record array by reference (required) An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. workgroup name Array type: status type 256-byte character array by reference (required) user id Passes the name of the workgroup whose information is to be modi ed.
AIFWGPUT ver items 64-bit address array by reference (optional) An array where each element is a 64-bit address pointing to a data structure containing information to be veri ed against current operating system information. Information and its required data type are de ned by the item number passed in the corresponding element in ver item nums.
Workgroup Items Workgroup Information Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with Workload Manager workgroup information.
Workgroup Items Table 3-48. Workgroup Information Item Descriptions Item Number 19002 Item Name, Data Type, and Description Purge Pending? (B) Put: No; Verify: Yes Returns a boolean value denoting whether a purge is pending for the indicated workgroup. When a workgroup is purged, the Workload Manager will need to rescan the a ected member processes. 19003 Logon/User speci cation (CA256) Put: No; Verify: Yes Returns the logon category of the speci ed workgroup.
Workgroup Items Table 3-48. Workgroup Information Item Descriptions (continued) Item Number 19007 Item Name, Data Type, and Description Base priority (I32) Put: Yes; Verify: Yes Returns or modi es the base priority of the speci ed workgroup. This value is the highest priority that any process which is a member of this workgroup can have. Can modify for any user-de ned workgroups, or the CS Default, DS Default, and ES Default workgroups; cannot modify the AS Default or BS Default workgroups.
Workgroup Items Table 3-48. Workgroup Information Item Descriptions (continued) Item Number 19011 Item Name, Data Type, and Description Timeslice (I32) Put: Yes; Verify: Yes Returns or modi es the maximum amount of CPU time that can be consumed by a member of the speci ed workgroup before being timesliced (yielding the CPU). This value is accurate to 100-millisecond granularity and has a minimum value of 100 milliseconds.
AIFWGREPLACE AIFWGREPLACE Replaces the current set of workgroup(s) by a new set of workgroup(s) speci ed in the le. Syntax REC I32 I32A AIFWGREPLACE(overall status, le num, itemnum array, @64A RECA I32 item array, itemstatus array, user id ) Parameters overall status record by reference (required) Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning.
AIFWGREPLACE itemstatus array Record array by reference (optional) user id An array where each element returns the status of the operation performed in the corresponding element in item array. A zero indicates a successful operation. A negative value indicates an error condition. 32-bit signed integer by value (optional) The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
AIFWGREPLACE The speci cation for an individual workgroup is given below.
AIFWGREPLACE Below is an example of a le that de nes workgroups: WORKGROUP=Program_Development ;MEMB_PROGRAM=(EDITOR.PUB.SYS; QEDIT.@.@; HPEDIT.@.@) ;MEMB_LOGON=(MORNING,@.TEST; @.MYTEST) ;BASE=160 ;LIMIT=170 WORKGROUP=Payroll_Online ;MEMB_PROGRAM=(PAYROLL.@.PRAPP) ;QUEUE=CS ;BASE=152 ;LIMIT=200 ;BOOST=OSCILLATE WORKGROUP=Payroll_Batch ;MEMB_PROGRAM=(PAYROLL.@.
AIFWGREPLACE Workgroup Information Item Descriptions The following table provides detailed descriptions of item numbers and corresponding items associated with AIFWGREPLACE Table 3-49. AIFWGREPLACE Item Descriptions Item Number 19501 Item Name, Data Type, and Description Output Bu er (REC); Returns the pointer to the bu er in the le where the CI error occured. Record type: bu er type. The maximum size of n which is user-de ned is 512.
A AIF Status Messages Item Status Messages -1 -2 -3 -4 -5 -6 -7 MESSAGE Read probe failed. CAUSE Caller does not have read access to a virtual address. ACTION Check for uninitialized pointers. MESSAGE Write probe failed. CAUSE Caller does not have write access to a virtual address. ACTION Check for uninitialized pointers. MESSAGE Read nonscalar probe failed. CAUSE Caller does not have read access to a series of pages in VSM. ACTION Check for uninitialized pointers and counts.
AIF Status Messages -8 -9 A-2 MESSAGE Array over ow. CAUSE The dynamic length array passed in was too small to hold all values. ACTION Use AIFSCGET to obtain upper bounds on array sizes required. MESSAGE Internal Error. Unable to lock data that needed to be accessed. CAUSE An unexpected error occurred because another process had the data structures locked. ACTION Change the logic of application to check for this error and restart AIF call.
AIF Status Messages Overall Status Messages -20 -21 -22 -23 -24 -25 -26 -27 MESSAGE Veri cation arrays wrongly speci ed. CAUSE Veri cation arrays to PUT were incorrectly speci ed. ACTION Pass all 3 or none. MESSAGE Bad overall status. CAUSE The overall status was inaccessible for write access. ACTION Check for uninitialized pointers. MESSAGE Bad item status. CAUSE The item status was inaccessible for write access. ACTION Check for uninitialized pointers.
AIF Status Messages -28 -29 -30 -31 -32 -33 -34 -35 A-4 MESSAGE Invalid JSNum. CAUSE The job/session speci ed does not exist. ACTION Verify if the JSNum exists. MESSAGE PID PIN mismatch encountered. CAUSE The PID process has died and a new process with same PIN was born. ACTION Check the PID and the PIN. MESSAGE Process has died. CAUSE No process with this PIN exists on the system. ACTION Check the PIN. MESSAGE The process is not of type user, or son, or CI.
AIF Status Messages -36 -37 -38 -39 -40 -41 -42 -43 MESSAGE Not a user le. CAUSE Attempted to PUT to a le with designator, not user. ACTION Check the le designator. MESSAGE A directory object was encountered. CAUSE Attempted to PUT to a le that is actually a Dir. object. ACTION Check for Dir Obj. in AIFFILEGET. MESSAGE Parameter 1 was badly aligned. CAUSE Parameter 1 was not aligned on a word (4-byte) boundary. ACTION Check for uninitialized pointers.
AIF Status Messages -45 -46 -47 -48 -49 -50 -51 -52 A-6 MESSAGE Return array1 write probe failed. CAUSE User does not have write access to the array passed in. ACTION Check for uninitialized pointers and num array entry . MESSAGE Return array2 write probe failed. CAUSE User does not have write access to the array passed in. ACTION Check for uninitialized pointers and num array entry . MESSAGE Invalid AIF key. CAUSE AIFSYSWIDEGET did not recognize the aif area key.
AIF Status Messages -53 -54 -55 -56 -57 -58 -59 -60 MESSAGE Bad pointer was encountered for parameter 3. CAUSE The address passed was inaccessible to the caller. ACTION Pass only addresses in accessible spaces. MESSAGE Bad pointer was encountered for parameter 4. CAUSE The address passed was inaccessible to the caller. ACTION Pass only addresses in accessible spaces. MESSAGE AIFCLOSE failed.
AIF Status Messages -61 -63 -64 -65 -66 -67 -68 -69 A-8 MESSAGE Unable to access the le AIFKUF.PUB.SYS. CAUSE The le is deleted, or there is not enough disk space to create it. ACTION Create enough disk space, if needed. Reboot the machine. MESSAGE Parameter 5 was badly aligned. CAUSE Parameter 5 was not aligned on a word (4-byte boundary). ACTION Check for proper alignment before calling the AIF. MESSAGE Parameter 5 not accessible to caller.
AIF Status Messages -70 -71 -72 -73 -74 -75 -76 -77 MESSAGE Cannot traverse the directory; a directory le has been opened exclusively. CAUSE A directory is opened exclusively, which is preventing directory traversal. ACTION Re-run the application when the directory le has been closed. MESSAGE Incorrect pathname syntax. CAUSE The user has speci ed a pathname which is not a valid syntax.
AIF Status Messages -78 -79 -81 -82 -83 -84 -85 -86 A-10 MESSAGE Could not retrieve the user entry from the HPUID.PUB.SYS le. CAUSE The user entry could not be found in the HPUID.PUB.SYS le. ACTION Update the HPUID.PUB.SYS le with the PXUTIL.PUB.SYS utility. MESSAGE Could not retrieve the group entry from the HPGID.PUB.SYS le. CAUSE The group entry could not be found in the HPGID.PUB.SYS le. ACTION Update the HPGID.PUB.SYS le with the PXUTIL.PUB.SYS utility.
AIF Status Messages -89 -90 -91 -101 -102 -103 -104 -105 -106 MESSAGE Error occurred when trying to get le label for this le. UFID may be bad. CAUSE The UFID passed to AIFSYSWIDEGET may be bad. ACTION Check to see if the le exists. MESSAGE An error occurred while trying to obtain ownershop of the device. CAUSE The device is not currently available for use. ACTION Check device. Contact Hewlett-Packard for support. MESSAGE An error occurred while trying to release device ownership.
AIF Status Messages -107 -108 -109 -110 -111 -112 -113 -114 -115 A-12 MESSAGE Speci ed port ID is not valid. CAUSE The Port is either not open or is invalid. ACTION Check the logic of your application. MESSAGE Attempted to send a message on Port not opened for Send access. CAUSE The calling process does not have the Port open for Send access. ACTION Check the logic of your application. MESSAGE Attempted to receive a message from Port not open for Receive access.
AIF Status Messages -116 -117 -125 -126 -127 -128 -129 -130 MESSAGE Invalid password. CAUSE The named port exists, but the password supplied does not match. ACTION Check the logic of your application. MESSAGE Internal error. CAUSE The port does not exist. ACTION Perform a dump. Contact Hewlett-Packard for support. MESSAGE Itemnums, Items, and Itemstatus not speci ed together. CAUSE Must pass item option arrays as a triple. All or none. ACTION Check the logic of your application.
AIF Status Messages -900 thru -942 -943 -944 -945 -946 -947 -948 -949 thru -999 A-14 MESSAGE Internal Error. CAUSE An unexpected internal error occurred. ACTION Contact Hewlett-Packard for support. MESSAGE Internal Error. CAUSE Security Internal error returned from the FS SEC ACCESS routine. ACTION Contact Hewlett-Packard for support. MESSAGE Internal Error. CAUSE An unexpected error occurred from the hierarchical directory routines. ACTION Contact Hewlett-Packard for support.
AIF Status Messages Job/Session Information Status Messages -1001 -1002 -1003 -1004 -1005 -1006 -1007 MESSAGE Invalid item number passed in itemnum array to AIFJSGET . CAUSE A non-zero, invalid item number was passed in itemnum array . ACTION Pass an appropriate value and end with a zero. MESSAGE Invalid item number passed in ver item nums to AIFJSPUT . CAUSE A non-zero, invalid item number was passed in ver item nums . ACTION Pass an appropriate value and end with a zero.
AIF Status Messages -1008 -1009 -1010 -1011 -1012 -1013 A-16 MESSAGE Output Priority not in the range 0-14. CAUSE The output priority value was not in the range 0-14. ACTION Use a value from 0 to 14 when setting the output priority. MESSAGE Executing Priority not equal to 100, 150, 200, or 250. CAUSE The executing priority value was not equal to 100, 150, 200, or 250. ACTION Use a value equal to 100, 150, 200, or 250 for executing priority.
AIF Status Messages Process Information Status Messages -2001 -2002 -2003 -2005 -2006 -2007 -2008 -2009 MESSAGE Invalid item number passed in itemnum array to AIFPROCGET. CAUSE A non-zero invalid item number was passed in itemnum array. ACTION Pass an appropriate value and end with a zero. MESSAGE Invalid item number passed in itemnum array to AIFPROCPUT. CAUSE A non-zero invalid item number was passed in itemnum array. ACTION Pass an appropriate value and end with a zero.
AIF Status Messages -2010 -2011 -2012 -2013 A-18 MESSAGE Priority - scheduling class mismatch. CAUSE Priority and scheduling class should match the global limits. ACTION Check for uninitialized pointers and counts and correct range. MESSAGE Invalid capability mask. CAUSE Attempt was made to change to invalid capability mask. ACTION Capability mask must have only lower 16 bits turned on. MESSAGE Invalid general resources mask. CAUSE Attempt was made to change to invalid resource mask.
AIF Status Messages AIFCHANGELOGON Status Messages -2501 MESSAGE CAUSE ACTION -2502 -2503 -2504 -2510 Logon string or logon desc parameter required. Caller must specify either the logon cmd parameter or the logon desc parameter. Change the call to supply either the logon cmd , logon desc parameter, or both. MESSAGE Probe failed (logon desc ). CAUSE Caller does not have write access to logon desc . ACTION Check call.
AIF Status Messages -2511 -2515 -2516 -2517 -2518 -2519 A-20 MESSAGE No termination character (logon cmd ). CAUSE The caller did not terminate the logon string with a valid string terminator character. (Either a NUL or a CR is required). ACTION Check call. You must terminate the logon cmd parameter with either a NUL character (value=0) or a carriage return (value=13). Note that the maximum length for the logon cmd parameter is 256 bytes.
AIF Status Messages -2520 -2521 -2522 +2523 +2524 +2525 +2526 MESSAGE Invalid account password speci ed. CAUSE An invalid account password was speci ed. ACTION You speci ed an invalid password for the target account. Specify the correct password. MESSAGE Invalid user password speci ed. CAUSE An invalid user password was speci ed. ACTION You speci ed an invalid password for the target user. Specify the correct password. MESSAGE Invalid group password speci ed.
AIF Status Messages -2527 -2528 -2529 -2541 -2550 A-22 MESSAGE The user password has expired. CAUSE The user password expiration is set by the MPE/iX Security Monitor. ACTION The user has an expired password which must be replaced. Contact your System Manager for further assistance. MESSAGE The user password is invalid. CAUSE The user password has exceeded the maximum lifetime allowed by the MPE/iX Security Monitor.
AIF Status Messages -2551 -2552 -2553 -2554 -2555 -2556 -2557 MESSAGE Internal Error. CAUSE JSSET returned a bad status. ACTION Contact your Hewlett-Packard support representative and be prepared to provide information on how to reproduce the problem. MESSAGE Internal Error. CAUSE DIRECLOGOFF returned a bad status. ACTION Contact your Hewlett-Packard support representative and be prepared to provide information on how to reproduce the problem. MESSAGE Internal Error.
AIF Status Messages -2560 -2561 -2562 -2563 -2564 -2565 A-24 MESSAGE Internal Error. CAUSE COREPARSER returned a token longer then the maximum token length that was speci ed to it. ACTION Contact your Hewlett-Packard support representative and be prepared to provide information on how to reproduce the problem. MESSAGE Internal Error. CAUSE An invalid case occurred in a case statement in BUILD LOGON DESC.
AIF Status Messages -2566 -2567 -2568 -2569 -2570 -2571 MESSAGE Internal error. CAUSE Rebuild of the temporary directory failed. ACTION Contact your Hewlett-Packard support representative. MESSAGE Internal error. CAUSE CM BUILD JDT returned bad status. ACTION Contact your Hewlett-Packard support representative. MESSAGE Rebuilding the temporory directory failed, the application has open temporary les.
AIF Status Messages -2572 -2573 -2574 A-26 MESSAGE Internal error. CAUSE Unexpected entry found in temporary directory. ACTION Contact your Hewlett-Packard support representative. MESSAGE Internal error. CAUSE Attempt to read temporary directory entry failed. ACTION Contact your Hewlett-Packard support representative. MESSAGE Internal error. CAUSE Attempt to link entry in temporary directory failed. ACTION Contact your Hewlett-Packard support representative.
AIF Status Messages System Configuration Status Messages -3001 -3002 -3003 -3004 -3005 -3006 -3007 MESSAGE Invalid item number passed in itemnum array to AIFSCGET . CAUSE A non-zero invalid item number was passed in itemnum array . ACTION Pass an appropriate value and end with a zero. MESSAGE Invalid item number passed in vernum array to AIFSCPUT . CAUSE A non-zero, invalid item number was passed in vernum array . ACTION Pass an appropriate value and end with a zero.
AIF Status Messages -3008 -3009 -3010 -3011 -3012 -3013 -3014 -3015 A-28 MESSAGE Next job number not in range 1 - 16383. CAUSE The next job number value was not in the range 1 - 16383. ACTION Use a value from 1 to 16383 when setting the next job number. MESSAGE Next session number not in range 1 - 16383. CAUSE The next session number value was not in the range 1 - 16383. ACTION Use a value from 1 to 16383 when setting the next session number. MESSAGE Job security not equal to 0 or 3.
AIF Status Messages -3016 -3017 -3018 -3019 -3020 -3021 -3023 MESSAGE Internal error. CAUSE Unexpected error occurred when attempting to update dispatcher items. ACTION Contact Hewlett-Packard for support. MESSAGE Write to PDC failed. CAUSE There is an unexpected system problem. ACTION Contact Hewlett-Packard for support. MESSAGE Read of PDC failed. CAUSE There is an unexpected system problem. ACTION Contact Hewlett-Packard for support. MESSAGE Internal Error.
AIF Status Messages -3024 -3025 -3026 A-30 MESSAGE An illegal value was speci ed for the upper limit. CAUSE The upper limit of the job, session, input spoolid, or output spoolid range must either be 0 (meaning that the system should use the absolute limit of the range) or a positive integer greater than the lower limit but less than the absolute limit of the speci ed counter. ACTION Use a value in the correct range.
AIF Status Messages Local File Information Status Messages -4001 -4002 -4003 -4004 -4005 -4006 -4007 MESSAGE Invalid Local File Get Item Number. CAUSE Invalid Local File Get Item Number. ACTION Check for uninitialized pointers/item numbers. MESSAGE Invalid Local File Put Item Number. CAUSE Invalid Local File Put Item Number. ACTION Check for uninitialized pointers/item numbers. MESSAGE Invalid Local File Verify Item Number . CAUSE Invalid Local File Verify Item Number.
AIF Status Messages -4008 -4009 -4010 -4011 -4012 -4014 -4015 -4016 -4017 A-32 MESSAGE Invalid record number. CAUSE Record number should be positive. ACTION Check for item number. MESSAGE An invalid o set was speci ed. CAUSE Record o set should be positive. ACTION Check for item number. MESSAGE Invalid access rights speci ed. CAUSE File access rights should be in the range 0..255. ACTION Check for item number. MESSAGE Invalid privilege level was speci ed.
AIF Status Messages Global Warning Messages +4500 +4501 +4502 +4503 +4504 +4505 MESSAGE The HFS le has been opened by u d. CAUSE When opened by u d, it is not always possible to return the pathname. ACTION No action. MESSAGE The le is a HFS le and cannot be represented by an MPE lename. CAUSE MPE lename syntax is not appropriate to represent a HFS le. ACTION Use the pathname items to retrieve the pathname. MESSAGE The MPE le cannot be represented by a HFS pathname.
AIF Status Messages Global File Information Status Messages -5001 -5002 -5003 -5005 -5006 -5007 -5008 -5009 A-34 MESSAGE Invalid item number passed in itemnum array for AIFFILEGGET. CAUSE A non-zero, invalid item number was passed in itemnum array . ACTION Pass an appropriate value and end with a zero. MESSAGE Invalid item number passed in itemnum array for AIFFILEGGET. CAUSE A non-zero, invalid item number was passed in itemnum array .
AIF Status Messages -5010 -5011 -5012 -5013 -5014 MESSAGE Invalid item number for global verify. CAUSE A non-zero invalid item number was passed in itemnum array . ACTION Pass an appropriate value and end with a zero. MESSAGE File speci ed is privileged. CAUSE Access is not allowed on privileged les. ACTION Do not access privileged les. MESSAGE Put failed to le. CAUSE Transaction management failed. ACTION Contact your response center. MESSAGE Directory is on a read-only volume.
AIF Status Messages Accounting Information Status Message -6001 -6002 -6003 -6004 -6005 -6006 -6007 A-36 MESSAGE Invalid item number passed in itemnum array for AIFACCTGET. CAUSE A non-zero, invalid item number was passed in itemnum array . ACTION Pass an appropriate item number as speci ed in the reference manual. MESSAGE Invalid item number passed in itemnum array for AIFACCTPUT. CAUSE A non-zero, invalid item number was passed in itemnum array .
AIF Status Messages -6008 -6009 -6010 -6011 MESSAGE Password must meet minimum length speci ed by the HP Security Monitor. CAUSE Password is less than the required minimum password length. ACTION Check the password length speci ed in the application. MESSAGE Password must change. CAUSE The new password input is the same as the old password. ACTION Check the value input in the application. MESSAGE Password is required. CAUSE A HP Security Monitor feature is set requiring a password.
AIF Status Messages Spool File and Spooler Process Information Status Messages -8001 -8002 -8003 -8004 -8005 -8006 -8007 A-38 MESSAGE Unexpected escape. CAUSE Unexpected error occurred in low level code called by NMS AIFs. ACTION Contact Hewlett-Packard for support. MESSAGE Invalid device. CAUSE The device is invalid. ACTION Check the device passed. MESSAGE The device is not spooled. CAUSE The device is not spooled. ACTION Start spool on the device.
AIF Status Messages -8008 -8009 -8010 -8011 -8012 -8013 -8014 -8015 -8017 MESSAGE Caller not in privileged mode. CAUSE The process calling this interface is at HW ring level 3. ACTION Call GETPRIVMODE to promote process to HW ring level 2. MESSAGE Cannot get information for the given device. CAUSE Error occurred while interfacing with the native mode device le. ACTION Contact Hewlett-Packard for support. MESSAGE The ldev number passed is not valid.
AIF Status Messages -8018 -8219 -8020 -8021 -8022 -8023 -8024 -8025 A-40 MESSAGE The device does not exist. CAUSE The device does not exist. ACTION Check if the device passed is valid. MESSAGE Cannot update the device information. CAUSE Error occurred while interfacing with the native mode device le. ACTION Submit an SR. MESSAGE Cannot build spooler internal target queue list. CAUSE Error occurred while building NMS internal target queue list. ACTION Submit an SR.
AIF Status Messages -8026 -8027 -8028 -8029 -8030 -8031 -8032 -8033 -8034 MESSAGE Both o set and nish end of copy are passed. CAUSE It is illegal to suspend with nish end of copy and a non-zero o set. ACTION Fix the procedure call. MESSAGE NMS internal error. CAUSE NMS internal error. ACTION Submit SR. MESSAGE Cannot send message to a spooler process. CAUSE Error occurred while trying to send message to a spooler process. ACTION Check if the spooler process is running properly.
AIF Status Messages -8035 -8036 -8037 -8038 -8039 -8040 -8041 -8042 A-42 MESSAGE Cannot convert the spool le ID to UFID. CAUSE Error occurred most likely because the le does not exist. ACTION Check the spool le ID passed. MESSAGE Invalid spool le UFID. CAUSE The given UFID is invalid. ACTION Check the UFID passed. MESSAGE Invalid spool le ID. CAUSE The given spool le ID is invalid. ACTION Check the spool le ID passed. MESSAGE Mismatching spool le ID and UFID.
AIF Status Messages -8043 -8044 -8045 -8046 -8047 -8048 -8049 -8050 MESSAGE The given spool le state value is out of range. CAUSE The value for spool le state is out of range. ACTION Pass a valid spool le state. MESSAGE Cannot modify the state of a :JOB input spool le. CAUSE Cannot modify the state of a :JOB input spool le. ACTION Don't change the state of a :JOB input spool le. MESSAGE Cannot change the state of a :DATA input spool le to other then DEL PENDING.
AIF Status Messages -8051 -8052 -8053 -8054 -8055 -8056 -8057 -8058 A-44 MESSAGE Cannot change the date/time of a spool le that is being created. CAUSE The spool le has not yet been closed after being created. ACTION Change the spool le date/time after it becomes READY. MESSAGE The high order half word of the spool le ready date is not zero. CAUSE The high order half word of the spool le ready date must be zero.
AIF Status Messages -8059 -8060 -8061 -8062 -8063 -8064 -8065 -8066 MESSAGE The ready date passed is invalid. CAUSE The ready date passed is invalid. ACTION Check the ready date passed. MESSAGE The ready time passed is invalid. CAUSE The ready time passed is invalid. ACTION Check the ready time passed. MESSAGE Cannot retrieve the capability of the caller from JMAT. CAUSE Error occurred while getting the capability of the caller from JMAT. ACTION Contact Hewlett-Packard for support.
AIF Status Messages -8067 -8068 -8069 -8070 -8071 -8072 -8073 A-46 MESSAGE The given item number in the veri cation array is not valid for input spool les. CAUSE The item number is not valid for input spool les. ACTION Don't use this item number on an input spool le. MESSAGE The given item number is not a valid GET item for output spool les. CAUSE The item number is not valid for output spool les. ACTION Don't use this item number on an output spool le.
AIF Status Messages -8074 -8075 -8076 -8077 -8078 -8079 -8080 -8081 MESSAGE Failed to PUT the speci ed target device because spool le owner doesn't have access right to the device. CAUSE Spool le owner doesn't have access to the device according to the ACD. ACTION Alter the owner's access rights. MESSAGE Syntax error found in the given selection equation. CAUSE Syntax error found in the given selection equation. ACTION Correct the syntax error.
AIF Status Messages -8082 -8083 -8084 -8085 -8086 -8087 -8088 -8089 A-48 MESSAGE Error occurred while trying to copy and link the spool le. CAUSE Error occurred while trying to copy and link the spool le. ACTION Contact Hewlett-Packard for support. MESSAGE Invalid data address passed for spf u d array . CAUSE The address is not accessible to the caller. ACTION Pass only address in accessible space. MESSAGE Invalid data address passed for spf id array .
AIF Status Messages -8090 MESSAGE The address is not properly aligned for the data type to be accessed. CAUSE The address is not properly aligned for the data type to be accessed. ACTION Pass only variable that has the proper data alignment.
AIF Status Messages Spooler Process Information Warning Messages +8500 +8501 +8502 +8503 +8504 +8505 +8506 +8507 A-50 MESSAGE The device is not spoolable. CAUSE The given device is not spoolable. ACTION Check the device passed. MESSAGE Cannot openq on an inspooled device. CAUSE Openq not allowed for inspool device. ACTION Check the device passed. MESSAGE Cannot shutq on an inspooled device. CAUSE Shutq not allowed for inspool device. ACTION Check the device passed.
AIF Status Messages +8508 +8509 +8510 +8511 +8512 +8513 +8514 +8515 MESSAGE Cannot stopspool because of the current spooler process state. CAUSE It is illegal to stopspool on the current state of the spooler. ACTION Check the device passed. MESSAGE Cannot suspendspool because of the current spooler process state. CAUSE It is illegal to suspendspool on the current state of the spooler. ACTION Check the device passed.
AIF Status Messages +8516 ACTION O set cannot be speci ed with this particular device. O set cannot be speci ed with this particular device. The o set is ignored. MESSAGE Error occurred while altering the list device in JMAT. CAUSE Error occurred while altering the list device in JMAT. ACTION Contact Hewlett-Packard for support. MESSAGE More qualifying entry found by AIFSPFLIST than can be returned in the array. CAUSE The given array is too small. ACTION Pass a larger array.
AIF Status Messages KSAM Status Messages -9001 -9002 -9003 -9004 -9005 -9006 -9007 MESSAGE An internal error was encountered while moving data to/from the user bu er. CAUSE Same as the message content. ACTION Check the bu er parameter and its bounds, or contact your Hewlett-Packard support representative. MESSAGE Unexpected error encountered while prefetching le pages. CAUSE Could be out of disc space, out of le limit or any other unexpected internal error.
AIF Status Messages -9008 -9009 -9010 -9011 -9012 -9013 -9014 A-54 MESSAGE Volumeset speci ed in the vol set name parameter does not exist on the system. CAUSE Same as the message content. ACTION Specify a valid volumeset. MESSAGE Volume speci ed in the vol name parameter does not exist on the speci ed volumeset. MPEXL SYSTEM VOLUME SET is the default volume set if none was speci ed. CAUSE Same as the message content. ACTION Specify another volume.
AIF Status Messages -9015 -9016 -9017 -9018 -9019 -9020 -9021 MESSAGE Internal Error. Pathname in the bu er passed to AIFKSMCREATE is bad. CAUSE The pathname in the bu er passed to AIFKSMCREATE is bad. ACTION Check the application to make sure you are passing the correct bu er. MESSAGE The directory parameter does not have a valid pathname syntax. CAUSE The syntax of the directory parameter is not a valid pathname. ACTION Check the application and pass in a valid directory parameter.
AIF Status Messages -9022 -9023 -9024 -9025 A-56 MESSAGE Internal error while reading a le label extension. CAUSE Internal error while reading a le label extension. ACTION Contact your Hewlett-Packard Support Representative. MESSAGE Internal error while writing a le label extension. CAUSE Internal error while writing a le label extension. ACTION Contact your Hewlett-Packard Support Representative. MESSAGE Internal error while getting the length of a le label extension.
AIF Status Messages System wide Information Status Messages -10001 -10003 -10004 -10005 -10006 -10007 -10008 MESSAGE Invalid item number passed in itemnum array for AIFSYSWIDEGET. CAUSE A non-zero, invalid item number was passed in itemnum array . ACTION Pass an appropriate item number as speci ed in the reference manual. MESSAGE An account was not speci ed for AIFSYSWIDEGET. CAUSE The account name must be speci ed to obtain account information.
AIF Status Messages -10009 -10010 -10011 -10012 -10014 -10015 -10016 -10017 -10018 A-58 MESSAGE Invalid spool le copies value in AIFSYSWIDEGET call. CAUSE The spool le copies value speci ed in item array was invalid. ACTION Use a value from 0 to 65535 in item array . MESSAGE Invalid spool le jobabort value in AIFSYSWIDEGET call. CAUSE The spool le jobabort value speci ed in item array was invalid. ACTION Use a value 0 or 1 in item array .
AIF Status Messages Ports Management Status Messages -11001 -11002 -11003 -11004 -11005 -11006 -11007 MESSAGE Invalid itemnum speci ed in itemnums array. CAUSE Item number is not valid for this call. ACTION Check the logic of your application. MESSAGE Invalid create option. CAUSE The value given for the create option is not a valid value. ACTION Check the logic of your application. MESSAGE The Max message size parm is more than the maximum allowed, or less than 0.
AIF Status Messages -11008 -11009 -11010 -11011 -11012 -11013 MESSAGE Timeout value not >= -1. CAUSE Timeout value is out of range. ACTION Check the logic of your application. MESSAGE Priority value not between 0 and 31 for AIFPORTSEND. CAUSE Priority is out of range. ACTION Check the logic of your application. MESSAGE Open of existing port failed; port does not exist. CAUSE Opened old port, but port does not exist. ACTION Check the logic of your application.
AIF Status Messages -11016 -11017 -11018 -11019 -11020 -11023 -11024 -11025 MESSAGE Invalid option combination between connectionless/waited. CAUSE Connectionless sends must specify item 11101 with a value of -1 nowait. ACTION Check the logic of your application. MESSAGE Invalid port was speci ed to AIFPORTINT. CAUSE An invalid asynchronous port id was speci ed. ACTION Check the logic of your application. MESSAGE Invalid creation option for asynchronous port.
AIF Status Messages Device Status Messages -13001 -13002 -13003 -13004 -13005 -13006 -13007 A-62 MESSAGE No Ldev or Device-key speci ed for Device Get. CAUSE Neither an ldev or device-key was speci ed. ACTION Call AIFSYSWIDEGET to obtain a ldev or device-key. MESSAGE Invalid Device Get item number speci ed. CAUSE A non-zero, invalid item number was passed in itemnum array . ACTION Pass an appropriate item number. MESSAGE Invalid Ldev number speci ed.
AIF Status Messages -13008 -13009 -13010 -13011 -13012 -13013 -13014 MESSAGE Internal Error. CAUSE Can not close/purge a disc le. ACTION Contact your Hewlett-Packard support representative and be prepared to provide information on how to reproduce the problem. MESSAGE Fail to perform a control operation to a terminal device le. CAUSE The terminal may be in an inappropriate state or the operation is not supported. ACTION Contact Hewlett-Packard for support.
AIF Status Messages -13015 -13016 -13017 -13019 -13020 -13022 -13023 A-64 MESSAGE The given item number is not a valid PUT item for device PUT. CAUSE The item number is not valid for device PUT. ACTION Pass an appropriate item number. MESSAGE The given item number in the veri cation array is not valid for AIFDEVICEPUT CAUSE An invalid item number was passed in the veri cation array. ACTION Pass an appropriate item number.
AIF Status Messages -13024 -13025 -13501 -13502 -13503 -13504 -13505 -13506 MESSAGE Unable to return security logon attempt information. CAUSE The security information was not found. ACTION The HP 3000 Security Monitor/iX is not found. Check with the system manager. MESSAGE Unable to return security terminal password information. CAUSE The security information was not found. ACTION The HP 3000 Security Monitor/iX is not found. Check with the system manager.
AIF Status Messages -17001 -17002 -17003 -17004 -17005 -17006 -17007 A-66 MESSAGE Media manager process not created. CAUSE The program HPOPTMGR.PUB.SYS program was not run at system startup. ACTION Run HPOPTMGR.PUB.SYS and retry AIF operation. MESSAGE Unable to open the media information le on optical disk. CAUSE The media information le on the optical disk could not be opened. ACTION Re-initialize media via the MOUTIL INITMO command and retry AIF operation.
AIF Status Messages -17008 -17009 -17010 -17011 -17012 -17013 -17014 MESSAGE All drives are currently allocated. CAUSE An allocate by media name was performed and all drives accessible to the media are currently allocated. ACTION Retry the AIF operation when a drive is available. MESSAGE Media currently mounted in the speci ed drive. CAUSE A mount was performed on a drive that already had media mounted. ACTION Wait for media to be dismounted before attempting mount.
AIF Status Messages -17015 -17016 -17017 -17018 -17019 -17020 -17021 A-68 MESSAGE Veri cation of media label failed. CAUSE Speci cied media label does not match media label for the mounted media. ACTION Retry AIF operation with a di erent media label to verify against. MESSAGE Volume close error occurred. CAUSE A volume close error occurred during dismount of volume set. Files possibly still opened on the volume set.
AIF Status Messages -17022 -17023 -17024 -17025 -17026 -17027 -17028 MESSAGE Media moving error. CAUSE Internal error. ACTION Contact your Hewlett Packard support representative. MESSAGE Media label operation error. CAUSE Internal error. ACTION Contact your Hewlett Packard support representative. MESSAGE Volume Management error. CAUSE Internal error. ACTION Contact your Hewlett Packard support representative. MESSAGE Media Manager internal error.
AIF Status Messages -17029 -17030 -17031 -17032 -17033 -17034 -17035 A-70 MESSAGE Invalid item number passed in itemnum array to AIFMODISMOUNT . CAUSE A non-zero invalid item number was passed in itemnum array. ACTION Pass an appropriate value and end with a zero. MESSAGE Unable to get the pointer to magneto-optical AIF known process object. CAUSE GET KPO POINTER returned a bad status. ACTION Contact your Hewlett Packard support representative.
AIF Status Messages -17036 -17037 -17038 -17039 -17040 -17041 -17042 MESSAGE Invalid nowait identi er speci ed. CAUSE An invalid nowait identi er was speci ed. ACTION Specify a valid nowait identi er and retry AIF operation. MESSAGE Only one of optical drive or media label can be speci ed. CAUSE Both optical drive and media label were speci ed. ACTION Specify only one of optical drive or media label and retry AIF operation. MESSAGE Invalid value for prompt for media item.
AIF Status Messages -17043 -17044 -17045 -17046 -17047 -17048 -17049 A-72 MESSAGE MOUTIL SYNCTABLE required or currently in progress by another process. CAUSE A SYNCTABLE was invoked by another process using the optical disk library system or a SYNCTABLE is required. ACTION Perform MOUTIL SYNCTABLE and retry operation later. MESSAGE Optical drive not allocated by speci ed PIN. CAUSE AIF speci ed an invalid PIN for operation.
AIF Status Messages -17050 -17051 -17052 -17053 -17054 -17055 -17056 MESSAGE Invalid autochanger speci ed. CAUSE AIF speci ed an invalid autochanger. ACTION Retry AIF operation with valid autochanger. MESSAGE Invalid lower range for storage slot info speci ed. Lower range must be greater than or equal to one and less than or equal to the upper range. CAUSE Invalid lower range for storage slot info speci ed. ACTION Retry AIF operation with valid lower range for storage slot info.
AIF Status Messages +17501 +17502 +17503 +17504 +17505 +17506 +17507 A-74 MESSAGE The speci ed optical drive is not allocated. CAUSE This warning will be returned when AIFMODEALLOCATE is called to deallocate a drive that has not been previously allocated. ACTION No action. MESSAGE The speci ed optical drive already hard allocated by PIN. CAUSE This warning will be returned when AIFMOALLOCATE is called to allocate a drive that has already been allocated by the requesting PIN.
AIF Status Messages +17508 +17509 +17510 +17511 +17512 +17513 +17514 MESSAGE Media label item has already been speci ed. CAUSE Media label item was speci ed more than once in the AIF request. The rst media label item speci ed will be used. ACTION No action. MESSAGE Prompt item has already been speci ed. CAUSE Prompt item was speci ed more than once in the AIF request. The rst prompt item speci ed will be used. ACTION No action. MESSAGE Volume set item has already been speci ed.
AIF Status Messages Status Messages for Workgroup Information -19001 -19002 -19003 -19004 -19005 -19006 -19007 -19008 A-76 MESSAGE A non-existent workgroup cannot be purged. CAUSE An attempt was made to purge a non-existent workgroup. ACTION Check the workgroup name. MESSAGE A system default workgroup cannot be purged. CAUSE An attempt was made to purge a system default workgroup. ACTION Check the workgroup name. MESSAGE A non-existent workgroup cannot be modi ed.
AIF Status Messages -19009 -19010 -19011 -19012 -19013 -19014 -19015 -19016 MESSAGE Base priority too high. CAUSE Base priority should be in the range of 127 to 13567. ACTION Pass a base priority within the range. MESSAGE Base priority too low. CAUSE Base priority should be in the range of 127 to 13567 ACTION Pass a base priority within the range. MESSAGE Invalid Limit priority value. CAUSE Limit priority higher than base priority. ACTION Pass a correct limit priority.
AIF Status Messages -19017 -19018 -19019 -19020 -19021 -19022 -19023 -19024 A-78 MESSAGE Invalid Boost Property value. CAUSE Boost property should be 0 for DECAY or 1 for OSCILLATE. ACTION Pass an appropriate value within the correct range for Boost Property value. MESSAGE Invalid Timeslice type. CAUSE Timeslice is an integer type. ACTION Pass an appropriate number for Timeslice value. MESSAGE Invalid Timeslice value.
AIF Status Messages -19025 -19026 -19027 -19028 -19029 -19030 -19031 -19032 MESSAGE Invalid Minimum CPU Percentage value. CAUSE The value causes total percentage to be more than 100. ACTION Pass an appropriate value for Minimum CPU Percentage value. MESSAGE Maximum CPU Percentage value less than zero. CAUSE The value can range from 0% to 100%. ACTION Pass an appropriate value within the correct range for Maximum CPU Percentage value. MESSAGE Invalid Maximum CPU Percentage value.
AIF Status Messages -19033 -19034 -19035 -19036 -19037 -19038 -19039 -19040 A-80 MESSAGE Invalid workgroup name. CAUSE A pin cannot be pegged to a non-existent workgroup. ACTION Pass a valid workgroup name. MESSAGE Base or limit priority not passed to AIFWGADD. CAUSE Base and limit priority are required for addition of a new workgroup. ACTION Pass appropriate values for base and limit. MESSAGE An internal error. CAUSE An error occured while parsing of the le.
AIF Status Messages -19041 -19042 -19043 -19044 -19045 -19046 -19047 -19048 -19049 MESSAGE Indirect le passed to AIFWGREPLACE cannot be processed. CAUSE There is an unexpected system problem. ACTION Contact Hewlett-Packard for support. MESSAGE Workload Manager not purchased. CAUSE Workload Manager product should be purchased. ACTION Contact Hewlett-Packard. MESSAGE Internal error. CAUSE There is an unexpected system problem. ACTION Contact Hewlett-Packard for support.
AIF Status Messages -19050 -19051 -19052 -19053 -19054 -19055 -19056 -19057 A-82 MESSAGE Invalid MPE/iX priority value. CAUSE MPE/iX priority value should be in the range of 127 to 13567. ACTION Pass a priority value within the range. MESSAGE Invalid Quantum value. CAUSE Quantum should be in the range of 1..32767. ACTION Pass a quantum value within the range. MESSAGE Invalid Timeslice value.
B AIF Data Structures bit1 = 0 .. 1; bit2 = 0 .. 3; bit8 = 0 .. 255; bit14 = 0 .. 16383; bit16 = 0 .. 65535; bit31 = 0 .. 2147483647; buffer_type = record case boolean of true: (buff_str : string[n]); false: (buff_len : integer; buffer : packed array [1..n]); end; Array size: 4 + n + 1 bytes n represents a user-defined size.
AIF Data Structures buffer_info_type = record buffer_offset pathname_len end; Record size: 8 bytes Alignment: 4 bytes : integer; (0.0 @ 4.0) : integer; (4.0 @ 4.0) clock_type = crunched record case bit32 of 1: ( hour min sec ten_sec 2: ( clock_funct end; : : : : : bit8; bit8; bit8; bit8; bit32; (0.0 (1.0 (2.0 (3.0 (0.0 @ @ @ @ @ 1.0) 1.0) 1.0) 1.0) 4.0) Record size: 4 bytes Alignment: 4 bytes datestr_type = record month_str : packed array[1..3] of char; (0.0 @ 3.0) day_of_week : packed array[1..
AIF Data Structures date_type = record year : integer; month : integer; day_of_month : integer; end; (0.0 @ 4.0) (4.0 @ 4.0) (8.0 @ 4.0) Record size: 12 bytes Alignment: 4 bytes device_name_type = packed array[1..18] of char; (0.0 @ 18.0) Array size: 18 bytes Element size: 1 byte Alignment : 1 byte directory_name_type = record user : packed array[1..16] of char ; group : packed array[1..16] of char ; account : packed array[1..16] of char ; end ; (0.0 @ 16.0) (16.0 @ 16.0) (32.0 @ 16.
AIF Data Structures drives_type = record cnt : integer; drives_ldevs : array [1..n] of integer; end; n represents a user-defined size. Record size : 4 + 4n bytes Alignment : 4 bytes dstsrec_type = record cnt : integer; dstinfo : array[1..n] of record dstno : integer; dstva : anyptr; end ; end ; Record size: 12n + 4 bytes Alignment : 4 bytes n represents a user-defined size. B-4 AIF Data Structures (0.0 @ 4.0) (0.0 @ 4.0) (4.0 @ 8.
AIF Data Structures filename_type = record filename group account end ; : packed array[1..16] of char; : packed array[1..16] of char; : packed array[1..16] of char; (0.0 @ 16.0) (16.0 @ 16.0) (32.0 @ 16.0) Record size: 48 bytes Alignment : 1 byte All three arrays are always returned padded, with blanks on the right. Most interfaces accept them, when a file name is input, to be flushed with blanks on the right. fnamerec_type = record cnt fnames end; : integer : array[1..
AIF Data Structures i32rec_type = record cnt ints end; : integer; : array[1..n] of integer; Record size: 4 + 4n bytes Alignment : 4 bytes i64rec_type = record cnt lints end; : integer; : array[1..n] of longint; Record size: 4 + 8n bytes Alignment : 4 bytes item_array_type = array[1..n] of globalanypointer; Array size: 8n bytes Element size: 8 bytes Alignment: 4 bytes n represents a user defined size. itemstatus_array_type = array[1..
AIF Data Structures itemnum_array_type = array[1..n] of integer; Array size: 4n bytes Element size: 4 bytes Alignment: 4 bytes n represents a user defined size. jskey_type = integer; Alignment (0.0 @ 4.0) : 4 bytes jsdev_type = record device_class : boolean; output_device : integer; end ; ( 0.0 @ 1.0 ) ( 4.0 @ 4.
AIF Data Structures jsnum_type = packed record js_type : bit2; js_num : bit14; js_ext : shortint; end ; ( 0.0 @ 0.2 ) ( 0.2 @ 1.6 ) ( 2.0 @ 2.0 ) Record size: 4 bytes Alignment : 4 bytes The js type field can have a value of 1 or 2; 1 indicates a session and 2 indicates a job. The js num field can have any value from 1-16383. logon_desc_type = record job_name acct_name acct_pass user_name user_pass group_name group_pass end ; : : : : : : : pac16; pac16; pac16; pac16; pac16; pac16; pac16; ( 0.
AIF Data Structures max_pathlen = 1024 This value can be retrieved from AIFSCGET, item 3062. max_pathname_type = packed array [ 1 .. max_pathlen ] of char; Array size: max_pathlen bytes Alignment: 1 byte message_buffer_type Element Size: 1 byte = packed array[1..n] of char; Array size: n bytes Element size: 1 byte Alignment : 1 byte The type is user-defined. n represents any number <= 32767. media_label_type = record media_name : packed array [1..32] of char; subname1 : packed array [1..
AIF Data Structures mm_side_type = record media_label : media_label_type; volume_label : packed array[1..8] of char; end; (0.0 @ 40.0) (40.0 @ 8.0) Record size : 72 bytes Alignment : 1 byte mm_slot_info_type = record slot_number slot_state side_a side_b end; : : : : integer; mm_slot_state_type; mm_side_type; mm_side_type; (0.0 (4.0 (5.0 (4D.0 @ @ @ @ 4.0) 1.0) 48.0) 48.
AIF Data Structures pac8 = packed array[1..8] of char; (0.0 @ 8.0) Array size: 8 bytes Element size: 1 byte Alignment : 1 byte pac16 = packed array[1..16] of char; (0.0 @ 16.0) Array size: 16 bytes Element size: 1 byte Alignment : 1 byte pac18 = packed array[1..18] of char; (0.0 @ 18.0) Array size: 18 bytes Element size: 1 byte Alignment : 1 byte pac32 = packed array[1..32] of char; (0.0 @ 32.
AIF Data Structures pac34 = packed array[1..34] of char; (0.0 @ 34.0) Array size: 34 bytes Element size: 1 byte Alignment : 1 byte pac256 = packed array[1..256] of char; (0.0 @ 256.0) Array size: 256 bytes Element size: 1 byte Alignment : 1 byte path_identifier = $alignment 4$ record ufid : ufid_type; link_id : bit32; parent_ufid : ufid_type; end; Record size: 44 bytes Alignment : 4 bytes path_id_rec_type = $alignment 4$ record cnt path_ids end; : integer; : rec [1..
AIF Data Structures pathname_type = record case boolean of true: (path_str : string [n]); false: (path_rec : record length : integer; pathname : packed array [1..n] of char; end); end; Record size : 4 + n + 1 bytes Alignment : 4 bytes n represents a user-defined size. length is 1024 bytes. pid_type Currently the maximum pathname = record left right end ; : integer; : integer; (0.0 @ 4.0) (4.0 @ 4.
AIF Data Structures search_key_type = record case integer of 1: ( key_js_num : 2: ( key_pid : 3: ( key_ufid : 4: ( key_fname : 5: ( key_dname : 6: ( key_sfnum : 7: ( key_portid : 8: ( key_portnm : 9: ( key_plfd : 10: ( key_js_ind : 11: ( key_pid_ind : 12: ( key_ldev : 13: ( key_va : 14: ( key_int : 15: ( key_class : 16: ( key_pathname: end ; integer ); longint_type ); ufid_type ); filename_type ); directory_name_type ); integer ); integer ); pac16 ); localanyptr ); integer ); integer ); integer ); bit64
AIF Data Structures spf_id_type = packed record case boolean of true: ( id_number : bit31; i_or_o_flag: bit1); false: ( all: integer); end ; (0.0 @ 3.7) (3.7 @ 0.1) (0.0 @ 4.0) Record size: 4 bytes Alignment : 4 bytes status_type = record case boolean of true : ( all: integer ); false : ( info : shortint; subsys: shortint ); end ; (0.0 @ 4.0) (0.0 @ 2.0) (2.0 @ 2.
AIF Data Structures t_vol_class_name = packed array[1..32] of char; (0.0 @ 32.0) Array size : 32 bytes Alignment : 1 byte t_volume_name = packed array [1..16] of char; (0.0 @ 16.0) Array size : 16 bytes Alignment : 1 byte t_vol_set_name = packed array[1..32] of char; ufidrec_type = record cnt ufids end; ufid_type record end ; : integer; : array[1..n] of ufid_type; = ufid : packed array[1..20] of char; Array size: 20 bytes Element size: 1 byte Alignment : 4 bytes B-16 (0.0 @ 32.
AIF Data Structures key_workgroup_type = record wgindex : integer; creation_count : integer; end; (0.0 @ 4.0) (4.0 @ 4.0) Record Size : 8 bytes Alignment : 4 bytes pac20 = packed array[1..20] of char; (0.0 @ 14.
C Programming Examples This appendix contains programming examples to illustrate the use of operating system architected interfaces. Examples one and two illustrate using AIF:OS system calls to send and receive data. These two examples are written in HP C/iX. Examples three and four illustrate using AIF:OS system calls with asynchronous ports. These two examples are written in HP Pascal. Example ve illustrates using AIFSYSWIDEGET for retrieving HFS pathnames. This example is written in HP Pascal.
Programming Examples Example 1 SEND1S, send data Examples one and two illustrate using the AIF:OS system calls to send and receive data. These two examples are written in HP C/iX. To compile the source code for SEND1S: ccxl send1s,,$null;info="-Aa +e" link from=$oldpass,xdbend.lib.sys;to=send1p;& cap=ia,pm;rl=libcinit.lib.sys This is the source code for program SEND1S: #pragma list off #include #include #include #include
Programming Examples /***************************************************************************/ /* fatal_aif_error */ /***************************************************************************/ void fatal_aif_error (t_mpe_status *overall status char item_status_array_type item_status_array) { int i; printf ("**** %s\n", error_stng); printf ("**** error: Info=%d Subsystem=%d\n", overall_status->decode.error_num overall_status->decode.subsys_num for (i=0; i, num_items; i++|) { if (item_status_array[i].
Programming Examples /***************************************************************************/ /* open_port */ /***************************************************************************/ void open_port (int *port_id) { char port_name[16] = "PORT2 "; char port_password[16] = "PORT2_PASS "; int access_mode = 2; int create_option = 1; /* default, but we're showing an example */ itemnum_array[0] = 11201; item_array[0] = &create_option; itemnum_array[1] = 0; GETPRIVMODE (); *port_id = AIFPORTOPEN (&overal
Programming Examples /***************************************************************************/ /* send_stng */ /***************************************************************************/ void send_stng (int *port_id, char *stng, int msg_pri) { int stng_len; stng_len = strlen (stng); itemnum_array[0] = 11102; item_array[0] = &msg_pri; /* set the pri*/ itemnum_array[1] = 0; printf ("\nSending msg: %s: to port: %d at priority %d\n", stng, *port_id, msg_pri); GETPRIVMODE (); AIFPORTSEND (&overall_status,
Programming Examples Example 2 RECV1S, receive data The program RECV1S and its counterpart SEND1S use the AIF:OS system calls to send and receive the data. This is the source code for program RECV1S: #pragma list off #include #include #include #include #pragma list on #pragma #pragma #pragma #pragma intrinsic_file intrinsic intrinsic intrinsic "aifintr.pub.sys" AIFPORTOPEN AIFPORTCLOSE AIFPORTSEND #pragma intrinsic_file "sysintr.pub.
Programming Examples /***************************************************************************/ /* fatal_aif_error */ /***************************************************************************/ void fatal_aif_error (t_mpe_status *overall status char item_status_array_type item_status_array) { int i; printf ("**** %s\n", error_stng); printf ("**** error: Info=%d Subsystem=%d\n", overall_status->decode.error_num overall_status->decode.subsys_num for (i=0; i, num_items; i++|) { if (item_status_array[i].
Programming Examples /***************************************************************************/ /* open_port */ /***************************************************************************/ void open_port (int *port_id) { char port_name[16] = "PORT1 "; char port_password[16] = "PORT1_PASS "; int access_mode = 1; int create_option = 1; /* default, but we're showing an example */ itemnum_array[0] = 11201; item_array[0] = &create_option; itemnum_array[1] = 0; GETPRIVMODE (); *port_id = AIFPORTOPEN (&overal
Programming Examples /***************************************************************************/ /* receive_stng */ /***************************************************************************/ int receive_stng (int *port_id, char *stng, int stng_len, int msg_pri) { int time_out = -1; itemnum_array[0] = 11002; item_array[0] = &time_out; itemnum_array[1] = 11001; item_array[1] = &msg_pri; itemnum_array[2] = 0; GETPRIVMODE (); printf ("\nChecking for msg at pri: %d\n", msg_pri); AIFPORTRECEIVE (&overall_st
Programming Examples /***************************************************************************/ /* MAIN */ /***************************************************************************/ int main(int argc, char *argv[], char *envp[], int parm) { char stng[80]; int msg_pri; open_port (&port_id); printf ("\n\nEnter message priority (0 to quit) : "); scanf ("%d", &msg_pri); printf ("portid is %d\n", port_id); while (msg_pri) { if (receive_stng (&port_id, stng, sizeof (stng), msg_pri)) { printf ("\nReceived m
Programming Examples Example 3 ASYNC1, asynchronous ports $standard_level 'ext_modcal'$ {----------------------------------------------------------------------program ASYNC1 -----------------------------------------------------------------------PURPOSE: This is a simple program to illustrate the use of asynchronous ports. 1. 2. 3. 4. Call GETPRIVMODE to gain user privilege level 2. Create and open an asynchronous port using AIFPORTOPEN. Create and open a synchronous port using AIFPORTOPEN.
Programming Examples {----------------------------------------------------------------------declare structured constants to initialize arrays used in various AIF procedure calls -----------------------------------------------------------------------} const Init_Item_Array Init_Itemnum_Array = item_array_type [5 of nil]; = itemnum_array_type [5 of 0]; Init_Item_Status_Array = item_status_array_type [5 of status_type [info : 0, subsys : 0]]; var C-12 accessmode createoptions createhandler createstate env
Programming Examples procedure procedure procedure procedure procedure GETPRIVMODE; intrinsic; GETUSERMODE; intrinsic; HPGETPROCPLABEL; intrinsic; PAUSE; intrinsic; QUIT; intrinsic; $sysintr 'aifintr'$ procedure AIFPORTCLOSE; procedure AIFPORTINT; function AIFPORTOPEN : procedure AIFPORTRECEIVE; procedure AIFPORTSEND; intrinsic; intrinsic; integer; intrinsic; intrinsic; intrinsic; {----------------------------------------------------------------------procedure ERROR_IN_CALL ----------------------------
Programming Examples {----------------------------------------------------------------------procedure PORTHANDLER -----------------------------------------------------------------------PURPOSE: This procedure is the handler for the asynchronous port. It illustrates the use of AIFPORTINT to disable port interrupts. It will use AIFPORTRECEIVE to get the message. It will reissue the AIFPORTRECEIVE to check if messages with pending interrupts have arrived.
Programming Examples {----------------------------------------------------------------------7. AIFPORTINT is setup to disable interrupt handling on the current port. This is done when an application is accessing global data or has a critical section of code to protect. It is not necessary to call AIFPORTINT inside a handler. If new messages arrive, the interrupt handlers will nest. It is recommended the processing done in the handler be kept at a minimum.
Programming Examples {----------------------------------------------------------------------8. AIFPORTRECEIVE is called to get the original message which caused the handler to be invoked. Variables should be initialized before the AIFPORTRECEIVE call.
Programming Examples {----------------------------------------------------------------------The AIFPORTRECEIVE can be used to check if there are messages with pending interrupts. If the message is successfully received the pending interrupt will not occur when item 11007 is used.
Programming Examples {----------------------------------------------------------------------Call AIFPORTINT to enable/arm interrupt handling -----------------------------------------------------------------------} newstates[1] := oldstates[1]; AIFPORTINT ( hand_status, portlist, newstates, oldstates); if hand_status.all 0 then writeln ('AIFPORTINT 2 - Bad Status: info =',hand_status.info, ' subsys =', hand_status.
Programming Examples {----------------------------------------------------------------------2. Create and open an asynchronous port using AIFPORTOPEN.
Programming Examples {----------------------------------------------------------------------3. Create and open a synchronous port using AIFPORTOPEN. -----------------------------------------------------------------------} portname := 'aifport2 '; portpass := 'aifpass2 '; accessmode := 2; { send access } itemnum_ports [3] := 0; { terminate item list } portid2 := AIFPORTOPEN(overall_status, portname, portpass, accessmode, user_id, itemnum_ports, item_ports, item_status_ports); if overall_status.
Programming Examples {----------------------------------------------------------------------4. Send message with AIFPORTSEND to notify the other process the asynchronous port exists. Once the asynchronous port exists the other process can open the port. The asynchronous port creator is the only receiver and must be the first opener.
Programming Examples {----------------------------------------------------------------------9. Close the ports. -----------------------------------------------------------------------} AIFPORTCLOSE ( portid2, accessmode, overall_status); if overall_status.all 0 then ERROR_IN_CALL('AIFPORTCLOSE',overall_status); AIFPORTCLOSE ( portid1, accessmode, overall_status); if overall_status.
Programming Examples Example 4 ASYNC2, asynchronous ports $standard_level 'ext_modcal'$ {----------------------------------------------------------------------program ASYNC2 -----------------------------------------------------------------------PURPOSE: This is a simple program to illustrate the use of asynchronous ports. 1. 2. 3. Call GETPRIVMODE to gain user privilege level 2 Open a synchronous port named 'aifport2' for receive access.
Programming Examples {----------------------------------------------------------------------declare structured constants to initialize arrays used in various AIF procedure calls ------------------------------------------------------------------------} const Init_Item_Array Init_Itemnum_Array = item_array_type [3 of nil]; = itemnum_array_type [3 of 0]; Init_Item_Status_Array = item_status_array_type [3 of status_type [info : 0, subsys : 0]]; var C-24 accessmode base count_string envelope_code index inte
Programming Examples function ASCII : procedure GETPRIVMODE; procedure GETUSERMODE; procedure PAUSE; procedure QUIT; $sysintr 'aifintr'$ procedure AIFPORTCLOSE; function AIFPORTOPEN : procedure AIFPORTRECEIVE; procedure AIFPORTSEND; shortint; intrinsic; intrinsic; intrinsic; intrinsic; intrinsic; intrinsic; integer; intrinsic; intrinsic; intrinsic; {----------------------------------------------------------------------procedure ERROR_IN_CALL ---------------------------------------------------------------
Programming Examples begin {ASYNC2 body} {----------------------------------------------------------------------1. Call GETPRIVMODE to gain user privilege level 2 ------------------------------------------------------------------------} GETPRIVMODE; {----------------------------------------------------------------------2. Open a synchronous port named 'aifport2' for receive access.
Programming Examples {----------------------------------------------------------------------4. After message arrives, AIFPORTOPEN the asynchronous port named 'aifport1' for send access.
Programming Examples if overall_status.all 0 then ERROR_IN_CALL('AIFPORTSEND',overall_status); end; { for repeat send messages } {----------------------------------------------------------------------6. Close the ports. -----------------------------------------------------------------------} AIFPORTCLOSE ( portid2, accessmode, overall_status); if overall_status.all 0 then ERROR_IN_CALL('AIFPORTCLOSE',overall_status); AIFPORTCLOSE ( portid1, accessmode, overall_status); if overall_status.
Programming Examples Example 5 Retrieving HFS pathnames Below is a sample program to illustrate the usage of AIFSYSWIDEGET for retrieving HFS pathnames. It will retrieve a list of DIRECTORY les while only traversing the rst level of the directory. This will result in retrieving account names and HFS directories created at the root level. Specifying a traversal value of 0 is a much faster way of retrieving a list of accounts than searching the entire directory.
Programming Examples pathname_type= record case boolean of true : (path_str : string [1024]); false: (length : integer; pathname : packed array [1..1024] of char); end; path_identifier_type = $alignment 4$ record ufid : ufid_type; link_id: bit32; parent_ufid: ufid_type; end; return_array1_type = array [1..1000] of path_identifier_type; return_array2_type = array [1..
Programming Examples Var access answer aif_area buff_name buff_offset buffer buffer_ptr buffer_file_num buffer_file_name continue : : : : : : : : : : integer; char; integer; pathname_type; { name returned into return buffer} integer; buffer_type; buffer_rec_ptr_type; integer; packed array[1..30] of char; boolean; fg_itemnum_array : packed array[1..5] of integer; fg_item_array : packed array[1..5] of globalanyptr; fg_item_stat_array:item_status_array_type; file_owner : packed array[1..
Programming Examples procedure GETPRIVMODE; procedure QUIT; procedure HPFOPEN; intrinsic; intrinsic; intrinsic; $sysintr 'aifintr.pub.
Programming Examples {----------------------------------------------------------------} { Set up search key pathname } {----------------------------------------------------------------} search_path.
Programming Examples {------------------------------------------------------------------------} { Open a long mapped file to use as return buffer. Get ptr to file. } {------------------------------------------------------------------------} buffer_file_name := '%TEST%'; access := 4; { Read/write } HPFOPEN ( buffer_file_num, hp_status, 2, buffer_file_name, 11, access, 21, buffer_ptr); if hp_status.all 0 then begin writeln('Error during HPFOPEN. Status.info = ',hp_status.info, ' subsys= ',hp_status.
Programming Examples {----------------------------------------------------------------} { Process error from the AIFSYSWIDEGET call. If the user did } { not choose to ignore errors, then we can handle it now. If } { the search key is not equal to blanks, then the error } { was detected on the file returned in search_key, but the } { error won't prevent us from continuing the directory traversal.} {----------------------------------------------------------------} if sw_overall_status.
Programming Examples {----------------------------------------------------------------} { Extract pathnames from buffer } {----------------------------------------------------------------} file_cnt := 1; writeln(' '); if num_array_entries > 0 then writeln('-------------------start of buffer-----------------'); while file_cnt <= num_array_entries do begin { Extract return array 2 data } name_len := return_array2[file_cnt].name_len; buff_offset := return_array2[file_cnt].buff_offset; buff_name.
Programming Examples Example 6 - HFS directory traversal Level 1 Level 2 Level 3 Directory Traversal Examples The following examples illustrate various pathnames you can specify as input to AIFSYSWIDEGET and the format of the names you will receive as output from AIFSYSWIDEGET. The examples assume the following directory structure. / +-------------+---------------+----------------+-------------+ | | | | | 3000devs . . SYS SYSUTIL TELESUP . .
Programming Examples Absolute Pathnames With Recursion The following three examples illustrate the absolute pathnames that would be returned by AIFSYSWIDEGET if an absolute pathname was speci ed as the leset for item 5036. Assume that SYSWIDEP is a program which calls AIFSYSWIDEGET and passes in the recursion level input by the user as item 5041.
Programming Examples :RUN SYSWIDEP Path? >/SYSUTIL/@/@dir@ Recursion level? >99 /SYSUTIL/MPEXL/tools_directory /SYSUTIL/MPEXL/tools_directory/. /SYSUTIL/MPEXL/tools_directory/.. /SYSUTIL/MPEXL/tools_directory/mpe_tools_dir /SYSUTIL/MPEXL/tools_directory/mpe_tools_dir/. /SYSUTIL/MPEXL/tools_directory/mpe_tools_dir/..
Programming Examples Pathnames Relative to CWD With No Recursion The following three examples illustrate the relative pathnames that would be returned by AIFSYSWIDEGET if a relative pathname was speci ed as the leset for item 5036. :RUN SYSWIDEP Path? >./@ Recursion level? >0 ./A1002TST ./CLKPROG ./DISCUTIL ./DTSINFO ./IOMACS ./KSCHKXL ./LIFUTIL ./MIRCHECK ./MIRRDOC ./SYSWIDEP ./TBLMON ./UTILTRK1 ./VSMMAP ./tools_directory END OF PROGRAM :CHDIR /SYSUTIL/MPEXL/tools_directory :RUN SYSWIDEP.MPEXL Path? >.
Programming Examples :RUN SYSWIDEP.MPEXL Path? >./@ Recursion level? >99 ./. ./. ./.. ./mpe_tools_dir ./mpe_tools_dir/. ./mpe_tools_dir/.. ./mpe_tools_dir/flutil ./mpe_tools_dir/fstool ./unix_tools_dir ./unix_tools_dir/. ./unix_tools_dir/.. ./unix_tools_dir/grep ./unix_tools_dir/vi END OF PROGRAM What Are '.' and '..' Files? File names represented by a dot (.) or two dots (..) are directory les which in the above example represent the current directory and the parent of the current directory respectively.
Programming Examples Below is a sample program illustrating the usage of the Magneto-Optical AIFs. It allocates the rst available drive that can access the media labeled MYMEDIA, mounts the media MYMEDIA on this drive, accesses les on the media and then dismounts the media and deallocates the drive. Example 7 - Using Magneto-Optical AIFs $standard_level 'ext_modcal'$ Program MO_Sample (input, output); Type media_label_type = record media_name : packed array [1..32] of char; subname1 : packed array [1..
Programming Examples {------------------------ Print error and bail out --------------------} procedure ERROR_IN_CALL ( status : status_type; name : name_type; item_status_array : item_status_array_type); Var local_status : status_type; begin writeln('Error in ', name); if (status.all < 0) then writeln('Overall status info = ', status.info, ' subsys= ', status.subsys) else begin local_status.all := item_status_array[status.info].all; writeln('Item #: ', status.info:1, ' status info = ', local_status.
Programming Examples {------- Mount the media labeled MYMEDIA in the allocated drive -------} {------- and return the volume set name for this media. ---------------} itemnum_array[1] := 17303; { Return volume set name } item_array[1] := addr(volume_set); item_status_array[1].all := 0; itemnum_array[2] := 0; AIFMOMOUNT (overall_status, drive_ldev, media_id, itemnum_array, item_array, item_status_array, user_id); if overall_status.
D Glossary Absolute Pathname Arti cial Member Asynchronous Port Base A pathname that begins with the root directory, such as /SYS/PUB/TDP. See also pathname and relative pathname . Workgroup membership is composed of natural and arti cial members. A process becomes an arti cial member when it is explicitly placed into the workgroup via :ALTPROC or AIFPROCPUT.
Glossary Boost Property CI Connectionless Send Constant Priority Process CM Files Current Working Directory (CWD) CWD Decayable Boosting Default Workgroups D-2 Glossary The boost property can be set to either decay or oscillate (BOOST=f DECAY,OSCILLATEg). A value of decay is the default and means the priority of a process within that workgroup will begin at the base and decay as the process consumes CPU.
Glossary directory Envelope Envelope Code FIFO File Code File Equation characteristics as their namesake and have the scheduling queue as their only membership criterion. The characteristics of the AS Default and BS Default workgroups cannot be changed. The characteristics of the CS Default, DS Default, and ES Default can be changed through AIFSCPUT and AIFWGPUT. A special kind of le that contains entries that point to other les. It acts like a container for les and other directories.
Glossary File Name File Number Handler HFS hierarchical le system (HFS) Home Group IPC Job Job/Session Number D-4 Glossary le equation by using the File command to equate a le name to another le or device. Most of the AIF interfaces accept and return fully quali ed le names in a single standard format. Each OPEN (FOPEN or HPFOPEN) returns a number to the caller which is a process-speci c handle for this instance of the OPEN.
Glossary Job State Limit Linked Spool le Logon Mail Slot Maximum CPU Percentage A generic term used for the stages that a job or session might pass through during its lifespan. The limit is the lowest priority (highest numeric value) of processes within that workgroup (LIMIT=value). Values can range between the priority values of 150 and 255. Internally the priorities range from 32767 to 0. AIFSCGET/PUT return or modify internal priorities.
Glossary Maximum Quantum The maximum quantum is an upper bound for the dynamically calculated quantum ( average transaction time ) value for that workgroup ( MAXQUANT=Value ). Values range between 0 and 32767. The maximum quantum is an optional workgroup characteristic with a default value of 1000. Media Label A record de ning the label for MagnetoOptical Media which consists of three parts including media name, subname1, and subname2.
Glossary Minimum CPU Percentage Minimum Quantum MPE le Natural Member NM Files NMS pathname by having one process submit records while another process removes them. The minimum CPU percentage is a lower bound for the amount of CPU the processes in a workgroup can consume relative to other workgroups. The minimum CPU percentage value can be used to guarantee a certain amount of CPU to a workgroup.
Glossary PID PIN Port Port Manager Port Name Port Password D-8 Glossary PID is an abbreviation for Process ID. Just as every process is assigned a PIN #, in MPE/iX every process is also assigned a PID. The PID is a 64-bit long integer comprised of the machine #, the PIN #, and a reuse counter. PIN is an abbreviation for Process Identi cation Number. In MPE/iX every process is assigned a PIN #. The PIN is a 16-bit short integer.
Glossary POSIX Priority Boost Private Spool le Process-speci c File Program File Receiver Process Record Pointer creates a Port establishes the Port password. All subsequent opens must use the same password. Portable Operating System Interface. A set of standards that address various areas of operating system technology. The POSIX standards describe functions of an operating system interface that applications use to become POSIX-compliant.
Glossary Relative Pathname Return array Scheduling Characteristics provide the complete context. When a record pointer is shared, all three are shared. A pathname that is interpreted from the current working directory. For example, ./dir1/long lename refers to the le long lename in directory dir1 in the current working directory. The system-wide interface returns values in arrays of this type.
Glossary AIFPROCPUT. Second, scheduling queue refers to a collection of processes with similar scheduling characteristics. MPE/iX currently supports ve queues. The AS and BS queues are typically used for system processes, the CS queue is typically used for interactive users, while the DS and ES queues are typically used for batch jobs. Search key Sender Process Session SPFDIR SPIT Spool le Scheduling queue, as a process attribute, is an integral part of the workgroup concept.
Glossary Streams LDEV Subname1 Subname2 Surface System Average Quantum (SAQ) System Logging System Process D-12 Glossary Two new le codes have also been assigned: 1515 for input spool les and 1516 for output spool les. Input spool les are created in the IN group of the reserved account HPSPOOL, and output spool les are created in the OUT group of the HPSPOOL account. The streams LDEV is the device speci ed with the Streams command to be used as the input device for all jobs on the system.
Glossary Timeslice Transaction UFID User Files Workgroup The timeslice is the maximum number of milliseconds a process in that workgroup can hold the CPU before returning to the Scheduler to have its priority recalculated(TIMESLICE=value). Values must be multiples of 100, with a minimum value of 100 and a maximum value of 32700. The timeslice is an optional workgroup characteristic with a default value 200 milliseconds for CS Default, DS Default, ES Default and user-de ned workgroups.
Index A A, 2-1 absolute pathname, D-1 access management AIFs, 1-5 access privileged level local le information, 3-88 access rights local le information, 3-88 account access global le information, 3-69 account capabilities accounting information, 3-10 systemwide information, 3-314 accounted time process information, 3-202, 3-203 accounting information, 1-7 account capabilities, 3-10 account name, 3-10 account password, 3-10 account password encrypted, 3-10 account password validation, 3-10 account security,
home group, 3-10 initial logon program, 3-10 invalid user logon count, 3-12 item summary, 3-8 linkage, 3-10 local attributes, 3-10 local attributes (account), 3-10 logon count, 3-10 maximum connect (account), 3-10 maximum connect (group), 3-10 maximum CPU (account), 3-10 maximum CPU (group), 3-10 maximum priority (account), 3-10 maximum space (account), 3-10 maximum space (group), 3-10 maximum user priority, 3-10 modifying, 3-4 password aging expiration days, 3-10, 3-13 password aging warning days, 3-10 ret
account password accounting information, 3-10 account password encrypted accounting information, 3-10 account password validation accounting information, 3-10 account security accounting information, 3-10 job/session information, 3-111 process information, 3-203 account users password required accounting information, 3-10, 3-19 accumulated connect (account) accounting information, 3-10 accumulated connect (group) accounting information, 3-10 accumulated CPU (account) accounting information, 3-10 accumulated
AIFGLOBLOCK, 1-10, 3-99 AIFGLOBPUT, 1-10, 3-100 AIFGLOBREL, 1-10, 3-101 AIFGLOBUNLOCK, 1-10, 3-102 ai ntr, 1-3 AIFINTR le, 1-3 AIFJSGET, 1-8, 3-103 AIFJSPUT, 1-8, 3-105 AIFKSMCREATE, 3-120 AIFKSMREAD, 3-124 AIFMOALLOCATE, 1-11, 3-128 AIFMODEALLOCATE, 1-11, 3-132 AIFMODISMOUNT, 1-11, 3-136 AIFMOGET, 1-11, 3-140 AIFMOMOUNT, 1-11, 3-147 AIFMOPUT, 1-11, 3-142 AIFPORTCLOSE, 1-10, 3-154 AIFPORTINT, 1-10, 3-156 AIFPORTOPEN, 1-10, 3-158 AIFPORTRECEIVE, 1-10, 3-167 AIFPORTSEND, 1-10, 3-173 AIF ports maximum system c
spool le information, 3-248 append mode local le information, 3-94 applications shipping with AIFs, 1-4 Architected Interface Facility, 1-1 installation, 1-3 architected interfaces, 1-1 calling AIFs e ciently, 1-5 customer, 1-3 de ned, 1-1 design strategy, 1-2 examples, 3-301, C-1 hardware requirements, 1-1 installing, 1-3 intended use, 1-2 introduction, 1-1 privileged mode, 1-2 shipping products, 1-4 software requirements, 1-1 array, 2-1, 2-2 Arti cial Member, D-1 AS queue base system con guration informat
block o set local le information, 3-88 block size global le information, 3-69 Boost property, D-1 BOT device information, 3-41 break request cancel process information, 3-208 break request done process information, 3-203 break request pending process information, 3-208 broadcastable spool le information, 3-248, 3-264 BS queue base system con guration information, 3-227 BS queue limit system con guration information, 3-227 bu ered access local le information, 3-88 bu er info type, B-1 bu er type, B-1 bytes r
global le information, 3-69 close on exec local le information, 3-94 closing a spool queue, 3-285 closing les AIFCLOSE, 3-26 CM addresses, converting to NM addresses, 3-28 CM area base process information, 3-195 CM area limit process information, 3-195 CM arithmetic trap enabled process information, 3-200 CM arithmetic trap handler pointer process information, 3-200 CMASK process information, 3-203 CM les, D-2 CM le status local le information, 3-88 CM intrinsic error count process information, 3-199 CM int
console mode enable/disable device information, 3-41 Constant Priority Process, D-2 converting CM addresses to NM addresses, 3-28 converting time information, 3-328 copies requested spool le information, 3-248, 3-264 CPU count job/session information, 3-111 CPU limit job/session information, 3-111 CPU time (msecs) process information, 3-202 CPU time (ticks) process information, 3-202 create options ports management, 3-165 creating a new spooler process, 3-286 creation count job/session information, 3-111 cr
D data accepting device information, 3-41 data bits device information, 3-41 data type, 2-1, 2-2 datestr type, B-2 date type, B-2 DB process information, 3-196 DB DST number process information, 3-196 deallocating magneto-optical media drive, 3-132 debug armed status process information, 3-202 Debug commands process information, 3-201 Decayable Boosting, D-2 declaring OS AIFs, 1-3 default heap system con guration information, 3-227 Default workgroup, D-2 degradable priority process information, 3-189 devic
carriage control position, 3-41 con gure block mode, 3-41 console mode enable/disable, 3-41 Ctrl-A read timeout, 3-41 data accepting, 3-41 data bits, 3-41 device available, 3-41 device class access type, 3-32 device class key, 3-32 device class name, 3-32 device key UFID, 3-41 device LDEV, 3-41 device ownership state, 3-41 devices in class, 3-32 device subtype, 3-41 device type, 3-41 device Xon enable/disable, 3-41 down request pending, 3-41 duplicative, 3-41 echo enabled, 3-41 echo end of record, 3-41 end
returning, 3-30 rewind, 3-41 rewind unload, 3-41 security downed device, 3-41, 3-44 special forms mounted, 3-41 spool queues open, 3-41 spool state, 3-41 subsystem break character, 3-41 tape density, 3-41 tape drive unit number, 3-41 terminal password, 3-41, 3-44 terminal type, 3-41 terminal type le, 3-41 track error, 3-41 trailer disable, 3-41 typeahead bypass, 3-41 typeahead data ush, 3-41 typeahead enable/disable, 3-41 unedited terminal mode:alternate EOR, 3-41 unedited terminal mode:subsys break, 3-41 u
disabled user timeout system con guration information, 3-227, 3-240 dismounting magneto-optical media drive, 3-136 disposition spool le information, 3-248, 3-264 DL process information, 3-196 DL initial process information, 3-196 down device timeout system con guration information, 3-227, 3-237 down request pending device information, 3-41 drives type, B-3 DS boost property system con guration information, 3-227 DS quantum system con guration information, 3-227 DS queue base system con guration information,
reply information, 3-214 Envelope, D-3 Envelope Code, D-3 environment le name spool le information, 3-248 environment nil process information, 3-210 EOF global le information, 3-69 EOT device information, 3-41 error checking, 2-3 ES boost property system con guration information, 3-227 ES quantum system con guration information, 3-227 ES queue limit system con guration information, 3-227 ES queue timeslice system con guration information, 3-227 executing priority job/session information, 3-111 systemwide in
global le information, 3-69 local le information, 3-88 systemwide information, 3-311 File Name, D-4 lename type, B-4 le number local le information, 3-88 File Number, D-4 le open ag spool le information, 3-248 le owner global le information, 3-69 le pointer o set local le information, 3-88 le protect device information, 3-41 les AIFINTR, 1-3 closing, 3-26 intrinsic de nitions, 1-3 le state spool le information, 3-248, 3-264 le type global le information, 3-69 systemwide information, 3-311 nishing strategy s
G gap tape device information, 3-41 general resource capabilitie process information, 3-203 get, 2-2, 2-3 GID accounting information, 3-10 process information, 3-203 GID e ective process information, 3-203 global allow mask system con guration information, 3-227 global area management, 3-95, 3-97, 3-99, 3-100, 3-101, 3-102 Global le, 3-62 global le information, 1-8 account access, 3-69 account librarian access, 3-69 ACD required, 3-69 AIFFILEGGET, 3-57 any access, 3-69 blocking factor, 3-69 block size, 3-6
sectors count, 3-69 state change timestamp, 3-69 state change timestamp update, 3-69 temporary, 3-69 UFID, 3-69 user count, 3-69 user label count, 3-69 user label limit, 3-69 virtual address, 3-69 volume restrictions, 3-69 writer count, 3-69 global password expiration date system con guration information, 3-237 global user password expiration days system con guration information, 3-227, 3-239 global user password maximum days system con guration information, 3-227, 3-239 global user password minimum days sy
H I Handler, D-4 handler address ports management, 3-165 hardware requirements, 1-1 header disable device information, 3-41 heap area base process information, 3-196 heap area limit process information, 3-196 HFS, D-4 HFS pathname systemwide information, 3-311 Hierarchical File System, D-4 home group accounting information, 3-10 job/session information, 3-111 process information, 3-203 Home Group, D-4 HPSUSAN system con guration information, 3-227 I32, 2-1 i32rec type, B-5 i64rec type, B-6 idle session te
installing operating system AIFs, 1-3 installing products AIFGLOBINSTALL, 3-98 INSTOS programmatic interface, 3-98 INSTOS utility, 1-3, 1-5 interactive device information, 3-41 job/session information, 3-111 interactive? process information, 3-210 internal data area, 3-95, 3-97 interrupt handler state ports management, 3-165 intrinsic de nitions, 1-3 intrinsics, 1-2 invalid device logon count device information, 3-41, 3-44 invalid user logon count accounting information, 3-12 I/O device class device informa
J JDT dst process information, 3-203 Job, D-4 job accepting device information, 3-41 job information, 1-8 job limit maximum system con guration information, 3-227 job name job/session information, 3-111 process information, 3-203 spool le information, 3-248, 3-264 systemwide information, 3-305 job or data le spool le information, 3-248 job/session information, 1-8 account name, 3-111 account security, 3-111 AIFJSGET, 3-103 AIFJSPUT, 3-105 CI PIN, 3-111 CI time out, 3-111 command allow mask, 3-111 CPU count
start date, 3-111 start time, 3-111 $STDLIST state, 3-111 user capabilities, 3-111 user name, 3-111 job/session key device information, 3-41 job/session number job/session information, 3-111 reply information, 3-214 spool le information, 3-248, 3-264 systemwide information, 3-305, 3-308 Job/Session Number, D-4 job/sessions maximum system con guration information, 3-227 job state job/session information, 3-111 systemwide information, 3-305 Job State, D-4 job wait index job/session information, 3-111 jsdev ty
LDEVs in device class device information, 3-32 left margin device information, 3-41 Limit, D-5 line delete character device information, 3-41 line delete echo device information, 3-41 line speed device information, 3-41 lines per inch device information, 3-41 linkage accounting information, 3-10 Linked Spool le, D-5 listing spool le IDs, 3-257 list of drive ldevs magneto-optical information, 3-146 list of storage slot information magneto-optical information, 3-146 local attributes accounting information, 3-
multi sharer locking, 3-88 NM le status, 3-88 non-block mode, 3-94 NOWAIT I/O?, 3-88 open count, 3-88 opened by UFID, 3-88 output privileged level, 3-88 path identi er, 3-88 pathname, 3-88 process-speci c, 3-77, 3-81 record number, 3-88 record pointer, 3-88 records read count, 3-88 records transferred count, 3-88 records written count, 3-88 returning, 3-77 sharer le numbers, 3-88 sharer PIDs, 3-88 short-mapped, 3-88 short-mapped count, 3-88 UFID, 3-88 locking internal data areas, 3-99 lock management, 1-10
LSTT DST number process information, 3-197 M machine type system con guration information, 3-227, 3-236 Magneto-Optical Disk Library System, 1-10, 1-11 magneto-optical information input ldev, 3-131 list of drive ldevs, 3-146 list of storage slot information, 3-146 media label, 3-131, 3-145 nowait identi er, 3-139, 3-153 number of drives, 3-146 number of mail slots, 3-146 number of storage slots, 3-146 pin, 3-131, 3-135, 3-139, 3-152, 3-153 prompt for media, 3-152 volume set name, 3-145, 3-152 magneto-optic
Maximum CPU Percentage, D-5 maximum le protection system con guration information, 3-227, 3-239 maximum invalid logons per device system con guration information, 3-227, 3-236 maximum invalid user logons system con guration information, 3-227, 3-239 maximum message size ports management, 3-165 maximum normal messages ports management, 3-165 maximum priority (account) accounting information, 3-10 Maximum Quantum, D-5 maximum space (account) accounting information, 3-10 maximum space (group) accounting inform
modifying information magneto-optical media drive, 3-142 modifying internal data area, 3-100 modifying job/session information, 3-105 modifying KSAM le information, 3-126 modifying local le information, 3-81 modifying process information, 3-179 modifying spooler process information, 3-275 modifying spool le information, 3-260 modifying system con guration information, 3-219 mounting magneto-optical media drive, 3-147 MPE File, D-7 mpe name type, B-10 MPE release version system con guration information, 3-22
NM heap maximum system con guration information, 3-227 NM library trap handler pointer process information, 3-201 NMS, D-7 NM stack base process information, 3-195 NM stack default system con guration information, 3-227 NM stack initial SP process information, 3-203 NM stack limit process information, 3-196 NM stack maximum system con guration information, 3-227 NM stack maximum SP process information, 3-203 NM system trap handler pointer process information, 3-201 NM system trap privileged level process in
open les path identi ers process information, 3-208 open les pathnames process information, 3-208 open le UFIDs process information, 3-198 opening a spool queue, 3-274 operating system AIFs installing, 1-3 out of LDEVs system con guration information, 3-227 out of resources system con guration information, 3-227 output device job/session information, 3-111 output priority job/session information, 3-111 systemwide information, 3-305 output privileged level local le information, 3-88 Overall status, 3-62 P p
system con guration information, 3-227, 3-236 password expiration interval in days system con guration information, 3-227, 3-237 password expiration warning system con guration information, 3-227, 3-238 password prompt required system con guration information, 3-227, 3-236 path identi er, B-12 path identi er global le information, 3-69 local le information, 3-88 path identi ers of open les process information, 3-203 path id rec type, B-12 path length maximum system con guration information, 3-227 pathname g
AIFPORTINT, 3-156 AIFPORTOPEN, 3-158 AIFPORTRECEIVE, 3-167 AIFPORTSEND, 3-173 closing a port, 3-154 connectionless send, 3-176 create options, 3-165 enable/disable a handler, 3-156 handler address, 3-165 interrupt handler state, 3-165 make permanent ports, 3-165 maximum message size, 3-165 maximum normal messages, 3-165 message priority, 3-171 message return, 3-171 message with pending interrupt, 3-171 normal message size, 3-165 opening a port, 3-158 receive priority mask, 3-171 receive time out, 3-171 rece
AIFPROCPUT, 3-179 allow mask, 3-203 break request cancel, 3-208 break request done, 3-203 break request pending, 3-208 capabilities, 3-199 child PID, 3-187, 3-188, 3-189, 3-190, 3-191, 3-192, 3-193, 3-194, 3-195, 3-196, 3-197, 3-198, 3-199, 3-200, 3-201, 3-202, 3-203, 3-204, 3-205, 3-206, 3-207, 3-208, 3-209, 3-210, 3-211, 3-212 child PID list, 3-198 child PIN, 3-187, 3-188, 3-189, 3-190, 3-191, 3-192, 3-193, 3-194, 3-195, 3-196, 3-197, 3-198, 3-199, 3-200, 3-201, 3-202, 3-203, 3-204, 3-205, 3-206, 3-207, 3
item summary, 3-183 JDT dst, 3-203 job name, 3-203 last FOPEN error, 3-199 last KOPEN error, 3-199 LSTT address, 3-197 LSTT DST number, 3-197 modifying, 3-179 NM arithmetic trap handler pointer, 3-200 NM arithmetic trap mask, 3-200 NM errors entry rst, 3-194 NM errors entry last, 3-194 NM errors intrinsics, 3-194 NM errors lost, 3-194 NM errors total number, 3-194 NM library trap handler pointer, 3-201 NM stack base, 3-195 NM stack initial SP, 3-203 NM stack limit, 3-196 NM stack maximum SP, 3-203 NM system
Q initial, 3-196 ready queue start, 3-202 reasons for boost, 3-190 resource capabilities, 3-202 returning, 3-177 scheduling queue, 3-189 scheduling state, 3-189 short-mapped space allowed, 3-198 short-mapped space used, 3-198 sibling PID, 3-187, 3-188, 3-189, 3-190, 3-191, 3-192, 3-193, 3-194, 3-195, 3-196, 3-197, 3-198, 3-199, 3-200, 3-201, 3-202, 3-203, 3-204, 3-205, 3-206, 3-207, 3-208, 3-209, 3-210, 3-211, 3-212 sibling PIN, 3-187, 3-188, 3-189, 3-190, 3-191, 3-192, 3-193, 3-194, 3-195, 3-196, 3-197, 3-
process information, 3-195 program pathname process information, 3-203 prompt for media magneto-optical information, 3-152 purge-pending workgroups scanning for, 3-240 purgescan, 3-240 system con guration information, 3-240 put, 2-2, 2-3 Put, 3-62 Q R Q initial process information, 3-196 quiet mode job/session information, 3-111 reader count global le information, 3-69 read timeout device information, 3-41 read timer device information, 3-41 read trigger character device information, 3-41 ready date spool
local le information, 3-88 records written count local le information, 3-88 record type global le information, 3-69 systemwide information, 3-311 record width device information, 3-41 recursion level systemwide information, 3-311 released global le information, 3-69 releasing a spool le, 3-279 releasing internal data areas, 3-101 reply information, 1-8 AIFREPLYGET, 3-213 creation time, 3-214 entry active, 3-214 job/session number, 3-214 process type, 3-214 reply message length, 3-214 reply message source, 3
job/session information, 3-111 resuming a suspended spooler process, 3-282 Return array, D-10 returning accounting information, 3-2 returning con guration information, 3-217 returning device characteristics, 3-33 returning device information, 3-30 returning global le information, 3-57 returning information magneto-optical media drive, 3-140 returning job/session information, 3-103 returning KSAM le information, 3-120, 3-124 returning local le information, 3-77 returning process information, 3-177 returning
ports management, 3-176 serial number system con guration information, 3-227 Session, D-11 session information, 1-8 session/job information AIFJSGET, 3-103 AIFJSPUT, 3-105 modifying, 3-105 returning, 3-103 session limit maximum system con guration information, 3-227 session or job systemwide information, 3-305 session status job/session information, 3-111 sharer le numbers local le information, 3-88 sharer PIDs local le information, 3-88 shipping products, 1-4 short-mapped local le information, 3-88 short-m
AIFSPPOPENQ, 3-274 AIFSPPPUT, 3-275 AIFSPPRELEASE, 3-279 AIFSPPRESUME, 3-282 AIFSPPSHUTQ, 3-285 AIFSPPSTART, 3-286 AIFSPPSTOP, 3-288 AIFSPPSUSPEND, 3-290 closing a spool queue, 3-285 creating a new spooler process, 3-286 device outfence, 3-272, 3-278 nishing strategy, 3-272 item summary, 3-271 LDEV number, 3-272 modifying, 3-275 opening spool queue, 3-274 PIN, 3-272 process kind, 3-272 process state, 3-272 releasing a spool le, 3-279 resuming a suspended process, 3-282 returning, 3-268 spool le ID, 3-272 st
device type, 3-248 disposition, 3-248, 3-264 environment le name, 3-248 le designator, 3-248, 3-264 le open ag, 3-248 le state, 3-248, 3-264 foptions, 3-248 forms ID, 3-248, 3-264 forms message, 3-248 incomplete, 3-248, 3-264 item summary, 3-247 job name, 3-248, 3-264 job or data le, 3-248 job/session number, 3-248, 3-264 linking, 3-253 listing IDs, 3-257 modifying, 3-260 page count, 3-248, 3-264 priority, 3-248, 3-264 private, 3-248 ready date, 3-248, 3-264 ready time, 3-248, 3-264 record count, 3-248 rest
stack space ID process information, 3-195 start date job/session information, 3-111 start time job/session information, 3-111 state change timestamp global le information, 3-69 state change timestamp update global le information, 3-69 status, 2-4 status type, B-15 $STDLIST of aborted job spool le information, 3-248, 3-264 systemwide information, 3-317 $STDLIST state job/session information, 3-111 stop spooler process, 3-288 storage slot type, B-15 stream priviledge and authorization system con guration info
cross stream restriction and authorization, 3-227, 3-238 CS boost property, 3-227 CS quantum, 3-227 CS quantum maximum, 3-227 CS quantum minimum, 3-227 CS queue base, 3-227 CS queue limit, 3-227 CS queue timeslice, 3-227 default heap, 3-227 disabled user timeout, 3-227, 3-240 down device timeout, 3-227, 3-237 DS boost property, 3-227 DS quantum, 3-227 DS queue base, 3-227 DS queue timeslice, 3-227 embedded password disallow, 3-227, 3-238 ES boost property, 3-227 ES quantum, 3-227 ES queue limit, 3-227 ES qu
NM stack default, 3-227 NM stack maximum, 3-227 open les maximum, 3-227 out of LDEVs, 3-227 out of resources, 3-227 password encryption, 3-227, 3-236 password expiration interval in days, 3-227, 3-237 password expiration warning, 3-227, 3-238 password prompt required, 3-227, 3-236 path length maximum, 3-227 physical console LDEV, 3-227 PIN highwater mark, 3-227 processes maximum, 3-227 processors count, 3-227 processors maximum, 3-227 programmatic command disabling warning, 3-227, 3-237 purgescan, 3-240 ret
AIFSYSWIDEGET, 3-293 executing priority, 3-305 le code, 3-311 le name, 3-311 le type, 3-311 group capabilities, 3-314 group name, 3-305, 3-314 HFS pathname, 3-311 ignore non-fatal errors?, 3-313 input priority, 3-305 job name, 3-305 job/session number, 3-305, 3-308 job state, 3-305 number of spool le pages, 3-317 open les, 3-308 output priority, 3-305 priority, 3-308 privileged level, 3-311 process capabilities, 3-308 process type, 3-308 record type, 3-311 recursion level, 3-311 scheduling queue, 3-308 sche
T U tape density device information, 3-41 tape drive unit number device information, 3-41 target device spool le information, 3-248, 3-264 temp le, 3-62 temporary global le information, 3-69 terminal password device information, 3-41, 3-44 terminal type device information, 3-41 terminal type le device information, 3-41 terminate spooler process, 3-288 tick/msec conversion factor system con guration information, 3-227 time information converting, 3-328 time out for send ports management, 3-176 Timeslice, D
process information, 3-203 unedited terminal mode device information, 3-41 unit busy device information, 3-41 unit online device information, 3-41 unlocking internal data areas, 3-102 UNSAT handler name process information, 3-201 UNSAT handler pointer process information, 3-201 upper input spoolid limit system con guration information, 3-241 upper job limit system con guration information, 3-241 upper output spoolid limit system con guration information, 3-242 upper session limit system con guration informa
useri name invalid? accounting information, 3-12 user invalid logon count accounting information, 3-10 user label count global le information, 3-69 user label limit global le information, 3-69 user local attributes systemwide information, 3-314 user name accounting information, 3-10 job/session information, 3-111 process information, 3-203 systemwide information, 3-305, 3-314 user name invalid accounting information, 3-10 user password accounting information, 3-10 user password aging maximum days accounting
V W X Index-46 validating user access, 1-5 variables system, 1-9 vendor ID, 1-3 veri cation item status, 2-4 verifying information, 1-6 ver item nums, 3-62 ver items, 3-62 ver item statuses, 3-62 version ID system con guration information, 3-227 virtual address global le information, 3-69 volume restrictions global le information, 3-69 volume set name magneto-optical information, 3-145, 3-152 volume set name (group) accounting information, 3-10 VPLUS block mode device information, 3-41 VUF system con gu