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