IPC VLSUTIL BACKUP produces OUT OF SEQUENCE messages.

Products

• Ideal

Issue/Introduction

VLSUTIL BACKUP on the Ideal source library gives these messages: 

MEMBER NAME IN THE INDEX IS OUT OF SEQUENCE AND HAS BEEN SKIPPED. NAME IS member name and version

Environment

z/OS

Ideal 

Cause

These messages are due to INDEX corruption.

Resolution

Resolution is to repair the VLS library via the following steps:

1. VLSUTIL BACKUP VLS source.
2. Allocate new data set VLSUTIL FORMAT/RESTORE from full BACKUP 
3. VLSUTIL SELBKUP each VLS MEMBER flagged in BACKUP errors. 
4. VLSUTIL RESTORE NOCLEAR(R) from the SELBKUP file. 

If SELBKUP fails use IDEAL Source Transport EXPORT. 

Note1:  VLSUTIL with RESTORE NOCLEAR(R) 

"R" to replace MEMBERs with same name 

and "NOCLEAR" to not remove what is already in the VLS file.

Note2:

For all those  MEMBER NAME IN THE INDEX IS OUT OF SEQUENCE AND HAS BEEN SKIPPED , 

run VLSUTIL SELBKUP on each MEMBER  followed by RESTORE NOCLEAR(R) .

The full RESTORE has skipped all these "out of Sequence" members. 

Additional Information

Take VLSUTIL backup on a regular basis and fairly often and check the output so that any error can be corrected quickly.

Index corruption can be due to:

- Previous abends.

- Misuse of DEQUE commands. 

- VLS Block size not matching the FCT definitions on all systems.

- The system should be QUIESED (down) when library functions are performed. The library functions are BACKUP, FORMAT, INIT, and RESTORE.

- Not using standard backup utilities; VLSUTIL is highly recommended because it performs additional file verification.