SYS()
From Recital Documentation Wiki
Revision as of 12:30, 26 October 2012 by Yvonnemilne (Talk | contribs)
Purpose
Functions to return various system and miscellaneous information
Syntax
SYS(<expN>)
See Also
ADIR(), COLLATE(), DATE(), DAY(), DB_TMPDIR, DEFAULT(), DO, FMT(), INDEXKEY(), KEY(), MEMORY(), National Character Sets, OS(), PROCNAME(), PROGRAM(), READVAR(), SECS(), SET(), SET CURSOR, SET DEVICE, SET KEY, SET PRINTER, SET TALK, SET TMPDIR, SET TMPNAMPATH, TMPNAM()
Description
The SYS() function returns miscellaneous information depending on <expN>. The arguments and operation of this function are as follows:
| Parameter | Description |
|---|---|
| SYS(0) | Returns complete host system information |
| SYS(1) | Returns the current system date as a Julian day number in a character string |
| SYS(2) | Returns the number of seconds elapsed since midnight in a character string |
| SYS(3) | Returns a unique filename. This will include the full directory path unless SET TMPNAMPATH is OFF (ON by default) |
| SYS(5) | Returns the current default directory |
| SYS(6) | Returns the current PRINT device as set by the SET PRINTER TO command |
| SYS(7 [,w]) | Returns the name of the current FORMAT file. If no workarea 'w' is specified the current workarea is used |
| SYS(9) | Returns the Recital license serial number |
| SYS(10,d) | Returns the numeric day number 'd' as a character string |
| SYS(11,s) | Returns a date or character string 's' as a character type Julian day number |
| SYS(12) | Returns remaining available memory in bytes |
| SYS(13) | Returns the status of the printer as "READY" or "OFF-LINE" |
| SYS(14,n[,w]) | Returns the index expression for index 'n' in workarea 'w'. If 'w' is omitted then the current workarea is used |
| SYS(16) | Returns the name of the currently executing program |
| SYS(17) | Returns the CPU type number |
| SYS(18) | Returns the name of the GET field being entered |
| SYS(21) | Returns the order number of the master index. Note: if the master index is a tag, SYS(21) will always return 1. |
| SYS(22) | Returns the master index: the tagname or single index file name. If the master index is a tag, then SYS(22) returns the tag name in upper case. If the master index is a single index, then SYS(22) returns the index file name in lower case, including the file extension. |
| SYS(100) | Returns the status of the CONSOLE setting as "ON" or "OFF" |
| SYS(101) | Returns the DEVICE setting as "SCREEN" or "PRINT" |
| SYS(102) | Returns the PRINT setting as "ON" or "OFF" |
| SYS(103) | Returns the TALK setting as "ON" or "OFF" |
| SYS(2000,s[,1]) | Returns the name of the first file matching the pattern 's'. If the third parameter is included the next matching file is returned |
| SYS(2001,s[,1]) | Returns the current value of the set option 's'. The optional '1' can be used to return the character setting of certain SET COMMANDS, e.g. ALTERNATE |
| SYS(2002[,1]) | Turns the cursor OFF (sys(2002)) or ON (sys(2002,1)) |
| SYS(2003) | Returns the default directory |
| SYS(2004) | Returns the starting directory for the current process |
| SYS(2005) | Returns the currently available resource file |
| SYS(2006) | Returns "VGA/Color" for color terminals, "Mono" for non-color terminals. |
| SYS(2008 [,<expC> [,<expN>]]) | Language compatibility only. |
| SYS(2010) | Return the maximum number of open files for the current user |
| SYS(2011) | Returns the current lock status, no lock is placed on the record by this command |
| <expC>]) | Returns the memo field block size for dBASE and FoxPro database files. SET COMPATIBLE TO DBASE or FOXPRO must be set. |
| SYS(2015) | Returns a unique filename. This will include the full directory path unless SET TMPNAMPATH is OFF (ON by default) |
| SYS(2017) | Re display sign on screen |
| SYS(2019) | Get name and location of current configuration file |
| SYS(3000) | Returns the options string from the Recital license |
| SYS(5000) | Returns amount of currently allocated physical memory for strings |
| SYS(5001) | Returns amount of memory allocated for strings |
| SYS(5002) | Returns amount of currently allocated memory for indexes |
| SYS(5003) | Returns amount of currently allocated memory for symbol table nodes |
| SYS(6000,n) | Returns the assigned Hot-Key procedure for key 'n', as defined by the SET KEY TO command |
| SYS(6001) | Returns current DO level as a character string |
| SYS(9000) | Returns .T. (true) if the runtime environment is active, .F. (false) if the development environment is active. |
| SYS(9001) | Returns .T. (true) if the environment was invoked with the system windows defined, .F. (false) otherwise. |
Example
? sys(9001) .T.
Products
Recital, Recital Server
