Using SYSGEN's I/O Configurator

You can use the I/O configurator to display information about the current system configuration and to make any necessary changes to it. To access the I/O configurator, do the following:

At the MPE prompt, start SYSGEN by entering:
:SYSGEN
At the SYSGEN prompt (sysgen>), enter:
sysgen>IO

First you see a list of the commands available to you. To issue a command, you can enter either the full command name or the abbreviation shown in parentheses.

Figure 3-1 Example 3-1. Entering the I/O Configurator

   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>

You can display helpful information about any of the I/O Configurator commands on the screen. To do so, enter the HELP command at the io> 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 APATH command, enter:
io>HELP APATH
To see a list of all the I/O Configurator commands with a brief description of each one, simply enter HELP or H.

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.

Command	Definition
`LCLASS`	Lists the specified class names and the devices assigned to each one.
`LDEV`	Lists the attributes of the specified logical devices.
`LPATH`	Lists the attributes of the specified paths.
`LVOL`	Lists the attributes of the specified volume set member.

To list device classes

A class name is an identifier to which numerous devices can be assigned. Unlike logical device 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, which stands for "line printer."

To list a class name, at the I/O Configurator prompt (io>), enter:

   io>LCLASS parameters

LCLASS has the following parameters:

LCLASS (LC) [ [CLASS =] classname,...] [ [DEST =] OFFLINE]

The following list briefly explains how to use the LCLASS command and provides examples.

Use this command: To do this
LCLASS: List all class names, class modes, and the devices associated with the classes in the I/O configuration.
LCLASS classname: List the logical devices (LDEVs) that belong to a particular device class. For example, to see all LDEVs in the device class DISC, enter LCLASS DISC.
LCLASS (classname, classname): List multiple classes. Enclose each class name in parentheses and separate them with commas. For example, to list the assigned LDEV numbers of combined classes DISC and LP, enter LCLASS (DISC,LP):

To list devices

Each configured logical device (LDEV) is assigned a unique LDEV number which identifies a physical device associated with a system. Use the LDEV command (abbreviated LD) to list the characteristics of the I/O devices configured for your system. You can list all devices, a subset of them, or a specific device.

To list the devices on your system, at the I/O Configurator prompt (io>), enter:

   io>LDEV parameters

The LDEV command has the following parameters:

LDEV (LD) [[LDEV =] devicerange ] [ [ID =] productnumber ] [ [TYPE =] devicetype ] [ [CLASS =] classname,... ] [ [DEST =] OFFLINE ]

The following list briefly explains how to use the LDEV command and provides examples.

Use this command: To do this
LDEV: List the characteristics of all of the I/O devices currently configured.
LDEV ldev: List one or more specific devices. To see information about more than one device, separate the device numbers with a comma. For example, to list LDEV 38 and LDEV 39, enter LDEV LDEV=38,39
LDEV ldev/ldev: List a range of devices. Enter the first device number and the last device number separated by a slash. For example, to list devices 4 through 9, enter LDEV 4/9.
LDEV (ldev/ldev, ldev/ldev): List a nonconsecutive range of devices. Separate each range with a command and enclose them in parentheses. For example, LDEV (4/9,11/14).
LDEV CLASS=(classname, classname): List all devices within a particular class or a set of classes. For example, to list all line printers (the class LP) and disk drives (the class DISC) on your system, enter LDEV CLASS=(LP,DISC)
LDEV ID=IDnumber: List all devices on your system that have a particular product ID. For example, LDEV ID=HP2566A.
LDEV TYPE=typename: List all devices of a particular type. For example, to see DISC devices, enter LDEV TYPE=DISC. Note that SYSGEN displays only the LDEV number for NMMGR devices. An asterisk (*) after the LDEV number means the path conflicts with NMMGR. Refer to System Startup, Configuration, and Shutdown Reference Manual (32650-90042) for more information on conflicts between NMMGR and SYSGEN.

To list paths

Use the LPATH command to display information about the adapters and I/O devices on a specified path level. LPATH lists the configured I/O paths according to their path, hierarchy level, or associated I/O manager.

To display I/O path information, at the I/O Configurator prompt (io>), enter:

   io>LPATH parameters

LPATH has the following parameters:

LPATH (LP) [ [PATH =] path] [ [LEVEL =] #] [ [MANAGER =] managername,...] [ [DEST =] OFFLINE ]

The following list briefly explains how to use the LPATH command and provides examples.

Use this command

To do this

LPATH

List all configured paths. When you enter LPATH with no parameters, you will see all of the device-dependent information associated with a given I/O path which includes:

the ID of the device assigned to that path level
the logical and physical manager names
the device type

LPATH PATH=pathnumber

List a specific path. For example, to see path 4, enter LPATH PATH=4 Note that if you are using a Series 950 through Series 980 system, you must use a slash (/) to separate the bus converter number from the rest of the path identification. Otherwise, SYSGEN issues a warning message.

LPATH pathlevel

List I/O paths at a given level. For example, to see the devices at level 1, enter LPATH,1. The level number used in the LEVEL parameter corresponds to the number of delimited digits in the path displayed. For the Series 950 through Series 980 systems, the path 6/4.3.0 has 6 as the bus converter, 4 as the channel adapter, 3 as the device adapter, and 0 as the device. For the Series 925 through Series 949 systems, the path 4.2.0 has 4 as the channel adapter, 2 as the device adapter, and 0 as the device.

LPATH MANAGER= mngr

List the I/O paths associated with a specific device manager under the heading PMGR or LMGR. If the manager you specify in the LPATH command doesn't exist, SYSGEN issues a warning.For example, LPATH MANAGER=CIPER_DM.




	NOTE: If you are working with a Series 922 or Series 932 system, including the LX and RX models, refer to HP 3000 Series 922 Family Computer Systems/Operator Hand book (A1027-90019).

To list volumes

A volume 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. To list volumes, at the I/O Configurator prompt (io>), enter:

   io>LVOL

LVOL has the following parameters:

LVOL (LV) [[VNAME =] volumename, [ volumename] [...] ] [ [DEST = ] ''OFFLINE'']

The following list briefly explains how to use the LVOL command and provides examples.

Use this command: To do this
LVOL: List volume information for all volumes.
LVOL volumename: List the LDEV number, the amount of transient and permanent space, the class status, and the volume class of a member volume. For example, to see information about the volume MEMBER1, enter LVOL MEMBER1.

To print configuration information

Each of the commands that you use to list configuration information has a DEST=OFFLINE parameter that allows you to print the information instead of displaying it on the console. This parameter is useful when you need to compare one configuration to another or, for example, when you want to enclose a printed copy of the configuration with the system load tape (SLT).

To print configuration data, enter one of the list commands (LCLASS, LDEV, LPATH or LVOL), any additional parameters you need, followed by the parameter OFFLINE. This sends the listing to the file SYSGLIST. To close and print the list, you use the OCLOSE command or exit the I/O Configurator.

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
io>OCLOSE

Configuring Devices with SYSGEN

There are two general categories of devices that you configure on your computer system, local devices and non-local devices.

Local devices are "hard-wired" or connected via parallel cables to your computer. These include tape and disk drives and some printers. You configure local devices with SYSGEN's I/O Configurator. You may also configure I/O devices with the IOCONFIG utility, explained later in this chapter.
Non-local devices are connected via Datacommunication and Terminal Controllers, or DTCs. These include terminals, PCs in terminal emulation mode, serial printers and Uninterruptible Power Supply (UPS) units. You configure non-local devices with the Node Management Services Configuration Manager (NMMGR) program.

This section explains how to configure local devices with SYSGEN's I/O configurator. It also explains how to configure UPS devices (which are non-local devices) and how to use the UPS Monitor/iX software. For more information about using NMMGR to configure all other non-local devices, read Configuring Systems for Terminals, Printers, and Other Serial Devices (32022-90001).

To identify local devices to the system

There are certain attributes of local devices that you are required to configure because they identify the device to the system. These include the device identification number (ID), the I/O path, and the logical device number (LDEV).

The device identification is the product identification number (for example HP7978B or HP2563A) of the device you are adding. The file IODFAULT.PUB.SYS contains configuration information for all devices supported by Hewlett-Packard. If your product ID number is not listed in this file, you may wish to contact your customer engineer. For nonsupported devices, the ID is always USER and you must specify all attributes except class, class mode and device name.
An I/O path is the system address assigned to the device interface hardware and software and the physical path used to reach an I/O device. To add, change, or delete a path, you must correctly identify the applicable device adapter interfaces and their associated I/O devices.
At system power ON or RESET, the processor-dependent code (PDC) and I/O-dependent code (IODC) hardware routines read and initialize the I/O paths to boot or reboot the system. The I/O paths that the system uses to load itself from disk or tape are referred to as boot paths.
For more information about I/O paths, refer to the System Startup, Configuration, and Shutdown Reference Manual (32650-90042).
Each configured device is identified by a unique logical device number, or LDEV. You assign logical device numbers to all system devices except LDEV 1 (which is always the system master disk) and LDEV 20 (which is always the console).

To configure default device attributes

There are additional attributes for local devices that you can or must leave set to the default. They include device type, associated output device, device mode and device class, which are described next. A number of other attributes that you can configure are explained throughout this chapter.

A logical device is identified by its type, which you cannot change. Device types names are standardized, and each logical device may be only one type. Be careful not to confuse type with class.
Standard device types are:
DISC
disk drives
TAPE
tape drives
TERM
terminals
LP
line printers
PP
page printers
AC
autochanger
The output device tells where output from a device goes. It is either a logical device (LDEV) number or a device class. Only devices that can accept HELLO, JOB or DATA logons require an output device.
For the console and terminals, the output device is the same as its LDEV. All terminals are both input and output devices and are referred to by one LDEV number. For the job tape (or streams device), the output device is usually LP. For printers and disks, the output device is zero.
An I/O device may operate in one or more modes such as JOB (which means it accepts job and session logons) or INPUT (which means that input to the device is spooled).
The device class is a name used to identify a group of devices by location (for example, BLDG2) or ownership (for example, FINANCE). They can also be used to call for a device when you do not know an LDEV number or when it is okay to use any device in that class. (For example, you can specify the printer class BONSAI if you want a report printed on any HP 2688A printer.)
A device can simultaneously belong to as many as eight classes. If you specify a class name that does not exist, it is assigned default characteristics. Some functions require a device in specific classes.

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 and explained in the following sections.

Command	Definition
`ACLASS`	Creates a new class name and associates devices to the new class.
`ADEV`	Adds an I/O device to the system.
`APATH`	Defines the I/O path to an adapter. The path must not have already been defined.
`AVOL`	Adds a new volume to the system volume set configuration.




	NOTE: 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-90001).

To add a class name

Use the ACLASS command (abbreviated AC) to add a class name designation to a configured device. You must use the ADEV command to add the device path and designate the LDEV number before using the ACLASS command. To add a class name, at the I/O Configurator prompt (io>), enter:

   io>ACLASS classname ldev parameter

ACLASS has the following parameters:

ACLASS (AC) {[CLASS =] classname,...} {[LDEV =] #/#,#,...} [[MODE = ] { IN OUT CIO NCIO RANDOM DEFAULT }]

The CLASS and LDEV parameters are required and classname is a standard class name of up to eight characters, such as EPOC or SPOOL. If the specified class name already exists when you attempt to add it, SYSGEN issues an error message.

The modes are defined in the following table.

Mode	Definition
`JOB`	Accepts `HELLO` and `JOB` logons.
`IN`	Input only device
`OUT`	Output only device
`CIO`	Concurrent I/O
`NCIO`	Nonconcurrent I/O
`RANDOM`	Direct-access device (for example, disk)
`DEFAULT`	Assigned at system initialization

To add a class name, enter the ACLASS command, the class name, and the LDEV associated with it. For example, to add the class name EPOC and associate it with LDEV 19, enter:

   io>ACLASS EPOC 19

To assign a mode to a device

You can assign a mode to the device or accept the default mode assigned by SYSGEN. To assign a mode, enter the ACLASS command, the class name, the LDEVs, and the keyword or positional MODE parameter. For example, to assign the mode RANDOM to logical devices 31 through 34 (using keyword parameters), enter:

   io>ACLASS PLATES 31/34 MODE=RANDOM

To assign the same mode using positional parameters enter:

   io>ACLASS PLATES 31/34 RANDOM

To add devices

Each device configured on your system must have a unique LDEV number. Although you, as system manager, assign LDEV numbers to system devices at your discretion, certain devices must be assigned specific numbers. For example, to boot the operating system from disk, you must mount the system master volume on LDEV 1 and the system console is always LDEV 20.

Use the ADEV command (abbreviated AD) to add 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. You can enter other information either using keywords or positional parameters.

To add a device, at the I/O Configurator prompt (io>), enter:

   io>ADEV ldev pathid otherparameters

ADEV has the following parameters:

ADEV (AD) { [LDEV =] #/#,#,...} { [PATH =] devicepath} { [ID =] productid} [ [RSIZE =] recordsize] [ [OUTDEV =] outputdevice] [[MODE =] { JOB DATA INTERACTIVE DUPLICATIVE INPUT OUTPUT AUTOREPLY NLIO NONE }] [ [CLASS =] classname] [[CMODE =] { IN OUT CIO NCIO RANDOM DEFAULT }] [ [PMGR =] physicalmanagername] [ [LMGR =] logicalmanagername] [ [PMGRPRI =] physicalmanager priority] [ [MPETYPE = ] compmodetype] [ [MPESUBTYPE = ] compmodesubtype] [ [DEVNAME = ] devicename]

Below are two examples of adding LDEV 30 to the Series 925 through Series 935 systems. The first example uses keyword parameters, the second uses positional parameters:

   io>ADEV LDEV=30 PATH=4.5.9 ID=HP2688A



   io>ADEV 30 4.5.9 HP2688A

Below are two examples of adding LDEV 30 to the Series 950 through 980 systems. The first example uses keyword parameters, the second uses positional parameters:

   io>ADEV LDEV=40 PATH=2/8.1.4 ID=HP7935H



   io>ADEV 40 2/8.1.4 HP7935H

To specify the LDEV, PATH, and ID

When you issue the ADEV command, you must specify the LDEV, PATH, and ID parameters.

Use LDEV to specify the logical device number for the device you are adding.
Use PATH to specify the physical path to reach a device.
Use ID to specify the device you are adding.

For example, to add an HP2688A printer as LDEV 17 (using keyword parameters), enter:

   io>ADEV LDEV=17 PATH=4.3.2 ID=HP2688A

Or, to add an HP7978B disk drive as LDEV 30 (using positional parameters), enter:

   io>ADEV 30 2/8.1.4 HP7978B

If a specified LDEV already exists, SYSGEN issues an error message. If you specify a set of devices, the device number in the PATH parameter increases automatically.

You can add either a Hewlett-Packard supported device or a device of another kind.

If you are adding a Hewlett-Packard-supported device, enter the product ID (for example, HP7978A) as the ID parameter value. For a complete list of Hewlett-Packard supported devices, read the file IODFAULT.PUB.SYS.
If you are adding a device that is not supported by Hewlett-Packard, enter USER as the product ID. For non-supported devices, you must specify all of the device attributes except class, class mode (CMODE), and device name, which are optional. For example, to configure a nonsupported device as LDEV 40, enter:
io>AD 40 36.1.4 USER 132 10 OUTPUT LP DEFAULT& USER_PHYS_MGR USER_LOGICAL_MANAGER PMGRPRI=8& MPETYPE=value MPESUBTYPE=value

To specify the RSIZE

The RSIZE parameter specifies the record size (in 16-bit words) of the device you are adding. For example, to add an HP7978B as LDEV 8 with the path 2/4.2.1 and a record size of 264 characters, enter:

   io>ADEV 8 PATH=2/4.2.1 ID=HP7978B RSIZE=132

If you do not specify the record size parameter, SYSGEN uses the default.

To specify the OUTDEV

The OUTDEV parameter specifies the output device associated with the device you are adding. For example, to add an HP2688A printer as LDEV 19 on path 4.1.7 with a record size of 132 characters and LP as the output device, enter:

   io>ADEV 19 4.1.7 HP2688A 66 OUTDEV=LP

The OUTDEV can be either a device number or a device class. If you do not enter this parameter, SYSGEN assigns 0 as the output device for all peripherals except terminals, which are assigned the input device number.

To create a streams device

The streams device is the device that accepts batch jobs. To configure the streams device, you must issue the ADEV command once with a specific set of options: MODE=(JOB,DATA)and OUTDEV=[an output device or class]. For example, if you choose class LP for OUTDEV, enter:

   io>ADEV 10 2/4.2.3 HP7978B MODE=(JOB,DATA) OUTDEV=LP&

   RSIZE=128 CLASS=JOBTAPE

You can also use the intrinsic HPDEVCREATE to create a streams file. The parameters you enter, such as device file type, LDEV, major number, minor number and link name, define the file. For more information, read MPE/iX Intrinsics Reference Manual (32650-90028).

To specify the MODE

The MODE parameter specifies the device operation mode. Your choices for mode and their meanings are defined below:

Value	Definition
`JOB`	Accepts `HELLO` and `JOB` logons.
`DATA`	Accepts `DATA` logons.
`INTERACTIVE`	Refer to the `FRELATE` intrinsic explanation.
`DUPLICATIVE`	Refer to the `FRELATE` intrinsic explanation.
`INPUT`	Input spooled.
`OUTPUT`	Output spooled.
`AUTOREPLY`	Automatically replies to tapes (also called autoallocation).
`NLIO`	This device is capable of native language I/O.
`NONE`	None of the above apply.

Most devices have a default device mode listed in the ASCII file IODFAULT.PUB.SYS, which you can read. To override the default, you can specify NONE as the mode.

Certain devices can have one or more modes only. For example, an HP 7978B tape drive can have the modes: JOB, DATA, INPUT, OUTPUT, AUTOREPLY, and NONE.

Since MODE is a repeated parameter, you can specify multiple modes by using parentheses and separating the modes with commas or spaces. For example, to assign two modes, AUTOREPLY and INPUT to an HP7978B tape drive, enter:

   io>ADEV 40 4.1.7 HP7978B MODE=(AUTOREPLY,INPUT)

If you assign an improper mode to a device, SYSGEN issues an error message. For example, you cannot assign a printer the device mode AUTOREPLY.

To specify the CLASS

The CLASS parameter associates a group of devices (which are usually related logically or physically) to a class name. For example, to specify the class TAPE for an HP7978B tape drive, enter:

   io>ADEV 40 4.1.7 HP7978B MODE=AUTOREPLY CLASS=TAPE

A device can simultaneously belong to as many as eight classes. Class names may not exceed eight characters and must begin with an alphabetic character.

If a specified class name does not exist, SYSGEN assigns it the device access characteristics of DEFAULT, which you can override using the CMODE parameter, described below.

To assign no class to a device, specify CLASS=NONE.

To specify the CMODE

The CMODE parameter overrides the default class mode for a device. For example, to make all HP7978B tape drives that you are adding to your system output devices only, enter:

   io>ADEV 40 4.1.7 HP7978B CLASS=TAPE CMODE=OUT

If the class already exists, the CMODE entry is ignored.

The values for the CMODE parameter are defined in the table below.

Value	Definition
`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 specify the PMGR

The PMGR parameter associates the physical device manager with a specified I/O path. The manager name has a maximum length of 32 characters and may contain numbers, letters, and underline (_) characters. If you do not enter this parameter, SYSGEN uses the default.

For example, to specify BUS_CONV_MGR as the physical device manager, enter:

   io>ADEV 40 4.1.7 HP7978B CLASS=TAPE PMGR=BUS_CONV_MGR

To specify the LMGR

LMGR is the name of the logical device 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 do not enter this parameter, SYSGEN uses the default.

For example, to specify LOGICAL_DEVICE_MANAGER as the logical device manager, enter:

   io>ADEV 40 4.1.7 HP7978B CLASS=TAPE&

   LMGR=LOGICAL_DEVICE_MANAGER

To specify the PMGRPRI

The PMGRPRI parameter specifies the priority level at which the physical device manager executes. The priority can range from 1 (the lowest level) to 15 (the highest.) If you don't specify a priority, SYSGEN uses the default.

For example, to specify a priority level of 5 for logical device 40, enter:

   io>ADEV 40 4.1.7 HP7978B CLASS=TAPE PMGRPRI=5

To specify the MPETYPE and MPESUBTYPE

The MPETYPE and MPESUBTYPE parameters specify values for compatibility mode type and subtype. You use them when you are adding a nonsupported device to your configuration. For example, to add a non-Hewlett-Packard printer as LDEV 40, enter:

   io>AD 40 36.1.4 USER 132 10 OUTPUT LP DEFAULT&

   USER_PHYS_MGR USER_LOGICAL_MANAGER PMGRPRI=8&

   MPETYPE=value MPESUBTYPE=value

To specify the DEVNAME

The DEVNAME associates a device name with a particular LDEV number, which allows a user to specify the device by name instead of by number. When choosing device names, remember the following rules:

A device name must begin with a letter.
You cannot use a device name of exactly eight characters that begins with the letter "D" followed immediately by one or more digits.
You cannot use the name "VTERM."
No two logical devices may have the same device name.
All device names and class names must be mutually exclusive.

For example, to specify the device name TAPEDRIVE for an HP7978B, enter:

   io>ADEV 40 4.1.7 HP7978B DEVNAME=TAPEDRIVE

To create device link files

A device link is, essentially, a permanent, named :FILE command that associates a name with an LDEV. Once created, device links are represented as files and ar visible in directories. Device link files give the MPE/iX shell, the UNIX-like command shell and utilities introduced with Version 4.5 of the operating system, access to devices such as tape drives and printers so that it does not have to know MPE access semantics. As a result, MPE/iX shell utilities such as tar work like their UNIX counterparts.

To create a device link file, you can use the MKNOD utility. For example, to create a device link file called tape7 in the current directory, enter:

   :mknod "tape7,c,0,7"

In this example, the first parameter is the device link file name (tape7), the second two parameters (c 0) are required to create device link files, and the fourth parameter (7) is the LDEV number for which you are creating the device link file.

To list the device link file you have created, use the LISTFILE command. For example, to list information about tape7, enter:

   :LISTFILE tape7,2

MPE/iX will respond with something like the following information. In the TYP column, BBd indicates that the device link file is a byte stream format, binary access device file.

 



   :listfile tape7,2

   ACCOUNT=  SYS         GROUP=  PUB



   FILENAME  CODE  ------------LOGICAL RECORD-----------  ----SPACE----

                     SIZE  TYP        EOF      LIMIT R/IB  SECTORS #X MX



   TAPE7             128W  BBd          0          1   1        0  0  *





   :

The file name that you enter follows MPE-escaped syntax rules. So, to create a device link file in a directory other than the current working directory, include the path in the file name. For example, to create the device link file tape7 in the dev directory, enter:

   :"/dev/tape7/c,0,7"




	NOTE: You may also use three other methods to create device link files: the mknod POSIX C-library function, the `HPDEVCREATE` intrinsic, or the MPE/iX shell utility mknod.

To configure tape drives for ejection and data compression

A new utility, DEVCTRL, allows you to dynamically configure 1/2 inch and DDS tape devices to eject the media following an application rewind or close. In addition, if you have an HPC1504B or HPC1521B DDS drive, you can enable or disable data compression so that the tapes can be created and shared with non-compressing DDS devices. (Note that the compression option does not apply to 1/2 inch tape.)

Once you use DEVCTRL to configure the drive, it remains configured in that way until you change it with DEVCTRL again. A powerfail or changes in device ownership do not reset the configuration.

DEVCTRL has the following parameters:

DEVCTRL { [LDEV =] ###} { [COMPRESSION =] enable/disable/nochange} { [EJECT =] enable/disable/nochange}

For example, to enable data compression and the eject feature for LDEV 50, enter:

   user>DEVCTRL 50 compression=enable eject=enable

Or, to enable compression but disable the eject feature (using positional parameters), enter:

   user>DEVCTRL 50 enable disable

To add paths

Use the APATH command (abbreviated AP) to add an I/O path to the system configuration. (To add device level paths, you use the ADEV command. For more information on hardware paths, refer to chapter 12.)

To add an I/O path, at the I/O Configurator prompt (io>), enter:

   io>APATH devicepath productid additional parameters

APATH has the following parameters:

APATH (AP) { [PATH =] devicepath} { [ID =] productid} [ [PMGR =] physicalmgrname] [ [LMGR =] logicalmgrname] [ [PMGRPRI =] physicalmgrpri] [ [MAXIOS =] maxconcurrentchannelIOs]

To specify the PATH and ID

You must specify the PATH and ID parameters with the APATH command. If you specify a path that already exists, an error occurs. The product ID is either the Hewlett-Packard product number or a mnemonic name that designates different uses of the same product.

For Series 925 through Series 949 systems and for Series 958 systems, you describe the path as follows:

the channel adapter
the channel adapter and device adapter separated by a period (such as 4.2)

For the Series 950 through Series 980 systems, you describe the path this way:

just the bus converter
just the channel adapter
the bus converter and channel adapter separated by a slash (such as 2/8)
the bus converter and channel adapter separated by a slash and the device adapter separated by a period (such as 2/8.2)

To specify the PATH and ID parameters using keywords and positional parameters, respectively, enter:

   io>APATH PATH=4.2 ID=HP27113A

   io>APATH 4.2 HP27113A

To specify the PMGR

The PMGR parameter is the name of the physical device manager associated with the specified I/O path. For example, to specify BUS_CONV_MGR as the physical device manager, enter:

   io>APATH PATH=4.2 ID=HP27113A PMGR=BUS_CONV_MGR

The manager name has a maximum length of 32 characters and may contain numbers, letters, and underline (_) characters. If you do not enter this parameter, SYSGEN supplies the default.

To specify the LMGR

LMGR is the name of the logical device manager associated with the specified I/O path. Not all devices have logical device managers. For example, to specify LOGICAL_DEVICE_MGR as the logical device manager using a combination of keywords and positional parameters, enter:

   io>APATH 2/8.2 HP27113A LMGR=LOGICAL_DEVICE_MGR

The manager name has a maximum length of 32 characters and may contain numbers, letters, and underline (_) characters. If you do not enter this parameter, SYSGEN supplies the default.

To specify the PMGRPRI

PMGRPRI is the priority level at which the physical device manager executes and can be between 1 (low) and 15 (high), inclusive. For example, to specify a PMGRPRI of 8, enter:

   io>APATH PATH=8.2 ID=HP27113A PMGRPRI=8

The I/O default file supplies this parameter if you do not.

To specify the MAXIOS

MAXIOS tells the device manager how many concurrent IOs to expect. For example, to specify 20 concurrent I/O devices, enter:

    io>APATH PATH=4.2 ID=HP27113A PMGRPRI=5 MAXIOS=20

Normally, you do not specify this value. Instead, the I/O default file usually specifies zero, which allows the manager to set itself to its default.

To add volumes

Use the AVOL command (abbreviated AV) to add a new volume to the system volume set configuration. To add a volume, at the I/O Configurator prompt (io>), enter:

   io>AVOL volumemembername ldev additional parameters

AVOL has the following parameters:

AVOL (AV) { [VNAME =]volumemembername} { [LDEV =]#} [ [TRANSIENT =]%discfortransobj] [ [PERMANENT =]%discforpermobj] { [VCLASS =]volumeclass}

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

To specify the VNAME, LDEV, and VCLASS

The VNAME parameter specifies the unique name you give to each volume member, LDEV specifies the logical device number, and VCLASS specifies the volume class(es) that the identified volume(s) belong to. The volume member name and the volume class must be 32 characters or less. After the first character, which must be alphabetic, numbers, letters, and underline characters are allowed. You may specify up to eight volume classes.

For example, to specify MEMBER2 as logical device 4 in the volume class PROD, enter:

   io>AVOL VNAME=MEMBER2 LDEV=4 VCLASS=PROD

To specify transient and permanent disk space

TRANSIENT is the amount of disk space that is reserved for temporary processes such as stacks and operating system data structures. PERMANENT is the amount of disk space that is reserved for permanent structures such as files, the label table, a tape drive, a disk drive, or a printer. You enter both values as a percentage.

For example, to specify the amount of disk space reserved for transient and permanent objects as 50 percent each, enter:

   io>AVOL VNAME=MEMBER2 LDEV=4 TRANSIENT=50 PERMANENT=50&

 VCLASS=PROD

The total percentage for TRANSIENT and PERMANENT must be at least 100 percent. It can be as high as 200 percent, although this is not recommended.

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.

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 I/O 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

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 I/O Configurator prompt (io>), enter:

   io>MCLASS classname newclassname additionalparameters

MCLASS has the following parameters:

MCLASS (MC) {[CLASS] = classname} [ [NEWCLASS =] newclassname] [ [ALDEV =] devicerange [,devicerange] [...] ] [ [DLDEV =] devicerange [,devicerange] [...] ] [[MODE =] { IN OUT 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, 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 I/O 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] [[MODE =] { JOB DATA INTERACTIVE DUPLICATIVE INPUT OUTPUT AUTOREPLY NLIO NONE }] [ [OUTDEV =] outputdevice] [ [RSIZE =] devrecsize] [ [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 `MPESUBTYPE`	Are allowed for only `USER` devices. 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.

NOTE: 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 I/O 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

You use the ID parameter to change 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 except for the system master volume, MEMBER1, which you cannot change in any way. 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 I/O Configurator prompt (io>), enter:

   io>MVOL volumename otherparameters

MVOL has the following parameters, which are defined below. Refer to the "To add volumes" section of this chapter for examples of their use.

MVOL (MV) { [VNAME =] volumename} [ [NEWVNAME =] newvolumename] [ [LDEV =] logicaldevice#] [ [TRANSIENT =] %diskfortransobj] [ [PERMANENT =] %diskforpermobj] [ [VCLASS =] volumeclass]

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.

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.

Parameter	Definition
`DCLASS`	Removes one or more class names from the system.
`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.
`DPATH`	Deletes an I/O path and all the I/O paths below it in the configuration.
`DVOL`	Deletes a volume member from the system configuration.

To delete classes

Use the DCLASS command (abbreviated DC) to delete class names from the configuration. To delete a class, at the I/O Configurator prompt (io>), enter:

   io>DCLASS classname

DCLASS has the following parameter:

DCLASS (DC) { [CLASS =] classname}

CLASS is a repeated parameter that identifies device class names. Class names are limited to eight characters and the first must be a letter. If the class does not exist, SYSGEN displays an error message. You cannot delete the DISC, CONSOLE, or TAPE classes.

The following list briefly explains how to use the DCLASS command and provides examples.

Use this command: To do this
DCLASS classname: Delete a class name. For example, to delete EPOC, enter DCLASS EPOC.
DCLASS (classname, classname): Delete multiple classes. For example, to delete EPOC and FASTLP, enter DCLASS (EPOC,FASTLP)

To delete devices

Use the DDEV command (abbreviated DD) to delete a device. You cannot delete the system disk (LDEV 1) or the system console (LDEV 20).

Start SYSGEN and at the prompt (sysgen>), enter:
sysgen>I/O
At the I/O Configurator prompt (io>), enter:
io>DDEV parameters

DDEV has the following parameters:

DDEV (DD) { [LDEV =] #/#,#,... [ID =] deviceid [TYPE =] devicetype [CLASS =] classname }

You must enter at least one parameter and the specified device must exist in the current configuration or SYSGEN will issue a warning. Other errors that occur are typically due to improper entry of a logical device, a range, or improper value for a positional parameter.

The following list briefly explains how to use the DDEV command and provides examples.

Use this command: To do this
DDEV LDEV ldev: Delete one device. For example, to delete logical device 123, enter DDEV LDEV=123.
DDEV LDEV ldev/ldev: Delete all devices within a specified range. For example, to delete devices 10, 11, 12, and 13, enter DDEV LDEV=10/13.
DDEV ID=prodID: Delete all devices with a given product identification number. If no devices meet the criteria, SYSGEN issues a warning. For example, to delete all products with the product ID HP2932A, enter DDEV ID=HP2932A.
DDEV TYPE=devtype: Delete all devices of a given type, either those supported by Hewlett-Packard or unsupported devices. To delete all devices not supported by Hewlett-Packard, enter DDEV TYPE=USER
DDEV CLASS=classname: Delete all devices with the given class name as well as the class name itself. If the class you specify does not exist, SYSGEN issues a warning. For example, to delete all LP devices and the device class LP, enter DDEV CLASS=LP. CLASS is a repeated parameter.

To delete paths

Use the DPATH command (abbreviated DP) to delete an I/O path and, optionally, all I/O paths below it from the configuration. If there are I/O paths below the one you are deleting, SYSGEN prompts you before deleting them with this question:

   I/O path specified has pending devices,

   want to delete all of them (yes/no)?

If an I/O path is currently used by a configured device, SYSGEN issues an error and does not delete the path.

Start SYSGEN and at the prompt (sysgen>), enter:
sysgen>io
At the I/O Configurator prompt (io>), enter:
io>DPATH devicepath

DPATH has the following parameter

DPATH (DP) { [PATH =] devicepath}

To delete a configured path with no associated devices, enter DPATH and the path. For example, to delete a path on a Series 925 through 949 or a Series 958 system, enter:

   io>DPATH 4.2

To delete a path on a Series 950 through 980 system, enter:

   io>DPATH 2/8.2

To delete volumes

Use the DVOL command (abbreviated DV) to remove a volume from the configuration. To implement the change, you must create a system load tape with the configuration and then use it to do an INSTALL. To delete a volume, at the I/O Configurator prompt (io>), enter:

   io>DVOL volumemembername

DVOL has the following parameters:

DVOL (DV) { [VNAME =] volumemembername}

To delete the volume named MEMBER2 from the list of volumes, enter:

   io>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
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.

Using SYSGEN's I/O Configurator

Technical documentation

» Table of Contents

» Glossary

» Index

Viewing the current configuration

To list device classes

To list devices

To list paths

To list volumes

To print configuration information

Configuring Devices with SYSGEN

To identify local devices to the system

To configure default device attributes

Adding Objects in SYSGEN

To add a class name

To assign a mode to a device

To add devices

To specify the LDEV, PATH, and ID

To specify the RSIZE

To specify the OUTDEV

To create a streams device

To specify the MODE

To specify the CLASS

To specify the CMODE

To specify the PMGR

To specify the LMGR

To specify the PMGRPRI

To specify the MPETYPE and MPESUBTYPE

To specify the DEVNAME

To create device link files

To configure tape drives for ejection and data compression

To add paths

To specify the PATH and ID

To specify the PMGR

To specify the LMGR

To specify the PMGRPRI

To specify the MAXIOS

To add volumes

To specify the VNAME, LDEV, and VCLASS

To specify transient and permanent disk space

Changing Configurations in SYSGEN

To modify paths

To change a path

To modify classes

To modify devices

To modify I/O paths

To change a product ID

To change the name of the physical device manager

To modify volumes

Deleting Objects in SYSGEN

To delete classes

To delete devices

To delete paths

To delete volumes

Changing the configuration online