 |
» |
|
|
|
To view and modify the I/O configuration from within SYSGEN,
you use the I/O configurator module. To do so, start SYSGEN and
enter IO at the SYSGEN prompt. SYSGEN displays the commands
available to you. To issue a command, you can enter either the full
command name or the abbreviation shown in parentheses. Example 5-1 Starting the I/O Configurator
:SYSGEN
sysgen>IO
** I/O configurator commands **
aclass (ac) adev (ad) apath (ap) avol (av)
dclass (dc) ddev (dd) dpath (dp) dvol (dv)
lclass (lc) ldev (ld) lpath (lp) lvol (lv)
maddress(ma) mclass (mc) mdev (md) mpath (mp)
mvol (mv)
clear (cl)(c) exit (ex)(e) help (he)(h) hold (ho)
oclose (oc) redo
io>
|
Getting help with I/O Configurator commands |  |
The help facility enables you to identify quickly the function and syntax of those I/O configurator commands and options required to perform the multiple operations that define or change device-dependent information. To see a list of the commands available for use in the I/O configurator
and their abbreviations, enter HELP at the I/O configurator prompt.
To display the syntax for each available command at the current level, enter
HELP ALL, as shown in the example below: Example 5-3 I/O Configurator HELP ALL Command Output
io>HELP ALL
command (abb) parameter=value
------------- ---------------
aclass (ac) class = name
ldev = #/#,#,...
[mode = IN|OUT|CIO|NCIO|RANDOM|
DEFAULT]
adev (ad) ldev = #/#,#,...
[path = devicepath]
id = productid
[rsize = recordsize]
[outdev = outputdevice]
[mode = JOB|DATA|INTERACTIVE|DUPLICATIVE|
INPUT|OUTPUT|AUTOREPLY|NLIO|NONE]
[class = classname,...|NONE]
[cmode = IN|OUT|CIO|NCIO|RANDOM|
DEFAULT]
[pmgr = physicalmanagername]
[lmgr = logicalmanagername]
[pmgrpri = physicalmanagerpriority]
[mpetype = compmodetype]
[mpesubtype= compmodesubtype]
[devname = devicename]
.
.
mpath (mp) path = devicepath
[id = productid]
[pmgr = managername]
[lmgr = managername]
[pmgrpri = managerpriority]
[maxios = maxconcurrentchannelI/Os]
mvol (mv) vname = volumename
[newname = newvolumename]
[ldev = logicaldevice#]
[transient = %ofdiscfortransientobjects]
[permanent = %ofdiscforpermanentobjects]
[vclass = volumeclass]
|
To view the syntax for a specific I/O configurator command, enter HELP
commandname at the I/O configurator prompt. For example, to
get information about the ADEV command, you would enter
HELP ADEV. Example 5-4 I/O Configurator Command HELP Output
io>HELP ADEV
adev (ad) ldev = #/#,#,...
path = devicepath
id = productid
[rsize = recordsize]
[outdev = outputdevice]
[mode = JOB|DATA|INTERACTIVE| DUPLICATIVE|
INPUT|OUTPUT|AUTOREPLY|NLIO|NONE]
[class = classname,...|NONE]
[cmode = IN|OUT|CIO|NCIO|RANDOM|
DEFAULT]
[pmgr = physicalmanagername]
[lmgr = logicalmanagername]
[pmgrpri = physicalmanager priority]
[mpetype = compmodetype]
[mpesubtype= compmodesubtype]
[devname = devicename]
io>
|
Using I/O Configurator commands |  |
The I/O configurator commands let you list, modify, add, and delete four
types of objects: classes, devices, paths, and volumes. You can also use
the I/O configurator to modify addresses with the MADDRESS command.
In addition to these specific functions, the I/O configurator includes the
commands that are common to all SYSGEN configurators: CLEAR, EXIT,
HELP, HOLD, and OCLOSE. Table 5-1 IO Configurator Command Matrix | List | Modify | Add | Delete |
---|
Class | LCLASS | MCLASS | ACLASS | DCLASS | Device | LDEV | MDEV | ADEV | DDEV | Path | LPATH | MPATH | APATH | DPATH | Volume | LVOL | MVOL | AVOL | DVOL | Address | | MADDRESS | | |
Viewing the current configuration |  |
To get information about the current configuration, either
displayed on screen or printed, using the LCLASS, LDEV,
LPATH, and LVOLcommands as described in the following
table. Table 5-2 I/O Configurator List Commands Command | Definition | Examples |
---|
LCLASS | Lists the class name or names you specify with the
command, the class modes, and the devices associated with the classes
in the I/O configuration. A class name is an identifier to which numerous
devices can be assigned. Unlike LDEV numbers, device class names are
not unique to each device. For example, all of your system's printers could
be assigned the class name LP. (LP, which stands for "line printer,"
is a common device class name.) For more information, refer to the
Controlling System Activity (32650-90155). It provides detailed information about device class names,
their modes of operation, and how they are assigned in the system. | LCLASS DISC LCLASS (DISC,LP)
| LDEV | Lists the attributes of the specified logical device or
devices. If you omit the LDEV number, all of the I/O devices and their
characteristics are listed. Each configured logical device (LDEV) has
a uniquely assigned LDEV number which identifies a physical device
associated with a system. | LDEV CLASS=(LP,EPOC) LDEV (4/9,11/14) | LPATH | Lists information about the adapters and I/O devices on
a specified path level. You can list a specific path, list paths a
specific level, or list all paths associated with an I/O manager. | LPATH PATH=4 LPATH,1 LPATH MANAGER=CIPER_DM | LVOL | Lists the attributes of the specified volume, which is one disk
pack. Each volume is a member of a volume set and contains a volume
label, a label table, and a free space map. When you enter the LVOL
command for a specific volume, you will see the volume's LDEV number,
the amount of transient and permanent space it has, its class status, and the
volume class it belongs to. | LVOL MEMBER1 |
Printing the configuration informationYou can use the OFFLINE option to send the output of the listing
commands, LCLASS, LDEV, LPATH or LVOL, to the file
SYSGLIST. Using OFFLINE does not immediately generate printed
output. The information is sent to SYSGLIST until you either enter
the OCLOSE command or exit SYSGEN. Exiting SYSGEN or using
OCLOSE closes SYSGLIST and prints the file. For example, to print information about all devices with device class
DISC and LP on your system, do the following: At the I/O Configurator prompt (>io) enter:
io>LCLASS (DISC,LP) DEST=OFFLINE
|
Or, you can enter the command this way:
io>LCLASS (DISC,LP) OFFLINE
|
To close the file SYSGLIST and print the information, enter
Sample configuration dataBelow is an example of the kind of information you might see if
you entered the LDEV command, without additional parameters, at
the I/O configurator prompt on a Series 925 system. Example 5-8 Listing Configured Devices: Series 925 System
io>LDEV
LDEV: 1 DEVNAME: OUTDEV: 0 MODE:
ID: HP7937H RSIZE: 128 DEVTYPE: DISC
PATH: 4.1.0 MPETYPE: 3 MPESUBTYPE: 10
CLASS: DISC SPOOL
LDEV: 2 DEVNAME: OUTDEV: 0 MODE:
ID: HP7937H RSIZE: 128 DEVTYPE: DISC
PATH: 4.1.1 MPETYPE: 3 MPESUBTYPE: 10
CLASS: DISC SPOOL
LDEV: 3 DEVNAME: OUTDEV: 0 MODE:
ID: HP7937H RSIZE: 128 DEVTYPE: DISC
PATH: 4.1.2 MPETYPE: 3 MPESUBTYPE: 10
CLASS: DISC SPOOL
LDEV: 4 DEVNAME: OUTDEV: 0 MODE:
ID: HP7937H RSIZE: 128 DEVTYPE: DISC
PATH: 4.1.3 MPETYPE: 3 MPESUBTYPE: 10
CLASS: DISC SPOOL
LDEV: 6 DEVNAME: OUTDEV: 0 MODE:
ID: HP2566A RSIZE: 66 DEVTYPE: LP
PATH: 4.5.6 MPETYPE: 32 MPESUBTYPE: 9
CLASS: LP
LDEV: 7 DEVNAME: OUTDEV: 0 MODE:
ID: HP7980A RSIZE: 128 DEVTYPE: TAPE
PATH: 4.5.3 MPETYPE: 24 MPESUBTYPE: 5
CLASS: TAPE
LDEV: 10 DEVNAME: OUTDEV: LP MODE: JA
ID: HP7980A RSIZE: 128 DEVTYPE: TAPE
PATH: 4.5.4 MPETYPE: 24 MPESUBTYPE: 5
LDEV: 20 DEVNAME: OUTDEV: 20 MODE: JAID
ID: HP2392A RSIZE: 40 DEVTYPE: TERM
PATH: 4.2.0 MPETYPE: 16 MPESUBTYPE: 0
CLASS: CONSOLE
LDEV: 100/111 NMMGR
io>
|
Adding Objects in SYSGEN |  |
When you use SYSGEN to add objects to the system configuration, there are
four I/O Configurator commands available: ACLASS, ADEV, APATH
and AVOL. They are defined in the table below. For more detailed
information read Performing System Manager Tasks (32650-90004). Table 5-3 I/O Configurator Add Commands Command | Definition | Examples |
---|
ACLASS | Creates a new class name and associates devices to the new
class. You use the ACLASS command to add a class name designation to
a device that is already configured with the ADEV command. You also
specify the mode with this command, which can be one of JOB (accepts
jobs and sessions), IN (input only), OUT (output only), CIO
(concurrent I/O), NCIO (nonconcurrent I/O), RANDOM (direct-access
device such as a disk), and DEFAULT (a mode assigned when the system
is initialized). | ACLASS EPOC 19 ACLASS PLATES 31/34 MODE=RANDOM | ADEV | Adds a device to an existing I/O path that is configured to
the device adapter level. At a minimum, you must specify the LDEV, the
path, and ID number, but you may also specify the record size, an output
device associated with the device, the device operation mode, the class,
a class mode (other than the default assigned to the device), physical and
logical device managers, the priority level of the physical device manager,
the compatability mode type and subtype,and a device name. | ADEV LDEV=30 PATH=4.5.9 ID=HP2688A ADEV 8 PATH=2/4.2.1 ID=HP7978B RSIZE=132 | APATH | Defines the I/O path to an adapter, not to a device. (To add
device level paths, you use the ADEV command.) If the path has already
been defined, you will get an error. At a minimum, you must enter the
path and an ID, which is either the Hewlett-Packard product number or
a mnemonic name that designates different uses of the same product. You
may also specify the physical and logical device managers, the execution
priority of the physical device manager, and the maximum number of
concurrent I/Os to expect. | APATH PATH=4.2 ID=HP27113A | AVOL | Adds a new volume to the system volume set configuration.
You must specify a unique name you give to each volume
member and its logical device number. In addition, you may also
specify the volume class and the amounts of transient and permanent
disk space allocated on the volume. | AVOL VNAME=MEMBER2 LDEV=4
VCLASS=PROD |
You use the NMMGR program to add non-local devices
such as terminals, serial printers, UPS hardware and other objects
to a system. To learn how to configure UPS devices, read
“Introducing the UPS and UPS Monitor/iX Software” later in
this chapter. To learn how to use NMMGR to configure other
devices, read Configuring Systems for Terminals, Printers, and Other Serial Devices (32022-61000). Changing Configurations in SYSGEN |  |
When you use SYSGEN to change the system configuration, there are five
I/O Configurator commands available: MADDRESS, MCLASS, MDEV,
MPATH, and MVOL. They are defined in the table below and
explained in the following sections. Table 5-4 I/O Configurator Modify Commands Command | Definition | Examples |
---|
MADDRESS | Modifies the I/O path from one that exists to a new path
that does not already exist. You specify the old path and the new path, both
of which must have the same number of levels. | MADDRESS 2/4.0.2 6/4.0.3 | MCLASS | Changes I/O class information including the class mode, the
class name, and the devices associated with the class. | MCLASS CLASS
LP NEWCLASS=BIGPRN MODE=OUT MCLASS BONSAI SMALLPRN 28/29 | MDEV | Changes the attributes of a configured device. You specify the
LDEV number of the device you want to modify, then enter the new paramaters.
This commands changes the LDEV number itself, the device ID, the device path,
class, mode, record size, physical and logical device manager, the
compatability mode type and subtype, and the device name. | MDEV 8 18 HP7978H 4.3.0 MODE=JOB | MPATH | Changes the attributes of an I/O path. You can modify the
path name, the product ID, the physical and logical device managers, the
execution priority of the physical device manager, and the maximum number of
concurrent I/Os to expect. | MPATH 4.1 HP27113A MPATH 2/4.3 PMGR=HPIB_DAM | MVOL | Modifies the attributes of a volume set member. You can
modify the volume name, volume class and the amounts of transient and permanent
disk space allocated on the volume. | AVOL VNAME=MEMBER2 TRANSIENT=30
PERMANENT=70 |
Deleting Objects in SYSGEN |  |
When you use SYSGEN to delete objects from the system configuration,
there are four I/O Configurator commands available to you: DCLASS,
DDEV, DPATH, and DVOL. They are defined in the table below
and explained in the following sections. Table 5-5 I/O Configurator Delete Commands Command | Definition | Examples |
---|
DCLASS | Removes one or more class names from the system.
If the class does not exist, or if you attempt to delete the DISC,
CONSOLE, or TAPE classes, SYSGEN displays an error message. | DCLASS EPOC DCLASS (EPOC,FASTLP) | DDEV | Removes a specific device, range of devices, all
products of a given product identification, all devices of a given type,
or all devices of a given class name. You cannot delete the system disk
(LDEV 1) or the system console (LDEV 20). | DDEV LDEV=123 DDEV ID=HP2932A | DPATH | Deletes an I/O path and, optionally, all the I/O paths
below it in the configuration. If there are I/O paths below the one
you are deleting, SYSGEN prompts you to confirm the action before
deleting them. If an I/O path is currently used by a configured device,
SYSGEN issues an error and does not delete the path.
| DPATH 4.2 DPATH 2/8.2 | DVOL | Deletes a volume member from the system configuration.
To implement the change, you must create a system load tape with the
new configuration and then use it to do an INSTALL. | DVOL MEMBER2 |
Changing the configuration online |  |
A new command file, DOIONOW, has been added to MPE/iX which allows the
system manager to immediately implement device configuration changes
made with SYSGEN. This command allows you to keep the system online
and available to users more of the time, and gives you the flexibility to change
the configuration on an "as needed" basis. To change the configuration while the system is online, do the following: Make the necessary changes to the configuration with the
I/O Configurator. (This process is no different than it was before;
for more information, read the previous section of this chapter
"Using SYSGEN's I/O Configurator". Keep the configuration changes and exit SYSGEN. The information
is saved in the file LOG4ONLN.PUB.SYS, which is used by
the DOIONOW command. At the CI prompt, execute the DOIONOW command by entering: DOIONOW passes the LOG4ONLN file, which contains the new configuration
information, to IOCONFIG, which begins making the changes. If LOG4ONLN is
not found, you will see the following error message displayed on the console:
NO PENDING SYSGEN CONFIG CHANGES
|
The DOIONOW command creates a log file, ONLNOLOG.PUB.SYS, which is
used to record the commands executed by IOCONFIG. If the DOIONOW
command generates an error, you may view this same log file to determine the
cause. This log file is purged and a new one is created prior to invoking
the new configuration, which means that it only contains information for the
last execution of IOCONFIG. Once you have found the problem, you can then
edit the input file for the DOIONOW command, LOG4ONLN.PUB.SYS, to avoid
duplicating the events that created the error.
|