'uvhd' is a binary file investigation utility. It displays any file in 'vertical hexadecimal' and prompts for commands to browse, search, select, update, scan/replace, print, translate, etc. 'uvhd' is especially effective for working with mainframe type data files that have been migrated to unix. These files may have packed/binary fields & are usually fixed-length records with no LineFeeds. These files can NOT be handled with Unix system utilities such as vi,lp,more,cat,grep,etc. uvhd is an interactive utility with a command line interface and 24 help screens. Please see the full documentation at uvhd documentation
'uvhdcob' is similar to uvhd, but shows COBOL copybook fieldnames beside data field contents. You must first convert the COBOL copybooks to 'cobmaps' (same as copybooks, but with field start/end/length/type coded on right side). 'cobmaps' are best created with 'uvcopy cobmap1' (part of Vancouver Utilities pkg), but you could code manually following examples in uvhdcob documentation. UV Software offers a 1 time free conversion of your COBOL copybooks. Please see the full documentation at uvhdcob documentation . In 2011 uvhdcob was enhanced to handle more complex copybooks with 2 levels of group occurs, unlimited item occurs,& unlimited occurs depending on.
uvhd & uvhdcob are a effective tool for investigating problems and verifying test results in files that have packed/binary fields, and that may not have linefeeds. Most Unix/Linux tools require linefeeds (vi, cat, lp, etc).
uvhd & uvhdcob are especially valuable in conversion situations such as mainframe to Unix/Linux conversions. Mainframe COBOL is usually converted to Micro Focus COBOL on the Unix/Linux system. uvhd/uvhdcob can process all converted file types (sequential, fixed, variable, indexed, text, binary, C-ISAM, D-ISAM, Micro Focus COBOL IDXFORMAT1/3/8, RDW/BDW, etc)
For Unix/Linux you must download the source programs and compile on your Unix/Linux O/S. For Windows or DOS you may download the executable and store it in your program files or setup your PATH to wherever you download.
#1. Download uvhd.c and VUdemofiles.zip from www.uvsoftware.ca Assume stored in: /home/userxx/Downloads/... #2. Login yourself (assume /home/userxx) #3. mkdir src bin #4. cp uvhd.c src/uvhd.c - store program in source subdir ==================== - ensure filename is 'uvhd.c' #5. cc src/uvhd.c -obin/uvhd - compile the program ======================== #6. cp Downloads/VUdemofiles.zip . ============================== #7. unzip VUdemofiles.zip ===================== creates: dat1/custmas0, custmas1, sales0, sales1 cpys/custmas, sales maps/custmas, sales #8. bin/uvhd dat1/custmas1 r256 - test with ASCII datafile =========================== - option 'r' specifies record-size #9. bin/uvhd dat1/custmas0 r256a - test with EBCDIC datafile ============================ - option 'a' translates the Character line to ASCII - no spaces between options (letters a-z + number on most) - but still shows the EBCDIC values of the zones and digits lines - for each vertical hexadecimal 3 line group (chars/zones/digits) #10. bin/uvhd xxxxx r??? - display any of your data files (???=recsize) =================== #11. export PATH=$PATH:/home/userxx/bin ================================== - add bin to your PATH so you can execute it from anywhere.
'uvhdcob' displays COBOL copybook fieldnames beside data field contents #1. cp Downloads/uvhdcob.c src/uvhdcob.c - store program in source subdir ==================================== - ensure filename is 'uvhdcob.c' #2. cc src/uvhdcob.c -obin/uvhdcob - compile the program ============================== #3. bin/uvhdcob dat1/custmas1 maps/custmas - display custmas1 with fieldnames ====================================== #4. bin/uvhdcob dat1/sales1 maps/sales - display sales1 with fieldnames ====================================== #5. uvcopyx cobmap1 cpys maps uop=q0i7 - convert all copybooks to 'cobmap's ================================== - requires uvcopy program (part of Vancouver Utilities package) - you could make maps/xxxx manually for some of your files
setup for Windows/DOS
The above procedures are for Unix/Linux. You do not need to compile for Windows/DOS since you can download the executable from the web site. Please see uvhd setup Windows PATH to setup the Windows PATH, so the program will be found when you type uvhd on the command line. See WindowsDOS.doc if you wish to see how uvhd was compiled at UV Software for DOS windows on Windows.
If you find uvhd useful at your site, I would appreciate some feedback. Please let me know which features you find most useful, and if you have any suggestions for future enhancements. Of course let me know in the unlikely event :-) that you find a bug. You will be rewarded with a 1 year subscription (4 issues) to Beautiful BC Magazine.
Owen Townsend , UV Software Inc. , 4667 Hoskins Rd. , North Vancouver BC , Canada V7K2R3 .
Tel: 604-980-5434 , Fax: 604-980-5404 , Web: http://www.uvsoftware.ca .
return to UV Software Home-Page