|
|
| (8 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| '''F$GETSYU()''' 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]]. |
| | |
| {| class="wikitable"
| |
| |-
| |
| ! Item !! Return type !! Information returned
| |
| |-
| |
| | AI || String || TRUE if after-image (AI) journaling is enabled; FALSE if disabled.
| |
| |-
| |
| | ALQ || Integer || Allocation quantity.
| |
| |-
| |
| | BDT || String || Backup date/time.
| |
| |-
| |
| | BI || String || TRUE if before-image (BI) journaling is enabled; FALSE if disabled.
| |
| |-
| |
| | BKS || Integer || Bucket size.
| |
| |-
| |
| | BLS || Integer || Block size.
| |
| |-
| |
| | CBT || String || TRUE if contiguous-best-try; otherwise FALSE.
| |
| |-
| |
| | CDT || String || Creation date/time.
| |
| |-
| |
| | CTG || String || TRUE if contiguous; otherwise FALSE.
| |
| |-
| |
| | DEQ || Integer || Default extension quantity.
| |
| |-
| |
| | DID || String || Directory ID string.
| |
| |-
| |
| | DIRECTORY || String || Returns TRUE or FALSE. Returns TRUE if it is a directory.
| |
| |-
| |
| | DVI || String || Device name string.
| |
| |-
| |
| | EDT || String || Expiration date/time.
| |
| |-
| |
| | EOF || Integer || Number of blocks used.
| |
| |-
| |
| | ERASE || String || TRUE if a file's contents are erased before a file is deleted; otherwise FALSE.
| |
| |-
| |
| | FFB || Integer || First free byte.
| |
| |-
| |
| | FID || String || File ID string.
| |
| |-
| |
| | FILE_LENGTH_HINT || String || Record count and data byte count in the form (
| |
| |-
| |
| | FSZ || Integer || Fixed control area size.
| |
| |-
| |
| | GBC || Integer || Global buffer count.
| |
| |-
| |
| | GBC32 || Integer || Enhanced longword version of global buffer count with a per-file maximum size of about 2.1 billion for indexed files.
| |
| |-
| |
| | GBCFLAGS || String || Per-file management flags for sizing of global buffer cache. Returns PERCENT if global buffer count is expresses as a percent, DEFAULT if global buffer size is determined at runtime by an algorithm using two global buffer SYSGEN parameters (GB_CACHEALLMAX and GB_DEFPERCENT); or NONE if no per-file management flags are enabled for the file.
| |
| |-
| |
| | GRP || Integer || Owner group number.
| |
| |-
| |
| | JOURNAL_FILE || String || TRUE if the file is a journal; otherwise FALSE.
| |
| |-
| |
| | KNOWN || String || Known file; returns TRUE or FALSE to indicate whether file is installed with the Install utility (INSTALL). However, returns NOSUCHFILE if a file does not exist (for example, the file has been installed but subsequently deleted).
| |
| |-
| |
| | LOCKED || String || TRUE if a file is deaccessed-locked; otherwise FALSE.
| |
| |-
| |
| | LRL || Integer || Longest record length.
| |
| |-
| |
| | MBM || Integer || Owner member number.
| |
| |-
| |
| | MOVE || String || TRUE if movefile operations are enabled; otherwise FALSE.
| |
| |-
| |
| | MRN || Integer || Maximum record number.
| |
| |-
| |
| | MRS || Integer || Maximum record size.
| |
| |-
| |
| | NOA || Integer || Number of areas.
| |
| |-
| |
| | NOBACKUP || String || FALSE if the file is marked for backup; TRUE if the file is marked NOBACKUP.
| |
| |-
| |
| | NOK || Integer || Number of keys.
| |
| |-
| |
| | ORG || String || File organization; returns SEQ, REL, IDX.
| |
| |-
| |
| | PRESHELVED (Alpha/Integrity servers only) || String || TRUE if the file is preshelved; otherwise FALSE.
| |
| |-
| |
| | PRO || String || File protection string.
| |
| |-
| |
| | PVN || Integer || Prolog version number.
| |
| |-
| |
| | RAT || String || Record attributes; returns CR, PRN, FTN, "".
| |
| |-
| |
| | RCK || String || TRUE if read check; otherwise FALSE.
| |
| |-
| |
| | RDT || String || Revision date/time.
| |
| |-
| |
| | RFM || String || Record format string; returns the values VAR, FIX, VFC, UDF, STM, STMLF, STMCR.
| |
| |-
| |
| | RU || String || TRUE if recovery unit (RU) journaling is enabled; returns TRUE or FALSE.
| |
| |-
| |
| | RVN || Integer || Revision number.
| |
| |-
| |
| | SHELVABLE || String || TRUE if the file is shelvable; otherwise FALSE.
| |
| |-
| |
| | SHELVED || String || TRUE if the file is shelved; otherwise FALSE.
| |
| |-
| |
| | STORED_SEMANTICS || String || ASCII string that represents stored semantics.
| |
| |-
| |
| | UIC || String || Owner user identification code (UIC) string.
| |
| |-
| |
| | VERLIMIT || Integer || Version limit number. The value 32767 indicates that no version limit was set.
| |
| |-
| |
| | WCK || String || TRUE if write check; otherwise FALSE.
| |
| |}
| |
|
| |
|
| ==node-name== | | ==node-name== |
| Line 137: |
Line 30: |
| LIM = 16 Hex = 00000010 Octal = 00000000020 | | LIM = 16 Hex = 00000010 Octal = 00000000020 |
|
| |
|
| $ DECNETVERS = F$GETSYI("DECNET_VERSION") | | $ DECNETVERS = F$GETSYI("DECNET_VERSION") |
| $ SHOW SYMBOL DECNETVERS | | $ SHOW SYMBOL DECNETVERS |
| DECNETVERS = "00050D01" | | DECNETVERS = "00050D01" |
| Line 148: |
Line 41: |
| 0,0,0,1,1,4,1,5 | | 0,0,0,1,1,4,1,5 |
| </pre> | | </pre> |
| | |
| | [[Category: Lexical Functions]] |
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