HP 3000 Manuals

Changing Configurations [ Performing System Management Tasks ] MPE/iX 5.0 Documentation


Performing System Management Tasks

Changing Configurations 

There are five IO configurator commands that you can use to modify
objects on your system:  MADDRESS, MCLASS, MDEV, MPATH, and MVOL. They
are defined in the table below and explained in the following sections.

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MADDRESS            | Modifies the I/O path from one that exists to a new path that does |
|                     | not already exist.                                                 |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MCLASS              | Changes I/O class information.                                     |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MDEV                | Changes the attributes of a configured device.                     |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MPATH               | Changes the attributes of an I/O path.                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MVOL                | Modifies the attributes of a volume set member.                    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

To modify paths 

An address is an I/O path identifying a specific I/O device.  Use the
MADDRESS command (abbreviated MA) to change SYSGEN's view of the physical
location of channel adapters, device adapters, and devices.  To modify a
path, at the IO configurator prompt (io>), enter:

     io>MADDRESS fromdevicepath todevicepath 

MADDRESS has the following parameters:

MADDRESS (MA) {[FROM =] fromdevicepath}
              {[TO =] todevicepath    }
The FROM and TO parameters are standard I/O path specifications.  If the
FROM path does not exist, or if both I/O paths do not have the same
number of levels, SYSGEN issues an error.

To change a path.   

To change an existing I/O path to a new I/O path that is not configured,
enter MADDRESS FROM=devicepath TO=devicepath.  For example, to change the
path from 4.1.2 to 4.1.3 on a Series 925 or Series 935 system, enter:

     io>MADDRESS 4.1.2  4.1.3 

and to change the path from 2/4.0.2 to 6/4.0.3 on Series 950 through
Series 980 systems, enter:

     io>MADDRESS 2/4.0.2 6/4.0.3 

MADDRESS works at the device-adapter level as well as the device level.
In fact, this use is probably more common, because it allows you to move
a device-adapter card and all of its devices in one command.  For
example, if path 4.2 describes an HP-IB adapter with four disks (LDEVS 2,
4, 9, 15), you can move the adapter to slot 3 (4.3) in one step:

     io>MADDRESS 4.2 4.3 

To modify an address, you must change the TO address to the higher or
previous level with the APATH command; otherwise, SYSGEN issues an error.
All paths used in the MADDRESS command line must be at the same level.

To modify classes 

Use the MCLASS command (abbreviated MC) to change I/O class information
including class mode, class name, and the devices associated with the
class.  To modify a class, at the IO configurator prompt (io>), enter:

     io>MCLASS classname newclassname additionalparameters 

MCLASS has the following parameters:

MCLASS (MC) {[CLASS] = classname} [[NEWCLASS =] newclassname]

[[ALDEV =] devicerange[,devicerange] [...]]

                                           [         {IN     }]
                                           [         {OUT    }]
[[DLDEV =] devicerange[,devicerange][...]] [[MODE =] {CIO    }]
                                           [         {NCIO   }]
                                           [         {RANDOM }]
                                           [         {DEFAULT}]
You must enter the CLASS parameter and at least one other parameter.

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| NEWCLASS            | Changes the name of the class.  The new name must not exist prior  |
|                     | to using NEWCLASS.                                                 |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| ALDEV               | Adds the specified devices to the class.  If a device does not     |
|                     | exist (is not configured), SYSGEN issues a warning.                |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| DLDEV               | Removes the specified devices from the class.  If a device does    |
|                     | not exist, SYSGEN issues a warning.                                |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MODE                | Changes the mode of the class.  The mode remains unchanged if MODE |
|                     | is omitted from the MCLASS command line.                           |
|                     |                                                                    |
|                     | The modes are defined as follows:                                  |
|                     |                                                                    |
|                     |                                                                    |
|                     | IN            Input only device                                    |
|                     |                                                                    |
|                     | OUT           Output only device                                   |
|                     |                                                                    |
|                     | CIO           Concurrent I/O                                       |
|                     |                                                                    |
|                     | NCIO          Nonconcurrent I/O                                    |
|                     |                                                                    |
|                     | RANDOM        Direct access device (for example, disk)             |
|                     |                                                                    |
|                     | DEFAULT       Assign at system initialization                      |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

To change a class.   

To change a class, you enter the class name and at least one additional
parameter.  For example, to change the class name from LP to BIGPRN and
specify BIGPRN as an output device (using keyword parameters), enter:

     io>MCLASS CLASS=LP NEWCLASS=BIGPRN MODE=OUT 

To change the BONSAI class to SMALLPRN and add two more devices to it
(using positional parameters), enter:

     io>MCLASS BONSAI SMALLPRN 28/29 

To modify devices 

Use the MDEV command (abbreviated MD) to modify the attributes of a
device.  You enter the command, the LDEV number of the device you want to
change, and at least one other parameter.  You cannot use the MDEV
command to change a Hewlett-Packard supported device to a USER
(unsupported) device.

To modify a device, at the IO configurator prompt (io>), enter:

     io>MDEV ldev otherparameters 

MDEV has the following parameters:

MDEV (MD) {[LDEV =] logicaldevice #} [[NEWLDEV =] newlogicaldevice#]

[[ID =] deviceid] [[PATH =] devicepath] [[CLASS =] classname]

[         {JOB        }]
[         {DATA       }]
[         {INTERACTIVE}]
[         {DUPLICATIVE}]
[[MODE =] {INPUT      }] [[OUTDEV =] outputdevice] [[RSIZE =] devrecsize]
[         {OUTPUT     }]
[         {AUTOREPLY  }]
[         {NLIO       }]
[         {NONE       }]

[[PMGR =] physicalmgrname] [[LMGR =] logicalmgrname]

[[PMGRPRI =] physmgrpri] [[MPETYPE =] cmtype] [[MPESUBTYPE =] cmsubtype]

[[DEVNAME =] devicename]

For example, to use the MDEV command to change logical device 8 to 18,
the device identification to HP7978H, the path to 4.3.0, and the mode to
JOB, enter:

     io>MDEV 8 18 HP7978H 4.3.0 MODE=JOB 

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| LDEV                | Specifies which devices to modify.  If a specified device number   |
|                     | does not exist, SYSGEN issues a warning.                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| NEWLDEV             | Gives the new device numbers associated with the specified         |
|                     | devices.  The number of devices given must match the number of     |
|                     | devices specified in the LDEV parameter.                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| ID                  | Changes the product ID associated with the devices.  Changing the  |
|                     | product ID changes other parameters, such as record size and       |
|                     | device mode, to those found in the I/O defaults file unless you    |
|                     | explicitly specify the parameters in the MDEV command.  If you     |
|                     | give an invalid product ID, SYSGEN issues an error message.        |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PATH                | Defines the path for the system to take to reach this LDEV. If the |
|                     | new path already exists, SYSGEN issues an error message.           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| CLASS               | Changes classes associated with given devices.  If you do not      |
|                     | enter this parameter and change the product ID with the  ID        |
|                     | parameter, SYSGEN uses the default classes for the device.         |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MODE                | Changes the device mode of the given devices.  The mode must be    |
|                     | within the maximum allowed modes given in the I/O default file.    |
|                     | If you do not give this parameter and change the product ID with   |
|                     | the  ID parameter, SYSGEN uses the default mode for the device.    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| OUTDEV              | Specifies the new output device for the devices being modified.    |
|                     | If you do not specify this parameter, it does not change unless    |
|                     | the device is a terminal or you change the product ID.             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| RSIZE               | Changes the record size of the devices being modified.  If you do  |
|                     | not give this parameter and change the product ID with the  ID     |
|                     | parameter, SYSGEN uses the default record size for the device.     |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PMGR and LMGR       | Is the name of the physical or logical device manager to be        |
|                     | associated with the specified I/O path.  The manager name has a    |
|                     | maximum length of 32 characters and may contain numeric,           |
|                     | alphabetic, and underline characters (_).  If you change the ID    |
|                     | and do not specify the PMGR or LMGR parameter, SYSGEN uses the     |
|                     | default.  Not all devices have logical device managers.            |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PMGRPRI             | Is the priority level at which the physical device manager         |
|                     | executes.  If you change the ID and do not specify the PMGRPRI     |
|                     | parameter, SYGEN uses the default.                                 |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MPETYPE and         | Are allowed for only USER devices.                                 |
| MPESUBTYPE          |                                                                    |
|                     | If you do not give any of these parameters and you change the      |
|                     | product ID with the ID parameter, SYSGEN uses the default values.  |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| DEVNAME             | Allows the user to specify a device name which can be used in      |
|                     | place of the LDEV number of this I/O device.  A device name must   |
|                     | begin with a letter.  A device name of exactly eight characters    |
|                     | that begins with the letter "D" followed immediately by one or     |
|                     | more digits is invalid.  The name "VTERM" is reserved and is       |
|                     | flagged as an error if specified for any LDEV. No two LDEVs may    |
|                     | have the same device name, and all device names and class names    |
|                     | must be mutually exclusive.                                        |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

To change a device to the streams device 

The streams device accepts batch jobs.  It requires a specific mode (JOB
and DATA) and you must assign an output device.  Also, you must make
these changes in one step, that is, by issuing a single MDEV command.

For example, to make LDEV 10 the streams device with LP as the output
device, enter:

     io>MDEV 10 MODE=(JOB,DATA) OUTDEV=LP 

To modify I/O paths 

Use the MPATH command (abbreviated MP) to modify the attributes
associated with an I/O path.  To modify a path, at the IO configurator
prompt (io>), enter:

     io>MPATH devicepath  additional parameters 

MPATH has the following parameters:

MPATH (MP) {[PATH =] IOpath} [[ID =] productid]

[[PMGR =] physicalmgrname] [[LMGR =] logicalmgrname] [[PMGRPRI =] mgrpri]

[[MAXIOS =] maxconcurrentchannelIOs]

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PATH                | Indicates the path that you want to modify.  If you do not specify |
|                     | PATH, SYSGEN issues an error message.  Although you are not        |
|                     | required to use other parameters, you must specify at least one    |
|                     | for the command to function properly.                              |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| ID                  | Changes the product ID associated with this path.  Changing the    |
|                     | product ID changes all of the other parameters to defaults unless  |
|                     | you explicitly override them.                                      |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PMGR                | Is the name of the physical manager associated with the specified  |
|                     | I/O path.  The manager name has a maximum length of 32 characters  |
|                     | and may contain numbers, letters, and underline characters.  If    |
|                     | you change the ID and do not give this parameter, SYSGEN uses the  |
|                     | default.                                                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| LMGR                | Is the name of the logical manager associated with the specified   |
|                     | I/O path.  Not all devices have logical device managers.  The      |
|                     | manager name has a maximum length of 32 characters and may contain |
|                     | numbers, letters, and underline characters.  If you change the ID  |
|                     | and do not give this parameter, SYSGEN uses the default.           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PMGRPRI             | Is the priority level at which the physical device manager         |
|                     | executes.  If you change the ID and do not give this parameter,    |
|                     | SYSGEN uses the default.                                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXIOS              | Tells the device manager how many concurrent I/O operations to     |
|                     | expect.  Normally, you do not specify MAXIOS. The default is zero, |
|                     | which allows the device manager to set its own default.            |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

To change a product ID.   

The ID parameter changes a product identification number.  For example,
to change the ID on a Series 925 through 949 system or a Series 958
system, enter:

     io>MPATH 4.1 HP27113A 

Or, to change an ID on a Series 950 through 980 system, enter:

     io>MPATH 2/4.3 HP27113A 

To change the name of the physical device manager.   

To change the name of the physical device manager, use the MPATH command
followed by the PMGR parameter and the new name.  For example, to rename
the device manager on a Series 925 through 949 system or a Series 958
system, enter:

     io>MP 4.1 PMGR=HPIB_DAM 

Or, to rename the device manager on a Series 950 through 980 system,
enter:

     io>MPATH 2/4.3 PMGR=HPIB_DAM 

If you change the ID parameter and do not use the PMGR parameter, SYSGEN
uses the default.

To modify volumes 

Use the MVOL command (abbreviated MV) to modify the attributes of a
volume set member.  Changes made with this command take effect only if
you do an INSTALL with a tape containing the changes.  To modify a volume
set member, at the IO configurator prompt (io>), enter:

     io>MVOL volumename otherparameters 

MVOL has the following parameters:

MVOL (MV) {[VNAME =] volumename} [[NEWVNAME =] newvolumename]

[[LDEV =] logicaldevice#] [[TRANSIENT =] %diskfortransobj]
[[PERMANENT =] %diskforpermobj] [[VCLASS =] volumeclass]

You cannot modify the system master volume, MEMBER1, in any way.

The parameters are defined below.  Refer to the "To add volumes" section
of this chapter for examples of their use.

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| VNAME               | Indicates the existing volume member name.  Each member must have  |
|                     | a unique name.  The volume member name is currently 16 characters  |
|                     | or less, with numbers, letters, and underline characters allowed.  |
|                     | The first character must be a letter.  If the volume member does   |
|                     | not exist, an error occurs.                                        |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| NEWVNAME            | Specifies a new volume name to replace the name of the volume      |
|                     | member identified.                                                 |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| LDEV                | Specifies the logical device number to be treated as the volume    |
|                     | member.                                                            |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| TRANSIENT           | Is the amount of disk space that is reserved for transient objects |
|                     | and is given as a percentage.                                      |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| PERMANENT           | Is the amount of disk space that is reserved for permanent         |
|                     | objects.                                                           |
|                     |                                                                    |
|                     | The total percentage given by TRANSIENT and PERMANENT must be at   |
|                     | least 100 percent and can be as high as 200 percent, although this |
|                     | is not recommended.                                                |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| VCLASS              | Specifies the volume class(es) that the identified volume belongs  |
|                     | to.  Up to eight classes may be specified, with the same           |
|                     | restrictions as VNAME except that it can be 32 characters long.    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation