NTDOC (KiX Master) 2005-02-27 12:55 PM

FAQ Contents Page

FAQ Contents Page - Posted by NTDOC MAKE SURE you are using the latest release version of KiXtart before posting that either your script or a script you copied from the board is not working. Last updated: 2005-Apr-25 This page is a listing of the available Frequently Asked Questions that mainly relate to tasks that are often asked on the board. It does not cover every possible question, but should hopefully give you a quick answer to something you're wondering how to accomplish with KiXtart. You can either browse this list or use CTRL-F to search for a possible keyword on this list to help you locate what you're looking for a little faster. This FAQ section is not meant to be a replacement for the KiXtart manual but rather a supplement to help you understand how better to use KiXtart in your environment. The KiXtart manual comes with the zip file download of KiXtart KiXtart 32 bits v2001 4.23 Here is a compiled help file of the KiXtart 4.22 manual from ScriptLogic HTML Help File 4.22 ABC's of KiXtart board etiquette and message to new forum users ADSI/WMI/COM Info and links Alphabetical list of UDFs Analysis of KiX-related files Batch-less (or remove NTLOGON.BAT) Login script.. Best Practices and Methods Can't decide what editor to use... Maybe this'll help Cannot find what you are looking for? COM Scripting Primer Can I run a logon script when logging in via RAS or VPN? Catch that error message that flashes for a second Citrix and/or Terminal Server Client Collection Citrix/Terminal Server Configuration Curly quotes “ and ” Debugging script without user input. also during logging on. the advanced way Debugging without user input Default Printer Configuration Determining the Default Printer including connection type (2nd edition) Determining the Default Printer EXIT [error level / exit code] optional or not? Error Code Look up.. FYI - Heads Up: Microsoft's Knowledgebase Changes File Operations Files/Applications - commonly used HOWTO: Submit code to / copy code from the board How do I send e-mail from KiXtart? (SMTP) How do we check and format code for scripts? How do we deploy an application? - InstallShield and others How to use UDFs How to write a UDF INFO: KiXcrypt version 3.05a - KiXtart packager/encryption utility IP Address trimming Install Packagers Installing an Application as an Admin Is '?' a PRINT or NEWLINE command? KiX upgrade: what are those new features? can upgrade be done without any danger? KiXtart Deployment KiXtart Starter's Guide Limits in NetBIOS, computer/printer names, share names/comments Local vs. RAS Connections Locations of Desktop, Start Menu, etc Not quite everything you wanted to know about RUN and SHELL Outlook/Exchange Configuration Proper use of quotes Quote (") characters on the command line Registry Tools Registry Sequence of events during logon TCP/IP Primer, Part I - IP Addresses TCP/IP Primer, Part II - Classless Inter-Domain Routing (CIDR) TCP/IP Primer, Part III - IP Addresses and KiXtart Undocumented MessageBox Styles Use of %0\..\ to launch KiX Using $ inside quotes W2k+ - Keep the Window visible on login? Windows 9x/Me Kixtart Support Windows XP Professional Fast Logon Optimization ABC's of KiXtart board etiquette and message to new forum users Welcome to the KiXtart.org bulletin board. In order to make your experience here more productive and enjoyable, you should take a moment to understand how the board works. Following board etiquette can go a long way toward getting better replies. ABC's of KiXtart board etiquette and message to new forum users ADSI/WMI/COM Info and links The interesting parts we find many time on the forums: - how can I use it on Win9x and NT clients? Most everything that is done under NT can be done with Win9x.. F.E. Win9x does not have Performance Counters - where can I find additional information? There are several links here in this FAQ Several people have put together examples in the COM/UDF Forums of Kixtart.org - where can I find the possible names/keys within a object? ADSI/WMI/COM Info and links Alphabetical list of UDFs summary of UDFs sorted in alphabetical order Alphabetical list of UDFs Analysis of KiX-related files If we do an analysis of KIX32.EXE. The only difference between KIX32.EXE and WKIX32.EXE is there is one additional entry for imported functions: KERNEL32 4 AllocConsole Analysis of KiX-related files Batch-less (or remove NTLOGON.BAT) Login script.. This assumes that you have the KIXTART.KIX script already created. Within the documentation, it states that you can execute WKIX32.EXE or KIX32.EXE without having to specify KIXTART.KIX Batch-less (or remove NTLOGON.BAT) Login script.. Best Practices and Methods Start with a UDF-like header (What does the script do, who wrote it, change history etc.) Use break on until the script is finished Use SetOption('NoVarsInStrings','ON') en SetOption('Explicit','ON') Comment your code Let the script be tested by someone who does not know or understand how to code script. Never use GOTO/GOSUB!!! These are considered "old school" and with properly written code, you can work around (even with older versions of KiXtart). With newer versions of KiXtart, you can replace with a DO/UNTIL,WHILE, or FUNCTION Best Practices and Methods Can't decide what editor to use... Maybe this'll help Every now and then, someone brings up the topic of what is the best editor to write KiX (and others) scripts with. There's always interesting commentary, and one thing's for sure; people are quite passionate about their editor. Can't decide what editor to use... Maybe this'll help Cannot find what you are looking for? You can do a search from above.. Choose the Search Link. (1) Select Forum or Category to search You can search Each individually or all forums Cannot find what you are looking for? COM Scripting Primer Sometimes it helps to have an abstract mental picture of how things work. I'll tell you my mental picture in terms of how KiXtart COM (KOM) works. I think of COM objects as sort of like smart DOS programs. For example, lets say you wanted to add a new user account to your local workstation. There are two ways to do it in kixtart: COM Scripting Primer Can I run a logon script when logging in via RAS or VPN? Yes you can, depending on OS, VPN client and when RAS is initiated Can I run a logon script when logging in via RAS or VPN? Catch that error message that flashes for a second When you have some bad code that stops the KiX interpreter, it will put the error message on the console. The problem is that the console closes before you get to read the message. The best way to troubleshoot and to get the message to stay on the console is to first open a DOS box. Then, from the DOS box, type the command to launch your test script. Catch that error message that flashes for a second Citrix and/or Terminal Server Client Collection First off, I would like to explain... In the case of thin (Citrix or Terminal Server) clients, KiX always runs in the memory space of the server so all the standard queries and macros report on the server and not on the client. One generally does not want a logon script to run on a Terminal Server so there needs to be a method to determine and subvert the script. Citrix and/or Terminal Server Client Collection Citrix/Terminal Server Configuration How do we configure our Citrix Clients especially when we have Ghosted (or imaged) our machines? Citrix/Terminal Server Configuration Curly quotes “ and ” The curly quotes “ and ” should be banned from all documentation. Do yourself a favor and open your DOC manual in MS Word. Under Tools | AutoCorrect... | AutoFormat, disable "Straight quotes" with “smart quotes” and do the same under AutoFormat As You Type as well. Curly quotes “ and ” Debugging script without user input. also during logging on. the advanced way There is an advanced way of debugging your script. First it is important that your script is correct. Secondly you can extend your script with additional kixtart code, which makes it possible to debug without the requirement of user input. Also during a loging on session it can be very handy. Debugging script without user input. also during logging on. the advanced way Debugging without user input How do we interactively Debug a script with no user input? Debugging without user input Default Printer Configuration This sets up printers and captures the local Printer mapped via the network and writes to an INI file. The reason for the INI is that the computer system may change location or user gets a new imaged desktop Also, if a new person logs in under a new profile/system, they will get the same printer Default Printer Configuration Determining the Default Printer including connection type (2nd edition) We read the topic Determining the Default Printer, but it didn't cover the whole story. Question is: is there a way to determine which printer is currently set as the default. Also we want to know: is the printer locally connected. For this task in W9x and NTx environment we have defined two script versions. Determining the Default Printer including connection type (2nd edition) Determining the Default Printer I know there is a command to set the default printer (SETDEFAULTPRINTER), but is there a way to determine which printer is currently set as the default? Determining the Default Printer EXIT [error level / exit code] optional or not? Is the [error level / exit code] optional for the EXIT command? Yes and No! EXIT [error level / exit code] optional or not? Error Code Look up.. 1. Convert num to Hex -2147022675 = 0x800708AD 2. Strip top 4 bytes = 08AD 3. Convert back to Dec 0x08AD = 2221 4. Look up this error with NET HELPMSG 2221 Error Code Look up.. FYI - Heads Up: Microsoft's Knowledgebase Changes As of November 7, 2002, prefix letters will be phased out of all Knowledge Base (KB) articles worldwide making it easier for you to request an article in a language other than your browser settings FYI - Heads Up: Microsoft's Knowledgebase Changes File Operations 1. Getting a major file version 2. Check for Existence of directory 3. Check for Existence of a file 3a. Check for Existence of a file with folder check 4. Test for Drive existence with notification 5. Adding a Program Group and Item 6. Adding a shortcut to the desktop File Operations Files/Applications - commonly used Links to files/applications commonly used Files/Applications - commonly used HOWTO: Submit code to / copy code from the board If you have more than a few lines of code, use the CODE button found under 'Instant UBB Code' below the editing window. It will place a [CODE] and a [/CODE] tag pair. Paste your code between the tags. It will preserve the indenting and allow certain characters UBB would otherwise forbid. HOWTO: Submit code to / copy code from the board How do I send e-mail from KiXtart? (SMTP) You can use one of the following methods: Blat Postie COM - Howard Bullock's Win32Admin.DLL COM (using Outlook) COM - Using CDO (Collaborative Data Objects): Thanks Howard!! Sendmail() - UDF How do I send e-mail from KiXtart? (SMTP) How do we check and format code for scripts? A quick way to check for code and errors is to implement the following test code How do we check and format code for scripts? How do we deploy an application? - InstallShield and others Links and discussion on deploying applications How do we deploy an application? - InstallShield and others How to use UDFs The purpose of this FAQ is not to teach you how to write UDFs but rather how to incorporate them in your script. When KiX pre-parses the script, it will catalogue all the UDFs. They are defined with Function at the start and EndFunction at the end. When KiX parses through the second time and actually interprets (executes) your script, it will skip over all the UDFs How to use UDFs How to write a UDF Why do you want to write a UDF? Most scripts contain actions that are performed multiple times. Just think of mapping 5 shares to drive letters. You end up having five sections that delete the potentially existing old drive mapping, create the new drive mapping, check for errors, and print out error/success messages. By using a UDF you encapsulate these steps in to a function/endfunction segment and pass information into the function as parameters just like you'd do with regular KiXtart functions. You now have a UDF. How to write a UDF INFO: KiXcrypt version 3.05a - KiXtart packager/encryption utility KiXcrypt is a tool which is used to encrypt files to hide their content. The file(s) are compiled into an executable, and are decrypted when the file is run. The unencrypted file is then executed. INFO: KiXcrypt version 3.05a - KiXtart packager/encryption utility IP Address trimming How do we get the IP Address to appear properly IP Address trimming Install Packagers Links to install packagers and discussion on topic Install Packagers Installing an Application as an Admin Note: Option 1 and Option 2 open a security risk as they transmit a "clear text" password. Installing an Application as an Admin Is '?' a PRINT or NEWLINE command? People familiar with batch and other scripting languages, feel a need to have a PRINT command to output to the console. KiX being a free-form language, does not have, nor require, such a command. To fill this void, people will often use ? to satisfy their need. Is '?' a PRINT or NEWLINE command? KiX upgrade: what are those new features? can upgrade be done without any danger? A lot of you are running still an old kixtart release. Sometimes we see questions like: 1. what are the changes with latest release? 2. how can I verify possible compatibility problems with mine scripts? 3. can I easily upgrade our servers? 4. can I easily upgrade our clients? KiX upgrade: what are those new features? can upgrade be done without any danger? KiXtart Deployment How do we deploy Kixtart to the Enterprise? You can copy the files as described in the Manual to the clients using GETTYPE or other OS detection methods. Or, you can verify the files are up-to-date using MCA's IE Express Packager utilities. It will only install the required kixtart binairies on your clients. For the NT-Based (NT, W2000, XP, .Net) environments it is only the KIX32.EXE or WKIX32.EXE file. For W9x additional files included are KX16.DLL, KX32.DLL and KX95.DLL files. KiXtart Deployment KiXtart Starter's Guide KiXtart Starter's Guide. Posted with permission, thanks to Bryce! KiXtart Starter's Guide Limits in NetBIOS, computer/printer names, share names/comments Most of the limitations listed below are related to the use of the NetBIOS protocol and/or WINS. Limits in Active Directory: # , + " \ < > are special characters in LDAP as defined in RFC2253. User account: 20 characters, or 20 bytes depending upon the character set; individual characters may require more than one byte. A user account cannot consist solely of periods (.), spaces, or the at (@) sign. Any leading periods or spaces are cropped. Computer account: 15 characters, or 15 bytes depending upon the character set; individual characters may require more than one byte. A computer account cannot consist solely of numbers, periods (.), or spaces. Any leading periods or spaces are cropped. Group account: 63 characters, or 63 bytes depending upon the character set; individual characters may require more than one byte. A group account cannot consist solely of numbers, periods (.), or spaces. Any leading periods or spaces are cropped. Limits in NetBIOS, computer/printer names, share names/comments Local vs. RAS Connections In Kixtart you can use the @ras macro, which will return Number of active Remote Access Service (RAS) connections Local vs. RAS Connections Locations of Desktop, Start Menu, etc This can be completed relatively easily using the Shell Folders Location of the registry.. It is in the same location no matter if it is 9x, NT, 2k, XP for the current user. Locations of Desktop, Start Menu, etc Not quite everything you wanted to know about RUN and SHELL These two little commands have very short write-ups in the manual but generate a lot of questions. Not quite everything you wanted to know about RUN and SHELL Outlook/Exchange Configuration There have been many posts on how to configure Outlook/Exchange. Outlook 98/2000/XP Configuration By: Kent Dyer (leptonator@hotmail.com) Note: this FAQ has been broken up to be presented in pieces relevant to you. Outlook/Exchange Configuration Proper use of quotes Basically, KiX will accept either single (') or double (") quotes as delimiters. The OS, on the other hand, is not as accepting of single quotes in place of double quotes. Proper use of quotes Quote (") characters on the command line This isn't strictly KiXtart, as it appears to happen to any binary which gets command line parameters, including a simple C program Quote (") characters on the command line Registry Tools These should all be freeware: Regshot v1.7 Aezay Registry Commander RegCool RegEditX 1.31 Registry Pruner Easy Cleaner Registry Tools Registry I find that a great many people confuse the terms "Key" and "Value". A key is like a folder and a value is like a file. In RegEdit, the keys appear in the left pane and are represented as manilla folders. The values appear in the right pane as paper scraps. With reference to values, there are value names and value data. Think of the value name as a filename and value data as a file's contents. Ruud, in the manual, refers to the value name as "Entry" and the value data simply as "data". Registry Sequence of events during logon Maybe I should have called this "Why can't I access HKEY_CURRENT_USER on Win9x/ME during logon" ...or Why doesn't my script work during logon but works if I run it after logon" ...or "Why does... ...only work after I reboot or logoff and logon again". Sequence of events during logon TCP/IP Primer, Part I - IP Addresses in this primer. The TCP/IP suite of protocols uses the IP protocol to handle all addressing and routing issues. An IP address is a unique number that identifies each host TCP/IP Primer, Part I - IP Addresses TCP/IP Primer, Part II - Classless Inter-Domain Routing (CIDR) CIDR is a new addressing scheme for the Internet which allows for more efficient allocation of IP addresses than the old Class A, B, and C address scheme. TCP/IP Primer, Part II - Classless Inter-Domain Routing (CIDR) TCP/IP Primer, Part III - IP Addresses and KiXtart KiXtart has the ability to return the IP addresses of a computer with the IPADDRESSx macro. The subnet mask of a specific adapter can be retrieved from either ENUMIPINFO(), the registry, through WMI, or using command-line utilities like IPCONFIG TCP/IP Primer, Part III - IP Addresses and KiXtart Undocumented MessageBox Styles Just bumped into yet another undocumented MessageBox style feature, and thought I would bring them all together under one post: 6 - Microsoft® Windows® 2000/XP: The message box contains three push buttons: Cancel, Try Again, Continue. Use this message box type instead of ABORTRETRYIGNORE Undocumented MessageBox Styles Use of %0\..\ to launch KiX Microsoft wrote a Knowledge Base Article - 318689 http://support.microsoft.com/default.aspx?scid=kb;EN-US;318689 that discusses an issue with XP. Within the article are several examples, some of which are downright incorrect. Use of %0\..\ to launch KiX Using $ inside quotes A word of caution on using $. The $ can in of itself be a variable, but it is not considered good practice to use it. Using $ inside quotes W2k+ - Keep the Window visible on login? When we execute our script on login, the screen runs minimized, how do we get it visible? W2k+ - Keep the Window visible on login? Windows 9x/Me Kixtart Support When configuring your Windows 9x users, you can point them to the login script (typically NTLOGON.BAT) under the profile section of User Manager or Tab of Active Directory Users and Computers). Windows 9x/Me Kixtart Support Windows XP Professional Fast Logon Optimization Microsoft has optimized Windows XP to enhance the user experience by creating the impression that the operating system starts up faster. This is achieved by having the login prompt show up before the network is fully initialized. Additionally, existing users are logged in with cached credentials. Windows XP Professional Fast Logon Optimization