3 12 LANSA IFS Directory Root Rename

LANSA Open System Utilities

3.12 LANSA IFS Directory Root Rename

Functional Description

The LANSA system is locked exclusively.

The new LANSA root directory is created.

The new directory name is set in data area DC@IFS in <<pgmlib>>

The OS/400 MOV command is used to move the directory tree from the old LANSA root directory into the new LANSA root directory.

The old LANSA root directory is removed.

The Java classpath stored in data area LJAVACP in <<pgmlib>> is updated to reflect the changes in the IFS directory name.

The LANSA system is then released.

Note: This program is not called from OS@P0007 3.7 Rename LANSA Libraries because the IFS root directory name may not match the program library name.

 

Name

OSXP0012

Type

ILE C Program

Source provided

Yes

 

  

Warnings That Apply

  • <<osulib>> and <<pgmlib>> must be in the library list when running this job.
  • Backup the existing LANSA directory tree before running this program and save data areas DC@IFS and LJAVACP from <<pgmlib>>.
  • You must signon with a user profile that has authority to remove the LANSA IFS directory and its contents.
  • No one should be using the LANSA system at the time of rename.
  • This program is best run in batch.
  • Program failure will leave system in a corrupted state.
  • To recover from corrupted state (abnormal termination):
    Restore the saved IFS directory.
    Restore the saved data areas DC@IFS and LJAVACP.
  • Don't bypass the PC compatibility test when calling this program directly.

Parameters

No

Type

Len

Dec

Description

1

Alpha

Vary

 

New LANSA IFS root directory

2

Alpha

8

 

Optional "*NOCHECK" to bypass PC compatibility test. Should not be used if called directly.

 

  

Examples

Rename the LANSA IFS directory to '/newifsdir'

CALL OSXP0012 ('/newifsdir')