VMS Help Lexicals, F$GETSYI  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Returns status and identification information about the local
    system (or about a node in the local dual-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.

    ACTIVECPU_CNT        ARCHFLAG             ARCH_NAME
    ARCH_TYPE            AVAILCPU_CNT         BOOTTIME
    CHARACTER_EMULATED   CLUSTER_EVOTES       CLUSTER_FSYSID
    CLUSTER_FTIME        CLUSTER_MEMBER       CLUSTER_NODES
    CLUSTER_QUORUM       CLUSTER_VOTES        CONSOLE_VERSION*
    CONTIG_GBLPAGES      CPU**                CPUTYPE*
    CWLOGICALS           DECIMAL_EMULATED     DECNET_FULLNAME
    DECNET_VERSION       D_FLOAT_EMULATED     ERRORLOGBUFFERS
    F_FLOAT_EMULATED     FREE_GBLPAGES        FREE_GBLSECTS
    G_FLOAT_EMULATED     GH_RSRVPGCNT*        HW_MODEL
    HW_NAME              ITB_ENTRIES*         MEMSIZE
    MULTITHREAD          NODENAME             NODE_AREA
    NODE_CSID            NODE_EVOTES          NODE_HWVERS
    NODE_NUMBER          NODE_QUORUM          NODE_SWINCARN
    NODE_SWTYPE          NODE_SWVERS          NODE_SYSTEMID
    NODE_VOTES           PAGEFILE_FREE        PAGEFILE_PAGE
    PAGE_SIZE            PALCODE_VERSION*     QUANTUM
    RAD_CPUS*            RAD_MAX_RADS*        RAD_MEMSIZE*
    RAD_SHMEMSIZE*       REAL_CPUTYPE*        SCS_EXISTS
    SID                  SWAPFILE_FREE        SWAPFILE_PAGE
    SYSTEM_RIGHTS        SYSTYPE*             USED_GBLPAGCNT
    USED_GBLPAGMAX       VECTOR_EMULATOR      VERSION
    VP_MASK              VP_NUMBER

     * Alpha specific  ** VAX specific

    You can also specify any of the system parameters listed in the
    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("BJOBLIM")
      $ SHOW SYMBOL LIM
        LIM = 16   Hex = 00000010  Octal = 00000000020

      This example uses the system parameter BJOBLIM 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.

      This parameter is supported only on AlphaServer GS160 systems.