HP 3000 Manuals HP 3000 Manuals
Differencing KSAM Files
Previous revisions of HP SRC required that you check in KSAM files with
the FULLMASK option. Now you can use any HP SRC masking option when
checking in ASCII KSAM files. HP SRC does not difference KSAM files the
same way it does other files. The most important differences are listed
below.
* The default mask parameter for checking in an ASCII KSAM file is now
NOMASK. To minimize the number of times a KSAM COBOL copy library is
differenced, use the NUMMASK option. This is recommended because
COBEDIT puts a six-digit sequence field after the member name, and if
you use the NUMMASK option, HP SRC will strip those digits when you
check in the file and regenerate them when you check the file back
out again.
* Keywords are not expanded when they appear in a KSAM file.
* When the COPYDELTA command is executed on a KSAM file, HP SRC prompts
you for a data file name or a key file name to go along with the file
being copied. In batch mode, the job stream will be read to see if a
new file was given. If the given name is not a valid file name, HP
SRC will issue an error.
* When you execute the ADDDIFF or DELDIFF command on a KSAM file, HP
SRC maintains the file as a KSAM file only when no conflicts occur.
If a conflict does occur, HP SRC converts the KSAM file into an MPE
flat file. When the KSAM file is converted into a flat file, the key
file name and key attributes are displayed so that the KSAM file can
be recreated when the conflicts are resolved. An example is shown
below.
:ADDDIFF COBLIB, 1.1.1.1-1.1.1.2
Adding differences:
File Rev Range Working File Conflicts
------------------ ----------------------- -------------------------- ----------
COBLIB 1.1.1.1-1.1.1.2 COBLIB.USER.TOOLS 1
COBLIB has been converted from a KSAM file to an MPE flat file (SRCWRN 341)
Key file: COBLIBK
KSAM key information:
Num Type Length Location Dup. Keys/Block
--- ---- ------ -------- ---- ----------
1 B 14 73 N 92
To recreate the KSAM file from an MPE XL flat file, you must first edit
the MPE file with a standard editor to resolve all conflicts. You should
rename this file to a temporary file name. If the file is a COBOL Copy
Library file, use COBEDIT to build the library (using the original file
name) and copy the temporary file as a file in the copylib format. For
example:
:edit coblib
< resolve conflicts >
:rename coblib,templib
:run cobedit.pub.sys
>build coblib
>copy
To copy a file into COBLIB now, enter the file name.
File name? templib
Is the file in copylib format? y
935 records copied to library file.
Do you wish to copy more files? n
Requested file(s) copied.
>exit
:purge templib
If the KSAM file is not a COBOL Copy Library file, use KSAMUTIL to build
the file with the appropriate keys then copy the flat file into the new
KSAM file using FCOPY.
Now HP SRC also supports the new KSAM/XL file format. This new format
consists of just one file instead of the two files needed for the old
KSAM file format.