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])
1 – Return Value
Either an integer or a character string, depending on the item
you request.
2 – 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. Here are the items you can specify
to get information about either your local node or another node
in your OpenVMS Cluster system. If you do not specify the node
argument, the information is returned for the local node. * Alpha
and Integrity servers only ** VAX only + I64 only
ACTIVE_CPU_MASK* ACTIVECPU_CNT ARCHFLAG
ARCH_NAME ARCH_TYPE AVAIL_CPU_MASK*
AVAILCPU_CNT BOOT_DEVICE* BOOTTIME
CHARACTER_EMULATED CLUSTER_EVOTES CLUSTER_FSYSID
CLUSTER_FTIME CLUSTER_MEMBER CLUSTER_NODES
CLUSTER_QUORUM CLUSTER_VOTES COMMUNITY_ID*
CONSOLE_VERSION* CONTIG_GBLPAGES CPU**
CPU_AUTOSTART* CPU_FAILOVER* CPUCAP_MASK*
CPUTYPE* CWLOGICALS DECIMAL_EMULATED
DECNET_FULLNAME DECNET_VERSION D_FLOAT_EMULATED
ERLBUFFERPAG_S2* ERLBUFFERPAGES ERRORLOGBUFF_S2*
ERRORLOGBUFFERS F_FLOAT_EMULATED FREE_GBLPAGES
FREE_GBLSECTS FREE_PAGES G_FLOAT_EMULATED
GALAXY_ID* GALAXY_MEMBER* GALAXY_PLATFORM*
GALAXY_SHMEMSIZE* GH_RSRVPGCNT* GLX_FORMATION*
GLX_MAX_MEMBERS* GLX_MBR_MEMBER* GLX_MBR_NAME*
GLX_TERMINATION* HP_ACTIVE_CPU_CNT* HP_ACTIVE_SP_CNT*
HP_CONFIG_SBB_CNT* HP_CONFIG_SP_CNT* HW_MODEL
HW_NAME ITB_ENTRIES* MAX_CPUS*
MEMSIZE MODIFIED_PAGES MULTITHREAD
NODENAME NODE_AREA NODE_CSID
NODE_EVOTES NODE_HWTYPE NODE_HWVERS
NODE_NUMBER NODE_QUORUM NODE_SWINCARN
NODE_SWTYPE NODE_SWVERS NODE_SYSTEMID
NODE_VOTES NPAGED_FREE* NPAGED_INUSE*
NPAGED_LARGEST* NPAGED_TOTAL* PAGED_FREE*
PAGED_INUSE* PAGED_LARGEST* PAGED_TOTAL*
PAGEFILE_FREE PAGEFILE_PAGE PAGE_SIZE
PALCODE_VERSION* PARTITION_ID* POTENTIAL_CPU_MASK*
POTENTIALCPU_CNT* POWERED_CPU_MASK* POWEREDCPU_CNT*
PRESENT_CPU_MASK* PRESENTCPU_CNT* PRIMARY_CPUID*
QUANTUM RAD_CPUS RAD_MAX_RADS
RAD_MEMSIZE RAD_SHMEMSIZE REAL_CPUTYPE*
SCS_EXISTS SCSNODE* SID
SWAPFILE_FREE SWAPFILE_PAGE SYSTEM_RIGHTS
SYSTEM_UUID +SYSTYPE* TOTAL_PAGES
USED_GBLPAGCNT USED_GBLPAGMAX USED_PAGES
VECTOR_EMULATOR VERSION VP_MASK
VP_NUMBER
* Alpha only ** VAX only + I64 only
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.
3 – 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.