HPlogo Performing System Management Tasks: HP 3000 MPE/iX Computer Systems > Chapter 5 Changing System Libraries, Programs, and Message Catalogs

Using the SYSFILE Configurator

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Use the SYSFILE configurator to display current information about system libraries, system programs, and the system message catalog and to make changes to the file system information.

To access the SYSFILE configurator

You make all changes to system files from within the SYSFILE configurator, which is one of the SYSGEN modules. To access the SYSFILE configurator, do the following:

  1. At the MPE prompt, enter:

       SYSGEN
    
  2. At the SYSGEN prompt (sysgen>), enter:

       sysgen>SY
    

When you first enter the SYSFILE configurator, you will see a list of the commands available to you. To issue a command, either enter the full command name or the abbreviation shown in parentheses.

Figure 5-1 Example 4-1. Activating the SYSFILE Configurator



   sysgen>SY 



          ** SYSFILE configurator commands ** 



          aauto (aa)      aboot (ab)     acmsl (ac)     asprog (as) 

          cmsl (cm)       dauto (da)     dboot (db)     dcmsl (dc) 

          dsprog (ds)     lcmsl (lc)     rauto (ra)     rboot (rb) 

          rcat (rc)       rcmsl (rcm)    rdcc (rd)      ripl (ri) 

          rnmlib (rn)     rsprog (rs)    show (sh) 



          clear (cl)(c)   exit (ex)(e)   help (he)(h)   hold (ho) 

          oclose (oc)     redo 


You use most of the SYSFILE configurator commands to add, delete, replace, list, or specify eight system file objects. Table 5-1 summarizes these actions. It lists the objects from top to bottom and shows the corresponding actions from left to right.

Table 5-1 SYSFILE Configurator Command Matrix

 AddDeleteReplaceListSpecify
Autoboot ImageAAUTODAUTORAUTO  
Boot ImageABOOTDBOOTRBOOT  
CMSL SegmentACMSLDCMSLRCMSLLCMSLCMSL
System ProgramASPROGDSPROGRSPROG  
System Catalog  RCAT  
Network Config  RDCC  
IPL Image  RIPL  
NM Library  RNMLIB  

 

To use online help

You can display helpful information about any of the SYSFILE configurator commands on the screen. To do so, enter the HELP command at the sysfile> prompt in one of two forms:

  • To get help for a specific command, type HELP and then the command name. For example, to display a description, the syntax, and examples of the RCMSL command, enter:

       sysfile:HELP RCMSL
    
  • To see a list of all the SYSFILE configurator commands with a brief description of each one, simply enter HELP or H.

To display current file information

Use the SHOW command (abbreviated SH) to display current file information. The syntax of the SHOW command is:

SHOW (SH) [[FILE =] { AUTO BOOT CATALOG CMSL DCC IPL NMLIB SPROG ALL }] [ [DEST =] OFFLINE ]

ParameterDefinition
AUTOShows the autoboot images in use.
BOOTShows the boot images currently configured.
CATALOGShows the system catalog in use.
CMSLShows the compatibility mode segmented library in use.
DCCShows the network configuration file in use.
IPLShows the initial program loader image in use.
NMLIBShows the native mode library in use.
SPROGShows the specified system program names in use.
ALLShows all of the above information.
OFFLINERedirects the output of the SHOW command to SYSGEN's listing file, SYSGLIST. To print the file, you enter either the OCLOSE command or exit SYSGEN.

To display information about one or all system file objects, at the sysfile> prompt, enter:

   sysfile>SHOW parameters

For example, to list current file information for the native mode library, enter:

   sysfile>SH NMLIB

To show current information for all objects you control with the SYSFILE configurator including system libraries, programs, and the message catalog, enter:

   sysfile>SHOW

Or you can enter:

   sysfile>SHOW ALL

To add objects to the SLT

Use the add commands (AAUTO, ABOOT, ACMSL, and ASPROG) to add objects to the list of files dumped onto the system load tape (SLT). The commands are summarized below and explained in the remainder of this section.

ParameterDefinition
AAUTOAdds an autoboot file to the list of files.
ABOOTAdds a boot image to the list of files.
ACMSLAdds a segment to a temporary copy of the CMSL, which SYSGEN automatically manages.
ASPROGAdds a system program or other file to the list of files.

To add autoboot files

Use the AAUTO command (abbreviated AA) to add an autoboot file to the list of files dumped onto the system load tape. Your system can have only one disk autoboot file (known as AUTOBOOT.MPEXL.SYS) and one tape autoboot file (known as TAPEAUTO.MPEXL.SYS). However, neither is required.

The syntax of the AAUTO command is:

AAUTO (AA) { [FILE =] autobootfilename} [[TYPE =] { DISC TAPE BOTH }]

ParameterDefinition
FILEThe file that contains autoboot commands. If you do not enter the group and account name, it defaults to the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)
TYPE

The type of boot image to add, which can be any of the following:

DISC

The file can only be used in a disk boot.

TAPE

The file can only be used in a tape boot.

BOTH

The file can be used in both a disk boot and a tape boot.

For example, to add the autoboot file IOMAP2.UTIL.SYS, which is both a disk and tape file, enter:

   sysfile>AAUTO FILE=IOMAP2.UTIL.SYS TYPE=BOTH

To add boot files

Use the ABOOT command (abbreviated AB) to add a boot image to the system file configuration. The syntax of the command is:

ABOOT (AB) { [IMAGE =] bootimagename} { [FILE =] filename } {[TYPE =] { DISC TAPE BOTH }}

ParameterDefinition
IMAGEThe name of a boot image. If the specified boot image already exists, an error occurs.
FILEThe name of the boot image file. If you do not enter the group and account name, it defaults to the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)
TYPE

The type of boot image to add, which can be any of the following:

DISC

The file can only be used in a disk boot.

TAPE

The file can only be used in a tape boot.

BOTH

The file can be used in both a disk boot and a tape boot.

For example, to add file information for the boot image ISL.MPEXL.SYS, enter:

   sysfile>ABOOT IMAGE=ISL.MPEXL.SYS FILE=ISL.MPEXL.SYS&

   TYPE=DISC

To add a segment to the CMSL

Use the ACMSL command (abbreviated AC) to add a segment to the compatibility mode segmented library (CMSL). The syntax of the command is:

ACMSL (AC) { [SEG =] segmentname} { [FILE =] filename} [[MODE =] { P S C U }]

ParameterDefinition
SEGThe name of a new segment, which can be a maximum of eight characters. If you enter an existing segment name, you will get an error.
FILEThe name of the file you want added to the CMSL. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)
MODE

Where the added SL segment is to reside, which must be one of the following four options:

P

A permanently allocated user segment. This parameter performs the same function as the ALLOCATE command.

S

A permanently allocated system intrinsic segment in virtual memory.

C

A core-resident system intrinsic segment.

U

A regular user segment. This is the default.

For example, to add the new segment name SDCUTIL1 to the CMSL as a regular user segment, enter:

   sysfile>ACMSL SEG=SDCUTIL1 FILE=USLNEW.PUB.SYS MODE=U

To add file names to save to tape

Use the ASPROG command (abbreviated AS) to add a system program or other file to the list of files to be saved on tape. The syntax of the command is:

ASPROG (AS) { [PROG =] program name } { [FILE =] filename}

ParameterDefinition
PROGThe name of a new system program. If program name you enter already exists in the system program list, you will get an error.
FILEThe name of the file to be used as the system program. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)

For example, to add FCOPY.PUB.SYS to the system load tape, using the same name, enter:

   sysfile>ASPROG PROG=FCOPY.PUB.SYS FILE=FCOPY.PUB.SYS

To delete objects from the SLT

Use the delete commands (DAUTO, DBOOT, DCMSL, and DSPROG) to delete objects from the list of files dumped to the system load tape. The commands are summarized below and explained in the remainder of this section.

ParameterDefinition
DAUTODeletes the specified autoboot type from the list of files.
DBOOTDeletes boot images from the list of files.
DCMSLDeletes segments from the CMSL.
DSPROGRemoves system programs or files from the list of files.

To delete autoboot images

Use the DAUTO command (abbreviated DA) to delete the specified autoboot type from the list of files dumped onto the system load tape. The syntax of the command is:

DAUTO {[TYPE =] { DISC TAPE BOTH }}

ParameterDefinition
TYPE

The type of boot image to delete, which must be one of the following:

DISC

The file can only be used in a disk boot.

TAPE

The file can only be used in a tape boot.

BOTH

The file can be used in both a disk boot and a tape boot.

For example, to delete type TAPE, enter:

   sysfile>DAUTO TYPE=TAPE

To delete boot images

Use the DBOOT command (abbreviated DB) to delete a boot image file name. The syntax of the command is:

DBOOT (DB) { [IMAGE =] [bootimagename] [, ... ]}

IMAGE is a repeated parameter that you use to specify one or more boot images to delete. If you enter a boot image name that does not exist, you will get a warning. (To display a list of valid boot image file names, use the SHOW command.)

For example, to remove the image file SAT.MPEXL.SYS, enter:

   sysfile>DBOOT IMAGE=SAT.MPEXL.SYS

To delete compatibility mode segments

Use the DCMSL command (abbreviated DC) to delete segments from the compatibility mode segmented library (CMSL). The syntax of the command is:

DCMSL (DC) { [SEG =] [segmentname] [,...]}

SEG is a repeated parameter that you use to specify one or more segments currently in the CMSL. If you enter the name of a segment that doesn't exist, you will get an error. (To list the contents of the CMSL, use the LCMSL command.)

For example, to delete the segments SDCUTIL5 and SDCUTIL6 from the system load tape, enter:

   sysfile>DCMSL SEG=SDCUTIL5,SDCUTIL6

To delete system programs

Use the DSPROG command (abbreviated DS) to delete system programs or files from the system configuration. The syntax of the command is:

DSPROG has the following parameter:

DSPROG (DS) { [PROG =] [programname] [,...]}

PROG is a repeated parameter that you use to specify one or more the system programs to delete. If you enter a program name that doesn't exist, you will get an error. (To see what program names are currently in use, use the SHOW SPROG command.)

For example to remove FCOPY.PUB.SYS from the system configuration, enter:

   sysfile>DSPROG PROG=FCOPY.PUB.SYS

To replace objects on the SLT

Use the replace commands (RAUTO, RBOOT, RCAT, RCMSL, RDCC, RIPL, RNMLIB, and RSPROG) to replace or modify information in the list files dumped to the system load tape. The commands are summarized below and explained in the following sections.

ParameterDefinition
RAUTOReplaces an existing autoboot image or modifies the autoboot type.
RBOOTReplaces an existing boot image or modifies the boot type.
RCATReplaces the message catalog.
RCMSLReplaces a segment in the temporary copy of the CMSL.
RDCCDefines network configuration file dumped to the SLT.
RIPLReplaces an existing IPL image.
RNMLIBReplaces a native mode (NM) library.
RSPROGReplaces an existing system program or other file.

To replace autoboot images

Use the RAUTO command (abbreviated RA) to replace an existing autoboot image in the list of files dumped to the system load tape. The syntax of the command is:

RAUTO (RA) { [FILE =] autobootfilename} {[TYPE =] { DISC TAPE BOTH }}

ParameterDefinition
FILEThe file to replace the designated autoboot image. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)
TYPE

The boot image type, which must be one of the following:

DISC

The file can only be used in a disk boot.

TAPE

The file can only be used in a tape boot.

BOTH

The file can be used in both a disk boot and a tape boot.

To display the autoboot image file names maintained by the system, use the SHOW command. To replace a file, select one from the list. For example, to replace the autoboot image file AIMAGE.MPEXL.SYS, enter:

   sysfile>RAUTO FILE=AIMAGE.MPEXL.SYS TYPE=TAPE

To replace boot images

Use the RBOOT command (abbreviated RB) to modify the boot type of an existing boot image file name or to replace the boot image file name with another boot image file name. The syntax of the command is:

RBOOT (RB) { [IMAGE =] bootimagename} { [FILE =] filename } {[TYPE =] { DISC TAPE BOTH }}

ParameterDefinition
IMAGEThe name of the existing boot image that you want to modify or replace. If you enter a file name that does not exist, you will get an error.
FILEThe name of the file that replaces the designated boot image. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)
TYPE

The boot image type, which must be one of the following:

DISC

The file can only be used in a disk boot.

TAPE

The file can only be used in a tape boot.

BOTH

The file can be used in both a disk boot and a tape boot.

To display the boot image file names maintained by the system, use the SHOW command. To replace a file, select it from the list. For example, to modify the file START.MPEXL.SYS, enter:

   sysfile>RBOOT FILE=START.MPEXL.SYS&

   FILE=START.MPEXL.SYS TYPE=DISC

To configure a message catalog

The system message catalog contains all the system and subsystem messages and is kept in a file named CATALOG.PUB.SYS. Use the RCAT command (abbreviated RC) to specify which message catalog you want used on the system. The syntax of the command is:

RCAT (RC) { [NAME =] filename}

If you do not enter the group and account name as part of the filename parameter, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.) If you specify a message catalog file that has not been created, you will get an error.

For example, to replace the default catalog name CATALOG.PUB.SYS with the new catalog STARCAT.PUB.SYS, enter:

   sysfile>RCAT NAME=STARCAT.PUB.SYS
NOTE: With the introduction of MPE/iX release 4.5, all error message text is now mixed case, rather than in all uppercase characters as in the past. The changes affect set 2 of CATALOG.PUB.SYS, (lines numbered 2100 to 13006.01). The content of logfiles and console messages are not affected by this change.

In the unlikely event that the mixed-case error messages create a problem for one of your applications, you can edit CATALOG.PUB.SYS to upshift the message text in set 2 and install the edited version of the message catalog.

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

To replace a CMSL segment

Use the RCMSL command (abbreviated RCM) to replace a segment in the CMSL. The syntax of the command is:

RCMSL (RCM) { [SEG =] segmentname} { [FILE =] filename} [ MODE = { P S C U } ]

ParameterDefinition
SEGThe name of a new segment, which can be a maximum eight characters. If you specify a segment that does not exist, you will get an error.
FILEThe name of the file you want to add to the CMSL. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)
MODE

Where the added SL segment is to reside, which must be one of the four options listed below:

P

A permanently allocated user segment. This parameter requests the same function as the ALLOCATE command.

S

A permanently allocated system intrinsic segment (in virtual memory).

C

A core-resident system intrinsic segment.

U

A regular user segment. This is the default.

To display the segments maintained in the CMSL, use the LCMSL command. To replace a segment, select one from the list. For example, to replace the regular user segment SDCUTIL1, enter:

   sysfile>RCMSL SEG=SDCUTIL5 FILE=USLNEW.PUB.SYS MODE=P

To replace or define a network configuration file

Use the RDCC command (abbreviated RD) to specify a new or replacement network configuration file and to check for conflicts between the network configuration and SYSGEN's I/O configuration.

The syntax of the RDCC command is:

RDCC (RD) { [FILE =] filename }

If you do not enter a fully qualified file name, it defaults to the current group and account. If you do not enter the FILE parameter, SYSGEN uses the default network configuration file NMCONFIG.PUB.SYS.

To add the network configuration file information to the current SYSGEN configuration and cross validate, do the following:

  1. Specify the network configuration file by entering:

       sysfile>RDCC FILE=filename
    
  2. Cross validate the file by entering the following sequence of commands:

       sysfile>HOLD  
    
    
    
       sysfile>EXIT 
    
    
    
       sysgen>IO
    
    
    
       .
    
       .
    
       .
    
    
    
       sysgen>KEEP NETWORK
    
  3. Create a system load tape and use it to update the system with the new network configuration.

NOTE: For more information on remote configurations, refer to the NS3000/XL Network Manager's Reference Manual (36920-90002) and to Chapter 2 “Getting Started Defining Your System”.

To replace an IPL image

Use the RIPL command (abbreviated RI) to replace an existing IPL image in the list of files dumped onto the system load tape. 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. The syntax of the command is:

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

ParameterDefinition
IMAGEThe existing IPL image that you want to modify or replace. If you specify an image that does not exist, you will get an error.
FILEThe file that replaces the specified IPL image. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)

For example, to replace the image ISL2.MPEXL.SYS, enter:

   sysfile>RIPL IMAGE=ISL2.MPEXL.SYS FILE=IPL2.MPEXL.SYS

To replace the native mode library

Use the RNMLIB command (abbreviated RN) to replace the system native mode library in NL.PUB.SYS. The syntax of the RNMLIB command is:

RNMLIB (RN) { [FILE =] filename}

If you do not enter the group and account name as part of the filename parameter, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)

For example, to replace NL.PUB.SYS with MYNL.PUB.SYS, enter:

   sysfile>RNMLIB FILE=mynl.PUB.SYS

To replace a system program

Use the RSPROG command (abbreviated RS) to replace an existing system program. The syntax of the command is:

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

ParameterDefinition
PROGThe name of an existing system program. If you specify a file that does not exist, you will get an error.
FILEThe name of the file replacing the specified system program. If you do not enter the group and account name, it defaults the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the files.)

For example, to replace the file JOB in the PUB group of the SYS account with a program of the same name, enter:

   sysfile>RSPROG PROG=JOB.PUB.SYS FILE=JOB.PUB.SYS

To use a segmented library file as CMSL

Use the CMSL command (abbreviated CM) to specify the segmented library file you want used as the compatibility mode segmented library (CMSL). The syntax of the CMSL command is:

CMSL (CM) { [SL =] slname}

If you do not enter the group and account name as part of the slname parameter, it defaults to the current group and account. (If you then run SYSGEN from a different group and account to create the system load tape, SYSGEN will not be able to find the file.) If you do not specify a segmented library, SYSGEN uses the default SL.PUB.SYS.

For example, To change the default SL.PUB.SYS to NEWSL.PUB.SYS, enter:

   sysfile>CMSL SL=NEWSL.PUB.SYS

To list CMSL contents

Use the LCMSL command (abbreviated LCMSL) to list the contents of the compatability mode segemented library (CMSL) or a single segment in the CMSL. The syntax of the LCMSL command is:

LCMSL (LC) { [SEG =] segmentname}

The segmentname parameter specifies the name of the segment you want to review. If you don't specify a segment, SYSGEN lists the entire contents of the CMSL.

For example, to list the contents of the segment IPCSEG, enter:

   sysfile>LCMSL SEG=IPCSEG
NOTE: When you issue the LCMSL command, the system may appear to be down or programs will stop processing because the command locks whichever SL it is listing. If the CMSL is SL.PUB.SYS and you have made no changes to it (which force a temporary SL to be created), any program that uses the SL stops.
Feedback to webmaster