Many are confused about the difference between the LEVEL number that displays on the PANLIB Member Selection List (MSL) and the term VERSION.
Release: 14.6
Component: Panvalet
The LEVEL number on the MSL reflects every change make in any way. If a member is edited, saved and the process is repeated multiple times in one edit session, the LEVEL is incremented each time.
VERSIONs are stored copies of a member on a Protection file. The MATCH-MERGE process is used to create a Protection file with multiple VERSIONs.
* Note if multiple versions are required the PVOPT parameter DELVERS must be greater than 0 and determines how many VERSIONS are retained on the Protection file.
Here is very basic example with insignificant columns removed:
PVEDIT ---- TEST.PANLIB(ANEW)-----------------------------------------------
COMMAND ===>
****** ***************************** Top of Data ***************************
000100 this is a new member
000200 close and reopen in same edit session generates LEVEL change
000300 now I will do a BACKUP to a HISTORY file
000400 this will save the first VERSION
****** **************************** Bottom of Data *************************
-------- PVEDIT MSL Option(D) - MEMBER SELECTION LIST ANEW SAVED
COMMAND ====>
Enter Panvalet Function:
| S or B -Browse, M -MSL Options & Dataset Info
|
| MEMBER LIB LVL USER F LANG STAT
V ---------- - --- ----- - ----- ---
ANEW 1 4 0 Y DATA TAE
000100 this is a new member
000200 close and reopen in same edit session generates LEVEL change
000300 now I will do a BACKUP to a HISTORY file
000400 this will save the first VERSION
000500
000600 after the ++DUMP I make more changes
000700 then perform a MATCH MERGE combining this PANLIB and the HISTORY file
000800 this will create a VERSION 2
****** **************************** Bottom of Data *************************
-------- PVEDIT MSL Option(D) - MEMBER SELECTION LIST ANEW SAVED
COMMAND ====>
Enter Panvalet Function:
| S or B -Browse, M -MSL Options & Dataset Info
|
| MEMBER LIB LVL USER F LANG STAT
V ---------- - --- ----- - ----- ---
ANEW 1 5 0 Y DATA TAE
//STEP1 EXEC PGM=PAN#2
//PANDD1 DD DISP=SHR,DSN=TEST.PANLIB
//PANDD2 DD DISP=(NEW,CATLG),DSN=PANVALET.HISTFIL2,
// DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120),
// UNIT=SYSDA,SPACE=(CYL,(1,1)) OUTPUT
//PANDD3 DD DISP=SHR,DSN=PANVALET.HISTFILE INPUT
//SYSPRINT DD SYSOUT=*
//SYSPUNCH DD SYSOUT=*
//SYSIN DD *
++OPTION INPUT
++DELETE NAME=ANEW
++PRINT 1-UP,BACKUP
INPUT=PANVALET.HISTFILE OUTPUT=PANVALET.HISTFIL2
*FROM INPUT *FROM LIBRARY *TO OUTPUT
NAME LVL VERSN NAME LVL REASON NAME LVL VERSN STATEMENTS
ANEW 5 NAMED ANEW 5 1 8
ANEW 4 2 ANEW 4 2 4
//STEP1 EXEC PGM=PAN#2
//SYSPRINT DD SYSOUT=*
//PANDD1 DD DSN=TEST.PANLIB,DISP=SHR
//PANDD2 DD DUMMY
//PANDD3 DD DSN=PANVALET.HISTFIL2,DISP=SHR
//SYSIN DD *
++RESTORE ANEW,,2
/*
//* THE VALUE 2 FOR VERSION TAKES YOU BACK ONE VERSION.
//* NO ENTRY OR THE VALUE 1 WOULD INDICATE THE MOST CURRENT VERSION.
-------- PVBROWSE MSL Option(D) - MEMBER SELECTION LIST
COMMAND ====>
Enter Panvalet Function:
| S or B -Browse, M -MSL Options & Dataset Info
|
| MEMBER LIB LVL USER F LANG STAT
V ---------- - --- ----- - ----- ---
ANEW 1 4 0 Y DATA TAE
See PAN#2 ++DELETE Command for more information.
See Maintaining Match-Merge/Historical Delete Files for more information