 |
» |
|
|
 |
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 in Example
5-1. 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 Example 5-2. Example 5-2 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. Refer to Example
5-3, to get information about the ADEV command, you would enter HELP ADEV. Example 5-3 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 the specific functions, shown
in Table 5-1 “I/O Configurator Command Matrix”, the I/O configurator includes the
commands that are common to all SYSGEN configurators: CLEAR, EXIT, HELP, HOLD, and OCLOSE. Table 5-1 I/O 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 LVOL commands as described in Table 5-2 “I/O Configurator List Commands”. 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. 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 PAT=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 DataExample 5-4 shows the kind of information you might see if
you entered the LDEV command, without additional parameters, at the I/O configurator
prompt on an N-Class system. Example 5-4 Listing Configured Devices: N-Class System io> ld LDEV: 1 DEVNAME: OUTDEV: 0 MODE: ID: ST39103LC RSIZE: 128 DEVTYPE: DISC PATH: 0/0/2/0.6.0 MPETYPE: 4 MPESUBTYPE: 2CLASS: DISC SPOOL LDEV: 2 DEVNAME: OUTDEV: 0 MODE: ID: ST39103LC RSIZE: 128 DEVTYPE: DISC PATH: 0/0/2/1.6.0 MPETYPE: 4 MPESUBTYPE: 2CLASS: DISC SPOOL LDEV: 6 DEVNAME: OUTDEV: 0 MODE: ID: LP_PP_ID RSIZE: 66 DEVTYPE: PP PATH: 0/0/1/0.16.0 MPETYPE: 32 MPESUBTYPE: 6CLASS: LP PP LDEV: 7 DEVNAME: OUTDEV: 0 MODE: ID: HPC1553A RSIZE: 128 DEVTYPE: TAPE PATH: 0/0/1/0.6.0 MPETYPE: 24 MPESUBTYPE: 7CLASS: TAPE TAPE2 DDUMP TAPE1 LDEV: 10 DEVNAME: OUTDEV: LP MODE: JA ID: JOBTAPE_ID RSIZE: 128 DEVTYPE: TAPE PATH: 0/0/1/0.17.0 MPETYPE: 24 MPESUBTYPE: 2CLASS: JOB JOBTAPE LDEV: 20 DEVNAME: OUTDEV: 20 MODE: JAID ID: C1099A RSIZE: 40 DEVTYPE: TERM PATH: 0/0/4/0.0 MPETYPE: 16 MPESUBTYPE: 0CLASS: CONSOLE TERM 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 Table 5-3 “I/O Configurator Add Commands”.
For more detailed information read Performing System
Manager Tasks. 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. 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 Table 5-4 “I/O Configurator Modify Commands” 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 parameters. This commands changes the LDEV number
itself, the device ID, the device path, class, mode, record size,
physical and logical device manager, the compatibility mode type
and subtype, and the device name. | MDEV 8 18 HP7978H 4.3.0 MODE=JOB | MPAT | 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. | VOL 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 Table 5-5 “I/O Configurator Delete Commands” 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 PATH 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.
|