gawk: VMS Installation Details
1
1 B.3.2.3 Installing 'gawk' on VMS
1 ................................
1
1 To use 'gawk', all you need is a "foreign" command, which is a 'DCL'
1 symbol whose value begins with a dollar sign. For example:
1
1 $ GAWK :== $disk1:[gnubin]gawk
1
1 Substitute the actual location of 'gawk.exe' for '$disk1:[gnubin]'. The
1 symbol should be placed in the 'login.com' of any user who wants to run
1 'gawk', so that it is defined every time the user logs on.
1 Alternatively, the symbol may be placed in the system-wide 'sylogin.com'
1 procedure, which allows all users to run 'gawk'.
1
1 If your 'gawk' was installed by a PCSI kit into the 'GNV$GNU:'
1 directory tree, the program will be known as 'GNV$GNU:[bin]gnv$gawk.exe'
1 and the help file will be 'GNV$GNU:[vms_help]gawk.hlp'.
1
1 The PCSI kit also installs a 'GNV$GNU:[vms_bin]gawk_verb.cld' file
1 that can be used to add 'gawk' and 'awk' as DCL commands.
1
1 For just the current process you can use:
1
1 $ set command gnv$gnu:[vms_bin]gawk_verb.cld
1
1 Or the system manager can use 'GNV$GNU:[vms_bin]gawk_verb.cld' to add
1 the 'gawk' and 'awk' to the system-wide 'DCLTABLES'.
1
1 The DCL syntax is documented in the 'gawk.hlp' file.
1
1 Optionally, the 'gawk.hlp' entry can be loaded into a VMS help
1 library:
1
1 $ LIBRARY/HELP sys$help:helplib [.vms]gawk.hlp
1
1 (You may want to substitute a site-specific help library rather than the
1 standard VMS library 'HELPLIB'.) After loading the help text, the
1 command:
1
1 $ HELP GAWK
1
1 provides information about both the 'gawk' implementation and the 'awk'
1 programming language.
1
1 The logical name 'AWK_LIBRARY' can designate a default location for
1 'awk' program files. For the '-f' option, if the specified file name
1 has no device or directory path information in it, 'gawk' looks in the
1 current directory first, then in the directory specified by the
1 translation of 'AWK_LIBRARY' if the file is not found. If, after
1 searching in both directories, the file still is not found, 'gawk'
1 appends the suffix '.awk' to the file name and retries the file search.
1 If 'AWK_LIBRARY' has no definition, a default value of 'SYS$LIBRARY:' is
1 used for it.
1