BUILD-LOCK-XREF Command

BUILD-LOCK-XREF builds the FILE-XREF file, which contains file pathnames for all accounts on the system.

Format

BUILD-LOCK-XREF

Description

The ULOG-SKIP command can be used to exclude files from update logging once the FILE-XREF file is built.

NOTE

Only updates to files whose pathnames are listed in the FILE-XREF file can be logged by the update logger. Use BUILD-LOCK-XREF to rebuild the FILE-XREF file whenever you suspect that the FILE-XREF file does not include pathnames of all the files whose updates you want to log.

After the BUILD-LOCK-XREF command is entered, the system displays this menu:

1) Initialize LOCK-XREF File

2) Enable Account(s)

3) Disable Account(s)

   Please enter your choice:2

Option 1 clears and rebuilds the FILE-XREF file. This option should only be selected if the database becomes corrupted.

Options 2 and 3 enable and disable accounts for update logging, respectively. If either option is selected, this prompt displays:

Enter Account Name(s), "*" For All Accounts, CR to Stop

One or more account names may be specified, or * may be specified to include all accounts.

The BUILD-LOCK-XREF command cannot be executed while update logging is enabled. Use the ULOG-OFF command to disable update logging, then run BUILD-LOCK-XREF.

Listing File Pathnames

This example builds the FILE-XREF file, then lists its contents in sorted order:

>BUILD-LOCK-XREF

 

1) Initialize LOCK-XREF File

2) Enable Account(s)

3) Disable Account(s)

   Please enter your choice:2

 

Enter Account Name(s), "*" For All Accounts, CR To Stop *

 

10 <numbers are incremented as the FILE-xref file is built >

*** DONE ***   317 entries written to FILE-XREF

>

>SORT FILE-XREF

 

 

 

 

PAGE 1

 

 

13:22:59  dd mmm yyyy

 

 

 

 

FILE-XREF...

MOD..

LEVEL.

File   Path .....................

 

 

 

 

3608

27

0

SYSTEM

3635

7

1

SYSPROG

3642

1

2

SYSPROG > NEWAC

3643

3

3

SYSPROG > NEWAC > NEWAC

3648

1

3

SYSPROG > NEWAC > SYSPROG

3650

1

2

SYSPROG > FILE-XREF

3651

5

3

SYSPROG > FILE-XREF > FILE-XREF

3656

1

2

SYSPROG > CURSOR

3657

7

3

SYSPROG > CURSOR > SOURCE

3666

3

3

SYSPROG > CURSOR > OBJ0

3669

3

3

SYSPROG > CURSOR > OBJ1

3675

1

2

SYSPROG > PATH-XREF

3676

1

3

SYSPROG > PATH-XREF > PATH-XREF

3677

7

2

SYSPROG > POINTER-FILE

3686

1

2

SYSPROG > PATCHES

3687

1

3

3SYSPROG > PATCHES > SM

3700

1

3

SYSPROG > PATCHES > SN

3713

1

3

SYSPROG > PATCHES > SB

3714

1

3

SYSPROG > PATCHES > SH

3715

1

3

SYSPROG > PATCHES > SS

In the file pathnames listed in the FILE-XREF file, the first word is the account name, followed by the dictionary name, and then the data file name (if one exists).