Click here to return to the KiXtart HelpDesk main page...

KiXtart Macro Reference

Macros can be used anywhere an expression is expected. Supported macros are defined in the following table.




Address of the network adapter


User comment


Current directory


Date (in the format YYYY/MM/DD)


Day of the week (Monday, Tuesday, and so on)


Domain or workgroup the computer belongs to


Version of Windows NT


Return code of the most recent command or function. A return code of 0 means the command or function was successful. Any other value indicates an error.


Full name of current user


Short name of the directory part of home directory


Drive letter of drive containing home directory


Server and share name part of home directory


Fully qualified TCP/IP host name (including TCP/IP domain name)


Operating system: 1 = Windows NT; 2 = Windows 9x


TCP/IP address (possible values for x are 0 - 3).
Note   Addresses are padded so that the resulting string always consists of four sets of three characters separated by periods. For example, if your IP address is, @IPADDRESS0 is 123. 45. 6. 7.


Version of KiXtart


Directory where network software resides (usually Systemroot\System32)


Logon domain


Drive that is redirected to \\logonserver\NETLOGON


Version of network software


Long name of the directory part of home directory


Logon server


Maximum password age


Day of the month (1-31)


Months since January (1-12)


Name of the month


Current user's primary group


User's privilege level (GUEST, USER, ADMIN)


Password age


Number of active Remote Access Service (RAS) connections


KXRPC server used for the current session


Directory of current script


Error text corresponding with @ERROR


Current user's Windows NT Security Identifier (SID)


Directory from which KiXtart was started


Full English name of the language of the operating system specified in the format defined by  ISO Standard 639. (example : “0413Dutch (Standard)”).


Current time (in the format HH:MM:SS)


Current user's Windows NT user ID


Full English name of the language selected by the current user specified in the format defined by  ISO Standard 639. (example : “0413Dutch (Standard)”).


Days since Sunday (1 – 7)


Computer name


Current user's Windows user ID


Days since January 1 (1 – 365)


Current year

*Available on computers running Windows 9x only if the KiXtart RPC service is running.


During the logon sequence, WUSERID is empty on computers running Windows 9x if Windows NT Networking has been configured as the system's primary network provider.

The following examples show the correct use of KiXtart macros:

@LM              "2.10"

@DATE            "1997/10/03"

DISPLAY @USERID + ".TXT"       displays the file "RUUDV.TXT"

CD "\DATA\" + @DOMAIN       changes the current directory to "\DATA\your-domain"