skip book previous and next navigation links
go up to top of book: HP OpenVMS Alpha Partitioning and Galaxy Guide HP OpenVMS Alpha Partitioning and Galaxy Guide
go to beginning of chapter: Galaxy and NUMA Commands and Lexicals Galaxy and NUMA Commands and Lexicals
go to previous page: CPU-Related DCL Commands CPU-Related DCL Commands
go to next page: DCL Command ExamplesDCL Command Examples
end of book navigation links

Galaxy-Related DCL Lexical Functions  



This section describes DCL lexical function item codes F$GETSYI and F$GETJPI DCL used for Galaxy, Partitioning, SMP, and RAD setup.

Table 4   Galaxy F$GETSYI Item Codes
Item Code Type Description
GLX_MAX_MEMBERS
Integer
Returns the maximum count of instances that may join the current Galaxy configuration.
GLX_FORMATION
String
Returns a time-stamp string when the Galaxy configuration, of which this instance is a member, was created.
GLX_TERMINATION
String
Returns a time-stamp string when the Galaxy configuration, of which this instance last was a member, was terminated.
GLX_MBR_NAME
String
Returns a string indicating the names which are known in the Galaxy membership.
GLX_MBR_MEMBER
Integer
Returns a 64-byte integer. Each 8 bytes represents a Galaxy member, listed from 7 to 0. The value is 1 if the instance is currently a member, 0 if not a member.

Table 5   Partitioning F$GETSYI Item Codes
Item Code Type Description
HP_ACTIVE_CPU_CNT
Integer
Returns the count of CPUs in the hard partition that are not currently in firmware console mode. For OpenVMS this implies that the CPU is in, or in the process of joining, the active set in one of the instances in the hard partition.
HP_ACTIVE_SP_CNT
Integer
Returns the count of active operating system instances currently executing within the hard partition.
HP_CONFIG_SP_CNT
Integer
Returns the maximum count of soft partitions within the current hard partition. This count does not imply that an operating system instance is currently running within any given soft partition.
HP_CONFIG_SBB_CNT
Integer
Returns a count of the existing system building blocks within the current hard partition.

Table 6   SMP F$GETSYI Item Codes
Item Code Type Description
ACTIVE_CPU_MASK
Integer
Returns a value that represents a CPU-indexed bitvector. When a particular bit position is set, the processor with that CPU ID value is a member of the instance's active set - those currently participating in the OpenVMS SMP scheduling activities.
AVAIL_CPU_MASK
Integer
Returns a value that represents a CPU-indexed bitvector. When a particular bit position is set, the processor with that CPU ID value is a member of the instance's configure set - those owned by the partition and controlled by the issuing instance.
POTENTIAL_CPU_MASK
Integer
Returns a value that represents a CPU-indexed bitvector. When a particular bit position is set, the processor with that CPU ID value is a member of the instance's potential set. A CPU in the potential set implies that it could actively join the VMS active set for this instance if it is ever owned by it. To meet this rule the CPU's characteristics must match hardware and software compatibility rules defined particularly for that instance.
POWERED_CPU_MASK
Integer
Returns a value that represents a CPU-indexed bitvector. When a particular bit position is set, the processor with that CPU ID value is a member of the instance's powered set - those CPUs physically existing within the hard partition and powered up for operation.
PRESENT_CPU_MASK
Integer
Returns a value that represents a CPU-indexed bitvector. When a particular bit position is set, the processor with that CPU ID value is a member of the instance's present set - those CPUS physically existing within the hard partition.
CPUCAP_MASK
String
Returns a list of hexadecimal values, separated by commas and indexed by CPU ID. Each individual value represents a bitvector; when set, the corresponding user capability is enabled for that CPU.
PRIMARY_CPUID
Integer
Returns the CPU ID of the primary processor for this OpenVMS instance.
MAX_CPUS
Integer
Returns the maximum number of CPUs that could be recognized by this instance.
CPU_AUTOSTART
Integer
Returns a list of zeroes and ones, separated by commands and indexed by CPU ID. Any entry with a value of one indicates that specific CPU will be brought into the VMS active set if it transitions into the current instance from outside, or is powered up while already owned.
CPU_FAILOVER
Integer
Returns list of numeric partition IDs, separated by commas and indexed by CPU ID, that define the destination of the processor if the current instance should crash.
POTENTIALCPU_CNT
Integer
The count of CPUs in the hard partition that are members of the potential set for this instance. A CPU in the potential set implies that it could actively join the VMS active set for this instance if it is ever owned by it. To meet this rule the CPU's characteristics must match hardware and software compatibility rules defined particularly for that instance.
PRESENTCPU_CNT
Integer
The count of CPUs in the hard partition that physically reside in a hardware slot.
POWEREDCPU_CNT
Integer
The count of CPUs in the hard partition that are physically powered up.

Table 7   RAD F$GETJPI Item Code
Item Code Type Description
HOME_RAD
Integer
Home resource affinity domain (RAD).

Table 8   RAD F$GETSYI Item Codes
Item Code Type Description
RAD_CPUS
Integer
Returns list of RAD,CPU pairs, separated by commas.
RAD_MEMSIZE
Integer
Returns list of RAD,PAGES pairs, separated by commas.
RAD_MAX_RADS
Integer
Returns the maximum number of RADS possible on this platform. The value is always 8 (regardless of number of quad building blocks (QBBs) physically present).
RAD_SHMEMSIZE
Integer
Returns list of RAD,PAGES pairs, separated by commas.


go to previous page: CPU-Related DCL Commands CPU-Related DCL Commands
go to next page: DCL Command ExamplesDCL Command Examples