Replacing Objects on the SYSGEN Tape

Replacing autoboot images

The RAUTO command (abbreviated RA) replaces an existing autoboot image in the list of files dumped to SYSGEN's tape. The command has the following parameters:

   RAUTO (RA)   [FILE  =]  autobootfilename]

                [TYPE  =   DISC  ] 

                         [ TAPE  ]

                         [ BOTH  ] 

FILE specifies a file name to replace the designated autoboot image. If it is not fully qualified with group and account name, it defaults to the current group and account. If the specified file does not exist, an error occurs.

TYPE specifies the boot image type. The various types are defined as follows:

To modify or replace an autoboot image file name, enter the command, fully qualified file name, and type:

   sysfile>RAUTO  filename  TYPE=DISC 

Use the SHOW command to display the autoboot image file names maintained by the system.

Replacing boot images

The RBOOT command (abbreviated RB) modifies the boot type of an existing boot image file name or replaces the boot image file name with another boot image file name. The command has the following parameters:

   RBOOT (RB)  [IMAGE  =]  boot-image-name

               [FILE   =]  filename 

               [TYPE   =   DISC  ]

                          [ TAPE ]

                          [ BOTH ]

IMAGE specifies an existing boot image name to be modified or replaced. If the specified boot image does not exist, an error occurs.

FILE specifies a file name to replace the designated boot image. If it is not fully qualified with group and account name, it defaults to the current group and account. If the specified file does not exist, an error occurs.

TYPE specifies the boot image type. The various types are defined as follows:

To modify or replace a boot image file name, enter the command, image name, and fully qualified file name. Here are two examples.

   sysfile>RBOOT imagename TYPE=DISC 



   sysfile>RBOOT imagename filename DISC 

Use the SHOW command to display the boot image file names maintained by the system.

Configuring a message catalog

The RCAT command (abbreviated RC) configures the message catalog to be used on the target system. RCAT has the following parameter:

   RCAT (RC)     [NAME     =] filename

The system message catalog contains all the system and subsystem messages. It is retained under a known file name (CATALOG.PUB.SYS).

NAME specifies a catalog file name. If the name is not fully qualified, it defaults to the current group and account.

To replace the default catalog name CATALOG.PUB.SYS with a new catalog name, enter RCAT and the fully qualified file name:

   sysfile>RCAT filename.group.account 

If the new message catalog file was not previously created, an error occurs.

	NOTE: For information on how to modify an existing message catalog, refer to the Message Catalogs Programmer's Guide (32650-60012).

Replacing a CMSL segment

The RCMSL command (abbreviated RCM) replaces a segment in the CMSL. RCMSL has the following parameters:

   RCMSL (RCM)  [SEG  =] segment-name

                [FILE =] filename 

                [MODE =   S ] 

                        [ C ]

                        [ P ] 

                        [ U ] 

SEG specifies a new segment name of maximum eight characters. If a nonexistent segment name is specified, an error occurs.

FILE specifies a file name to be added to the CMSL. The filename parameter can be fully qualified with group and account. If not, it defaults to the current group and account. If the file name cannot be found, an error occurs.

MODE indicates where the added SL segment is to reside. It expects one of the four options listed below. Other input causes an error.

Use the LCMSL command to display the segments maintained in the CMSL.

Replacing or defining a network configuration file

The RDCC command (abbreviated RD) defines the network configuration file to be used. This command also checks for conflicts with SYSGEN's I/O configuration. The file named becomes NMCONFIG.PUB.SYS for SYSGEN's tape only. The user must install or update the system from tape before the file can be used by the network software.

RDCC has the following parameter:

   RDCC (RD)     [FILE     =] filename

The FILE parameter identifies the network configuration file. If the name is not fully qualified, it defaults to the current group and account. If no file paramter is entered, the network configuration file is changed back to NMCONFIG.PUB.SYS.

To add the network configuration file information to the current SYSGEN configuration information, enter the command and file name. Then, follow this sample sequence:

   sysfile>RDCC filename.group.account

   sysfile>HOLD          (Cross-validation conflicts noted)

   sysfile>EXIT

   sysgen>IO            (Make I/O changes if necessary)

                         (Conflicts also noted here)

   sysgen>KEEP NETWORK  (Conflicts also noted here)

   sysgen>TAPE          (Conflicts also noted here)

For additional information, refer to Chapter 5 “Modifying Input/Output (I/O) Configurations”. For additional information on remote configurations, refer to the Asynchronous Serial Communications System Administrator's Reference Manual (32022-61001) and the HP 3000/iX Network Planning and Configuration Guide (36922-61023).

Replacing an IPL image

The RIPL command (abbreviated RI) replaces an existing IPL image in the list of files dumped onto SYSGEN's tape. The command has the following parameters:

   RIPL (RI) [IMAGE =]imagename [FILE =]filename

IMAGE specifies an existing IPL image to be modified or replaced. If the specified image does not exist, an error occurs and the system issues a message.

FILE specifies a file name to replace the specified IPL image. If it is not fully qualified with group and account name, it defaults to the current group and account. If the specified file does not exist, an error occurs and the system issues a message.

There can be only one disk and one tape IPL, each of which is replaced by its image name. Both IPL files must reside on the tape.

To replace an IPL image, enter the command and the image and file names:

   sysfile>RIPL imagename filename

Replacing the native mode library

The RNMLIB command (abbreviated RN) replaces the system NM library that resides in NL.PUB.SYS. The RNMLIB command has the following parameters:

   RNMLIB (RN) [FILE =]filename

FILE is the file name of the library to replace the current one. If the file name is not fully qualified, it defaults to the current group and account. If the file name does not exist, an error occurs.

To replace an existing NM library, enter the following command format:

   sysfile>RNMLIB filename.group.account

Replacing a system program

The RSPROG command (abbreviated RS) replaces an existing system program. RSPROG has the following parameters:

   RSPROG (RS) [PROG =]programname [FILE =]filename

PROG specifies an existing program name. If the name entered does not exist, an error occurs.

FILE specifies the file name to replace the specified system program. If the file name is not fully qualified with group and account name, it defaults to the current group and account. If the file name does not exist, an error occurs.

Enter the command, an existing program name, and the fully qualified file name to replace the system program:

sysfile>RSPROG programname.group.account filename.group.account

Use the SHOW command (SH SPROG) to display all the system programs maintained by the configuration.

	CAUTION: Do not use the SYSFILE> RSPROG command to rename Hewlett-Packard supplied MPE/iX HP 3000 system files. A renamed system file can corrupt your system during an update. This problem can occur if you have third party software installed on your system and you have renamed some system files to use this software. Use the SHOW command in SYSFILE to ensure that all Hewlett-Packard supplied system files have retained their original name. System filenames in both columns should be identical. If they are not identical, rename the files in the second column to the filename in the first column.