[an error occurred while processing this directive]
![]() |
![]() HP OpenVMS Systems Documentation |
![]() |
HP OpenVMS System Services Reference Manual
If you specify astadr, the AST routine executes at the same access mode as the caller of the $GETJPI service. astprm
AST parameter to be passed to the AST service routine specified by the astadr argument. The astprm argument is the longword parameter. Item Codes
+VAX specific JPI$_IMAGE_WORKPRIVOn Alpha and Integrity server systems, returns the working (active) privilege mask of the installed image.These privileges are returned in a quadword privilege mask and are defined by the $PRVDEF macro. JPI$_IMAGNAMEReturns, as a character string, the directory specification and the image file name.JPI$_IMAGPRIVReturns a quadword mask of the privileges with which the current image was installed. If the current image was not installed, $GETJPI returns the value 0 in the buffer.JPI$_INITIAL_THREAD_PIDOn Alpha and Integrity server systems, returns the PID of the initial thread for the target process. The PID is a longword hexadecimal value.JPI$_INSTALL_RIGHTSOn Alpha and Integrity server systems, returns the binary content of the install rights list as an array of quadword identifiers. Each entry consists of a longword identifier value and longword identifier attributes, as shown in Table SYS-42. The install rights list is a set of identifiers associated with an installed image.JPI$_INSTALL_RIGHTS_SIZEOn Alpha and Integrity server systems, returns a longword integer containing the number of bytes needed to store the install rights.JPI$_JOBPRCCNTReturns the total number of subprocesses owned by the job, which is a longword integer value.JPI$_JOBTYPEReturns the execution mode of the process at the root of the job tree, which is a longword integer value. The symbolic name and value for each execution mode are listed in the following table. The $JPIDEF macro defines the symbolic names.
JPI$_KT_COUNTOn Alpha and Integrity server systems, returns the current count of kernel threads for the target process, which is a longword integer value.JPI$_KT_LIMITOn Alpha and Integrity server systems, returns the maximum number of kernel threads that can be created in the process. A value of 0 indicates that the process does not have a process-specific limit set, and the systemwide limit specified by the SYSGEN parameter MULTITHREAD is used.JPI$_LAST_LOGIN_IReturns, as a quadword absolute time value, the date of the last successful interactive login prior to the current session. It returns a quadword of 0 when processes have not executed the LOGINOUT image.JPI$_LAST_LOGIN_NReturns, as a quadword absolute time value, the date of the last successful noninteractive login prior to the current session. It returns a quadword of 0 when processes have not executed the LOGINOUT image.JPI$_LOGIN_FAILURESReturns the number of login failures that occurred prior to the current session. It returns a longword of 0 when processes have not executed the LOGINOUT image.JPI$_LOGIN_FLAGSReturns a longword bit mask containing information related to the login sequence. It returns a longword of 0 when processes have not executed the LOGINOUT image. The following bits are defined:
JPI$_LOGINTIMReturns the time at which the process was created, which is a standard 64-bit absolute time.JPI$_MASTER_PIDReturns the process identification (PID) of the master process in the job. The PID is a longword hexadecimal value.JPI$_MAXDETACHReturns the maximum number of detached processes allowed for the user who owns the process specified in the call to $GETJPI. This limit is set in the UAF record of the user. The number is returned as a word decimal value. A value of 0 means that there is no limit on the number of detached processes for that user name.JPI$_MAXJOBSReturns the maximum number of active processes allowed for the user who owns the process specified in the call to $GETJPI. This limit is set in the UAF record of the user. The number is returned as a word decimal value. A value of 0 means that there is no limit on the number of active processes for that user name.JPI$_MEMReturns the member number of the process's UIC, which is a longword integer value.JPI$_MODEReturns the mode of the process, which is a longword integer value. The symbolic name and value for each mode are listed in the following table. The $JPIDEF macro defines the symbolic names.
JPI$_MSGMASKReturns the default message mask of the process, which is a longword bit mask.JPI$_MULTITHREADOn Alpha and Integrity server systems, returns the maximum kernel thread count allowed for the target process, which is a longword integer value.JPI$_NODENAMEReturns, as a character string, the name of the OpenVMS Cluster node on which the process is running.JPI$_NODE_CSIDReturns, as a longword hexadecimal integer, the cluster ID of the OpenVMS Cluster node on which the process is running.JPI$_NODE_VERSIONReturns, as a character string, the operating system version number of the OpenVMS Cluster node on which the process is running.JPI$_OWNERReturns the process identification (PID) of the process that created the specified process. The PID is a longword hexadecimal value.JPI$_PAGEFLTSReturns the total number of page faults incurred by the process. This is a longword integer value.JPI$_PAGFILCNTReturns the remaining paging file quota of the process, which is a longword integer value, measured in pages pagelets .JPI$_PAGFILLOCReturns the current paging file assignment of the process. The fourth byte of the returned longword value is the index of the system page file to which the process is currently assigned.JPI$_PARSE_STYLE_IMAGEOn Alpha and Integrity server systems, set by $SET_PROCESS_PROPERTIESW, and can be either PARSE_STYLE$C_TRADITIONAL or PARSE_STYLE$C_EXTENDED (located in PPROPDEF). The return length is one byte.JPI$_PARSE_STYLE_PERMOn Alpha and Integrity server systems, set by $SET_PROCESS_PROPERTIESW, and can be either PARSE_STYLE$C_TRADITIONAL or PARSE_STYLE$C_EXTENDED (located in PPROPDEF). The return length is one byte.JPI$_PERMANENT_AFFINITY_MASKOn Alpha and Integrity server systems, returns the permanent explicit affinity mask for the associated kernel thread.JPI$_PERMANENT_USERCAP_MASKOn Alpha and Integrity server systems, returns the permanent user capability mask for the associated kernel thread.JPI$_PERSONA_AUTHPRIVOn Alpha and Integrity server systems, returns the authorized privilege mask of the persona.These privileges are returned in a quadword privilege mask and are defined by the $PRVDEF macro. JPI$_PERSONA_IDOn Alpha and Integrity server systems, returns, as a longword integer, the ID of the persona.JPI$_PERSONA_PERMPRIVOn Alpha and Integrity server systems, returns the permanent (default) privilege mask of the persona. These privileges are returned in a quadword privilege mask and are defined by the $PRVDEF macro.JPI$_PERSONA_RIGHTSOn Alpha and Integrity server systems, returns the binary content of the persona rights list as an array of quadword identifiers. Each entry consists of a longword identifier value and longword identifier attributes, as listed in Table SYS-42. The persona rights list is a set of identifiers associated with the process.JPI$_PERSONA_RIGHTS_SIZEOn Alpha and Integrity server systems, returns a longword integer containing the number of bytes needed to store the persona rights.JPI$_PERSONA_WORKPRIVOn Alpha and Integrity server systems, returns the privilege mask of the working (active) persona. These privileges are returned in a quadword privilege mask and are defined by the $PRVDEF macro.JPI$_PGFLQUOTAReturns the paging file quota (maximum virtual page count) of the process, which is a longword integer value, measured in pagelets .JPI$_PHDFLAGSReturns the process header flags as a longword bit vector.JPI$_PIDReturns the process identification (PID) of the process. The PID is a longword hexadecimal value.JPI$_P0_FIRST_FREE_VA_64On Alpha and Integrity server systems, this item code returns the 64-bit virtual address of the first free page at the end of the program region (P0 space) of the process.Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes). JPI$_P1_FIRST_FREE_VA_64On Alpha and Integrity server systems, this item code returns the 64-bit virtual address of the first free page at the end of the control region (P1 space) of the process.Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes). JPI$_P2_FIRST_FREE_VA_64On Alpha and Integrity server systems, this item code returns the 64-bit virtual address of the first free page at the end of P2 space of the process.Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes). JPI$_PPGCNTReturns the number of pagelets the process has in the working set. This is a longword integer value.JPI$_PRCCNTReturns, as a longword integer value, the number of subprocesses created by the process. The number returned by JPI$_PRCCNT does not include any subprocesses created by subprocesses of the process named in the procnam argument.JPI$_PRCLMReturns the subprocess quota of the process, which is a longword integer value.JPI$_PRCNAMReturns, as a character string, the name of the process. Because the process name can include up to 15 characters, the buffer length field of the item descriptor should specify at least 15 bytes.JPI$_PRIReturns the current priority of the process, which is a longword integer value.JPI$_PRIBReturns the base priority of the process, which is a longword integer value.JPI$_PROCESS_RIGHTSReturns the binary content of the process rights list as an array of quadword identifiers. Each entry consists of a longword identifier value and longword identifier attributes, as shown in Table SYS-42. Allocate a buffer that is sufficient to hold the process rights list because $GETJPI returns only as much of the list as will fit in the buffer.JPI$_PROC_INDEXReturns, as a longword integer value, the process index number of the process. The process index number is a number between 1 and the system parameter MAXPROCESSCNT, which identifies the process. Although process index numbers are reassigned to different processes over time, at any one instant, each process in the system has a unique process index number.You can use the process index number as an index into system global sections. Because the process index number is unique for each process, its use as an index into system global sections guarantees no collisions with other system processes accessing those sections. The process index is intended to serve users who formerly used the low-order word of the PID as an index number. JPI$_PROCPRIVReturns the default privileges of the process in a quadword bit mask.JPI$_RIGHTSLISTReturns, as an array of quadword identifiers, all identifiers applicable to the process. This includes the process rights list (JPI$_PROCESS_RIGHTS) and the system rights list (JPI$_SYSTEM_RIGHTS). Each entry consists of a longword identifier value and longword identifier attributes, shown in Table SYS-42. Allocate a buffer that is sufficient to hold the rights list because $GETJPI returns only as much of the list as will fit in the buffer.JPI$_RIGHTS_SIZEReturns the number of bytes required to buffer the rights list. The rights list includes both the system rights list and the process rights list. Because the space requirements for the rights list can change between the time you request the size of the rights list and the time you fetch the rights list with JPI$_RIGHTSLIST, you might want to allocate a buffer that is 10 percent larger than this item indicates.JPI$_RMS_DFMBCReturns the default multiblock count.JPI$_RMS_DFMBFIDXReturns the default multibuffer count for local buffers for indexed file operations.JPI$_RMS_DFMBFRELReturns the default multibuffer count for local buffers for relative file operations.JPI$_RMS_DFMBFSDKReturns the default multibuffer count for local buffers for sequential file operations on disk.JPI$_RMS_DFMBFSMTReturns the default multibuffer count for local buffers for sequential file operations on magnetic tape.JPI$_RMS_DFMBFSURReturns the default multibuffer count for file operation on unit record devices.JPI$_RMS_DFNBCReturns the default block count for local buffers for network access to remote files.JPI$_RMS_EXTEND_SIZEReturns the default number of blocks used to extend a sequential file.JPI$_RMS_FILEPROTReturns the default file protection.JPI$_RMS_PROLOGUEReturns the default prolog level for indexed files.JPI$_SCHED_CLASS_NAMEReturns the name of the scheduling class (as a character string) to which this process belongs. Because the class name can include up to 16 characters, the buffer length field of the item descriptor must specify at least 16 bytes. If the process is not class scheduled, then a return length of 0 is returned to the caller.JPI$_SCHED_POLICYOn Alpha and Integrity server systems, returns the current scheduling policy of the specified process. Definitions of the policy values are in the $JPIDEF macro. The buffer length of the item descriptor should specify 4 (bytes).JPI$_SEARCH_SYMLINK_PERMOn Alpha and Integrity server systems, returns the permanent process symlink search modes. Values are JPI$K_SEARCH_SYMLINK_NONE, JPI$K_SEARCH_SYMLINK_ALL, and JPI$K_SEARCH_SYMLINK_NOELLIPS.JPI$_SEARCH_SYMLINK_TEMPOn Alpha and Integrity server systems, returns the temporary process symlink search modes. Values are JPI$K_SEARCH_SYMLINK_NONE, JPI$K_SEARCH_SYMLINK_ALL, and JPI$K_SEARCH_SYMLINK_NOELLIPS.JPI$_SHRFILLMReturns the maximum number of open shared files allowed for the job to which the process specified in the call to $GETJPI belongs. This limit is set in the UAF record of the user who owns the process. The number is returned as a word decimal value. A value of 0 means that there is no limit on the number of open shared files for that job.JPI$_SITESPECReturns the per-process, site-specific longword, which is a longword integer value.JPI$_STATEReturns the state of the process, which is a longword integer value. Each state has a symbolic representation. If the process is currently executing, its state is always SCH$K_CUR. STATEDEF defines the following symbols, which identify the various possible states:
JPI$_STSReturns the first longword of the process status flags, which are contained in a longword bit vector. PCBDEF definitions include the following symbols for these flags:
JPI$_STS2Returns the second longword of the process status flags, which are contained in a longword bit vector. PCBDEF defines the following symbol for these flags:
JPI$_SUBSYSTEM_RIGHTSOn Alpha and Integrity server systems, returns the binary content of the subsystem rights list as an array of quadword identifiers. Each entry consists of a longword identifier value and longword identifier attributes, as listed in Table SYS-42. The subsystem rights list is a set of identifiers associated with a protected subsystem image.
|