Upgrading
New installations
This section is for installations that are upgrading to a new version of FDRPASVM. If you are performing a new installation proceed to Using the FDRPAS CMS Command to complete the new installation.
Existing installations
Continue with Shut Down the FDRPASVM service machine
Shut down the FDRPASVM service machine
Before loading an updated version of the FDRPASVM software, the FDRPASVM service machine should be shutdown with the QUIT command if it is active. After the FDRPASVM service machine exits, the FDRPASVM virtual machine should be logged off.
Unload the FDRPASVM service machine user diagnose
The FDRPASVM service machine User Diagnose must also be unloaded with CPXUNLOAD so the updated User Diagnose can be loaded. To unload the FDRPASVM service machine User Diagnose, use the QUERY CPXLOAD command to get the ID of FDRDGN and then unload it with CPXUNLOAD from a user defined with class A privileges (or P if you created the new privilege class described in Create the FDRMAINT virtual machine). If the FDRPASVM service machine User Diagnose has not been loaded during the current IPL, an entry for FDRDGN will not be present in the QUERY CPXLOAD output. If no modules are currently loaded with CPXLOAD, QUERY CPXLOAD issues a message indicating there are no routines in CP storage loaded by CPXLOAD. These commands must be run from a user with class A privileges (or P if you created the new privilege class).
Loaded as identifier 0
File: FDRDGN54 RULES T
Loaded by: user on mm/dd/yy at hh:mm:ss
CPXLOAD options: NODELAY
Associated entry points and external symbols:
FDRDGN00 is at 0A945500
FDRDGNCN is at 0A945E68
FDRDGNIO is at 0A946020
FDRPASXT is at 0A948000 module size is 004000
FDRDGN is at 0A945000 module size is 000FD8
Ready;
HCPCLP2770I CPXUNLOAD for load ID 0 has been scheduled
HCPCLH2771I CPXUNLOAD for load ID 0 has been completed
Ready;
Load the updated FDRPASVM software
Load the updated FDRPASVM Software to the FDRMAINT minidisks as described in Load the FDRPASVM Software to the FDRMAINT Minidisks.
The options module FDRPASOP is replaced with a default module when the updated software is loaded. If the diagnose number was changed as described in Optionally Change the User Diagnose Number or Privilege Class, you need to follow that procedure again to update the new FDRPASOP module.
Load the updated user diagnose
If the FDRPASVM service machine has not been used and its user diagnose routine has not been defined during the current IPL, no special action is required for the user diagnose routine. If the diagnose number of the FDRPASVM user diagnose is specified with the QUERY DIAGNOSE diagnum command, you receive a “Diagnose code diagnum does not exist message” if it has not been defined. The DIAGLOAD sample EXEC shown in Verify the Service Machine User Diagnose can be used to define and load the user diagnose when needed for the FDRPASVM service machine.
If the FDRPASVM service machine User Diagnose was loaded at any time during the current IPL, run the DIAGRELO EXEC from the FDRMAINT user instead of the DIAGLOAD EXEC to reload it. To prevent using a user diagnose number that is already in use, the DIAGLOAD EXEC is designed to fail if the diagnose number already exists.
The FDRPASVM service machine can now be started.
Existing installations
Continue with Using the FDRPAS CMS Command to complete the upgrade.