Difference between revisions of "F$GETSYI()"

From VSI OpenVMS Wiki
Jump to: navigation, search
(item)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
'''F$GETSYI()''' is a [[Lexical function|lexical function]] that 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).
+
<nowiki>Insert non-formatted text here</nowiki>'''F$GETSYI()''' is a [[Lexical functions|lexical function]] that 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=
 
=Format=
Line 7: Line 7:
 
==item==
 
==item==
  
In addition to the items below, you can specify any [[System Parameters|system parameter]].
+
In addition to the [[$GETSYI#Item Codes|$GETSYI items]] (subtract "SYI$_" from their names to get F$GETSYI items), you can specify any [[System Parameters|system parameter]].
  
 
==node-name==
 
==node-name==

Latest revision as of 07:01, 18 February 2020

Insert non-formatted text hereF$GETSYI() is a lexical function that 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])

item

In addition to the $GETSYI items (subtract "SYI$_" from their names to get F$GETSYI items), you can specify any system parameter.

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.

Examples

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

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

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

$ 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
      
$ RADCPU = F$GETSYI("RAD_CPUS")
$ SHOW SYMBOL RADCPU
  0,0,0,1,1,4,1,5