[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS DCL Dictionary


Previous Contents Index

F$GETSYI

Returns status and identification information about the local system (or about a node in the local mixed-architecture OpenVMS Cluster system, if your system is part of an OpenVMS Cluster).

Format

F$GETSYI (item [,node-name] [,cluster-id])

Return Value


Either an integer or a character string, depending on the item you request.

Arguments

item

Indicates the type of information to be reported about the local node (or about another node in your OpenVMS Cluster, if your system is part of an OpenVMS Cluster). Specify the item as a character string expression.

You can also specify any of the system parameters listed in the HP OpenVMS System Management Utilities Reference Manual.

node-name

Specifies the node in your OpenVMS Cluster system for which information is to be returned. Specify the node as a character string expression. You cannot use the asterisk (*) and the percent sign (%) wildcard characters to specify the node-name argument.

cluster-id

Specifies the cluster node identification number for which the information is to be returned.

To get information for all the nodes in a cluster, use the F$CSID lexical function to obtain each cluster system identification number, and use the cluster-id argument of F$GETSYI to gather information about each node.


Description

The F$GETSYI lexical function invokes the $GETSYI system service to return status and identification information about the local system (or about a node in the local OpenVMS Cluster, if your system is part of a cluster). The F$GETSYI function returns information on the items that can be specified with the $GETSYI system service. For more information about the $GETSYI system service, see the HP OpenVMS System Services Reference Manual.

You can specify the node for which you want information by supplying either the node-name or the cluster-id argument, but not both.

Table DCLI-10 lists the items you can specify with the F$GETSYI lexical function.

Table DCLI-10 F$GETSYI Items
Item Return Type Information Returned
++ACTIVE_CPU_MASK Integer 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.
ACTIVECPU_CNT Integer The count of CPUs actively participating in the current boot of a symmetric multiprocessing (SMP) system.
ARCHFLAG Integer Architecture flags for the system.
ARCH_NAME String Name of CPU architecture: Alpha for OpenVMS Alpha.
ARCH_TYPE Integer Type of CPU architecture; 1 for VAX, 2 for Alpha, and 3 for Integrity servers
++AVAIL_CPU_MASK Integer 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.
AVAILCPU_CNT Integer The count of CPUs recognized in the system.
BOOT_DEVICE
(Alpha/Integrity servers only)
String The name of the device from which the system was booted. For a system with a shadowed system disk, BOOT_DEVICE returns the name of the member device from which the shadow set was formed.
BOOTTIME String The time the system was booted.
CHARACTER_EMULATED String TRUE or FALSE to indicate whether the character string instructions are emulated on the CPU.
CLUSTER_EVOTES Integer Total number of votes in the cluster.
CLUSTER_FSYSID String System identification number for first node to boot in the cluster (the founding node). This number is returned as a character string containing a hexadecimal number.
CLUSTER_FTIME String The time when the first node in the cluster was booted.
CLUSTER_MEMBER String TRUE or FALSE if the node is a member of the local cluster.
CLUSTER_NODES Integer Total number of nodes in the cluster, as an integer.
CLUSTER_QUORUM Integer Total quorum for the cluster.
CLUSTER_VOTES Integer Total number of votes in the cluster.
++CONSOLE_VERSION String Console firmware version.
CONTIG_GBLPAGES Integer Total number of free, contiguous global pages.
++COMMUNITY_ID Integer The hardware community ID for the issuing instance within the hard partition. Supported only on AlphaServer systems that support partitioning.
++CPU_AUTOSTART Integer 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 OpenVMS active set if it transitions into the current instance from outside, or is powered up while already owned.
++CPU_FAILOVER Integer 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. Supported only on AlphaServer systems that support partitioning.
++CPUCAP_MASK String 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.
++CPUTYPE Integer On Alpha, the processor type, as stored in the hardware restart parameter block (HWRPB). The value of 2 represents a DECchip 21064 processor.
CWLOGICALS Boolean Flag indicating that the clusterwide logical name database has been initialized on the CPU.
DECIMAL_EMULATED String TRUE or FALSE to indicate whether the decimal string instructions are emulated on the CPU.
DECNET_FULLNAME String The node name of a DECnet Phase IV system or the node full name of a DECnet-Plus system.
DECNET_VERSION String The information on the particular version and ECO level of the DECnet package installed on the local system. This item returns a string containing a hexadecimal number, using the following format:
  • Byte 0 = Customer ECO
  • Byte 1 = DECnet ECO
  • Byte 2 = DECnet phase (4 for Phase IV, 5 for DECnet-Plus for OpenVMS)
  • Byte 3 = Reserved

To distinguish Phase IV from DECnet-Plus for OpenVMS, use the byte containing the DECnet version (byte 2).

For additional information on interpreting byte 0 and byte 1, see the current HP DECnet-Plus for OpenVMS Release Notes documentation.

D_FLOAT_EMULATED String TRUE or FALSE to indicate whether the D_floating instructions are emulated on the CPU.
ERLBUFFERPAGES Integer Number of pagelets on Alpha and Integrity servers used for each S0 errorlog buffer.
++ERLBUFFERPAG_S2 Integer Number of system pagelets (on Alpha and Integrity servers used for each S2 errorlog buffer.)
++ERRORLOGBUFF_S2 Integer Number of S2 errorlog buffers.
ERRORLOGBUFFERS Integer Number of S0 errorlog buffers.
F_FLOAT_EMULATED String TRUE or FALSE to indicate whether the F_floating instructions are emulated on the CPU.
FREE_GBLPAGES Integer Current count of free global pages.
FREE_GBLSECTS Integer Current count of free global section table entries.
FREE_PAGES Integer Total number of free pages.
G_FLOAT_EMULATED String TRUE or FALSE to indicate whether the G_floating instructions are emulated on the CPU.
++GALAXY_ID Integer The 128-bit Galaxy ID. Supported only on AlphaServer GS series systems.
++GALAXY_MEMBER Integer 1 if member of a Galaxy sharing community, 0 if not. Supported only on AlphaServer GS series systems.
++GALAXY_PLATFORM Integer 1 if running on a Galaxy platform, 0 if not. Supported only on AlphaServer GS series systems.
++GALAXY_SHMEMSIZE Integer The number of shared memory pages. If the current instance is not a member of a Galaxy, no shared memory is reported. Supported only on AlphaServer GS series systems.
++GH_RSRVPGCNT Integer On Alpha, number of pages covered by granularity hints to reserve for use by the INSTALL utility after system startup has completed.
++GLX_FORMATION String A time-stamp string when the Galaxy configuration, of which this instance is a member, was created. Supported only on AlphaServer GS series systems.
++GLX_MAX_MEMBERS Integer The maximum count of instances that may join the current Galaxy configuration. Supported only on AlphaServer GS series systems.
++GLX_MBR_MEMBER Integer A 64-byte integer. Each 8 bytes represents a Galaxy member number, listed from 7 to 0. The value is 1 if the instance is currently a member, 0 if not a member. Supported only on AlphaServer GS series systems.
++GLX_MBR_NAME String A string indicating the names which are known in the Galaxy membership. Supported only on AlphaServer GS series systems.
++GLX_TERMINATION String A time-stamp string when the Galaxy configuration, of which this instance last was a member, was terminated. Supported only on AlphaServer GS series systems.
++HP_ACTIVE_CPU_CNT Integer 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. Supported only on AlphaServer systems that support partitioning.
++HP_ACTIVE_SP_CNT Integer The count of active operating system instances currently executing within the hard partition. Supported only on AlphaServer systems that support partitioning.
++HP_CONFIG_SBB_CNT Integer A count of the existing system building blocks within the current hard partition. Supported only on AlphaServer systems that support partitioning.
++HP_CONFIG_SP_CNT Integer 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. Supported only on AlphaServer systems that support partitioning.
HW_MODEL Integer An integer that identifies the Alpha node's model type. An integer greater than 1023 represents the Alpha operating system.
HW_NAME String The Alpha model name.
++ITB_ENTRIES Integer On Alpha, number of I-stream translation buffer entries that support granularity hints to be allocated for resident code.
++MAX_CPUS Integer The maximum number of CPUs that could be recognized by this instance.
MEMSIZE Integer Number of pages of memory in the system configuration.
MODIFIED_PAGES Integer Total number of modified pages.
MULTITHREAD Integer Value of the MULTITHREAD system parameter.
NODENAME String Node name (does not include the following double colon).
NODE_AREA Integer The DECnet area for the target node.
NODE_CSID String The CSID of the specified node, as a string containing a hexadecimal number. The CSID is a form of system identification.
NODE_EVOTES Integer Number of votes allotted to the node.
NODE_HWVERS String Hardware version of the specified node.
NODE_NUMBER Integer The DECnet number for the specified node.
NODE_QUORUM Integer Quorum that the node has.
NODE_SWINCARN String Software incarnation number for the specified node. This number is returned as a string containing a hexadecimal number.
NODE_SWTYPE String Type of operating system software used by the specified node.
NODE_SWVERS String Software version of the specified node.
NODE_SYSTEMID String System identification number for the specified node. This number is returned as a string containing a hexadecimal number.
NODE_VOTES Integer Number of votes allotted to the node.
++NPAGED_FREE Integer Number of free bytes in nonpaged pool.
++NPAGED_INUSE Integer Total number of bytes currently being used in nonpaged pool.
++NPAGED_LARGEST Integer Size of the largest contiguous area of free memory in nonpaged pool.
++NPAGED_TOTAL Integer Total size (in bytes) of nonpaged pool.
++PAGED_FREE Integer Number of free bytes in paged pool.
++PAGED_INUSE Integer Total number of bytes currently being used in paged pool.
++PAGED_LARGEST Integer Size of the largest contiguous area of free memory in paged pool.
++PAGED_TOTAL Integer Total size (in bytes) of paged pool.
PAGEFILE_FREE Integer Number of free pages in the currently installed paging files.
PAGEFILE_PAGE Integer Number of pages in the currently installed paging files.
PAGE_SIZE Integer Indicates the number of bytes in a physical page.
++PALCODE_VERSION String Version of the PALCODE (privileged architectural library) on your Alpha system.
++PARTITION_ID Integer The soft partition ID. Supported only on AlphaServer systems that support partitioning.
++POTENTIAL_CPU_MASK Integer 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 OpenVMS 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.
++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 OpenVMS 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 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.
++POWEREDCPU_CNT Integer The count of CPUs in the hard partition that are physically powered up.
++PRESENT_CPU_MASK Integer 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. Being in the present set does not imply that it is part of the powered set.
++PRESENTCPU_CNT Integer The count of CPUs in the hard partition that physically reside in a hardware slot.
++PRIMARY_CPUID Integer The CPU ID of the primary processor for this OpenVMS instance.
QUANTUM Integer Maximum amount of processor time a process can receive while other processes are waiting.
RAD_CPUS Integer List of RAD, CPU pairs, separated by commas. RAD is supported on AlphaServer GS series systems and starting from OpenVMS Version 8.4, support is extended to NUMA capable Integrity servers.
RAD_MAX_RADS Integer The maximum number of RADS possible on this platform.RAD is supported on AlphaServer GS series systems and starting from OpenVMS Version 8.4, support is extended to NUMA capable Integrity servers.
RAD_MEMSIZE Integer List of RAD, PAGES pairs, separated by commas. RAD is supported on AlphaServer GS series systems and starting from OpenVMS Version 8.4, support is extended to NUMA capable Integrity servers.
RAD_SHMEMSIZE Integer List of RAD,PAGES pairs, separated by commas. RAD is supported on AlphaServer GS series systems and starting from OpenVMS Version 8.4, support is extended to NUMA capable Integrity servers.
++REAL_CPUTYPE Integer The actual CPU type of the primary CPU of the system extracted from the hardware restart parameter block (HWRPB).
SCS_EXISTS String TRUE or FALSE to indicate whether the system communication subsystem (SCS) is currently loaded on a VMS node.
++SCSNODE String The Galaxy instance name. Supported only on AlphaServer systems that support partitioning.
SID Integer System identification register. On Alpha, returns a value where all fields are zero except the CPU type field, which always contains the value of 256.
SWAPFILE_FREE Integer Number of free pages in the currently installed swapping files.
SWAPFILE_PAGE Integer Number of pages in the currently installed swapping files.
SYSTEM_RIGHTS String The contents of the system rights list on the local system. If you specify a remote system, a null string ("") is returned. This item returns a list of identifier names separated by commas (,).
§SYSTEM_UUID Integer The 128-bit Universal Unique Identifier (UUID) for the system.
++SYSTYPE Integer On Alpha, the family or system hardware platform. For example, the integer 2 represents a DEC 4000, the integer 3 represents a DEC 7000 or DEC 10000, and the integer 4 represents a DEC 3000.
TOTAL_PAGES Integer Total number of physical memory pages.
USED_GBLPAGCNT Integer Number of pages currently in use in the global page table.
USED_GBLPAGMAX Integer Maximum number of pages ever in use in the global page table.
USED_PAGES Integer Total number of used pages.
VECTOR_EMULATOR Boolean Flag indicating the presence of the VAX vector instruction emulator facility (VVIEF) in the system.
VERSION String Version of OpenVMS in use (8-character string filled with trailing blanks).
VP_MASK Integer Mask indicating which processors in the system have vector coprocessors.
VP_NUMBER Integer Number of vector processors in the system.

+VAX only
++Alpha only
§Integrity servers only


Examples

#1

$ SYSID = F$GETSYI("SID")
$ SHOW SYMBOL SYSID
  SYSID = 19923201  Hex = 01300101 Octal = 000401
      

This example shows how to use the F$GETSYI function to return the information in the system identification register. Use quotation marks (" ") around the argument SID because it is a string literal. The value returned by F$GETSYI is assigned to the symbol SYSID. Because a node is not specified, information about your current node is returned.

#2

$ MEM = F$GETSYI("CLUSTER_MEMBER", "LONDON")
$ SHOW SYMBOL MEM
  MEM = "TRUE"
      

This example uses the F$GETSYI function to determine whether the node LONDON is a member of the local cluster. The return value TRUE indicates that the remote node LONDON is a member of the cluster.

#3

$ LIM = F$GETSYI("IJOBLIM")
$ SHOW SYMBOL LIM
  LIM = 16   Hex = 00000010  Octal = 00000000020
      

This example uses the system parameter IJOBLIM as an argument for the F$GETSYI function. This argument returns the batch job limit for the current system.

#4

$  DECNETVERS = F$GETSYI("DECNET_VERSION")
$ SHOW SYMBOL DECNETVERS
  DECNETVERS = "00050D01"
$ DECNETPHASE = F$INTEGER(F$EXTRACT(2,2,DECNETVERS))
$ SHOW SYMBOL DECNETPHASE
  DECNETPHASE = 5   Hex = 00000005  Octal = 00000000005
      

This example shows how to use F$GETSYI to return the DECnet version, using the DECNET_VERSION item.

#5

$ RADCPU = F$GETSYI("RAD_CPUS")
$ SHOW SYMBOL RADCPU
  0,0,0,1,1,4,1,5
      

This example uses the system parameter RAD_CPUS as an argument for the F$GETSYI function. This argument returns a list of RAD,CPU pairs, separated by commas. In this example, the first RAD,CPU pair is 0,0, the second pair is 0,1, and so forth.

RAD is supported on AlphaServer GS series systems and starting from OpenVMS Version 8.4, support is extended to NUMA capable Integrity servers.


Previous Next Contents Index