NAME

Logical name of the migrated media.

The name specified should clearly describe the target media, such as ATL1, and so on. Assign unique names to different media types or, when applicable, to different device groups within the same media type.

For example, if multiple ATLs (automatic tape libraries) are used, a media name should be assigned to each ATL. This ensures that tapes created in one ATL are not requested in another ATL.

Define these names carefully because they are used for migration and for viewing migrated reports. Changing or deleting a name after it was used for migration prevents access to files migrated under that name.

TYPE

Target media type.

Control‑V supports the following media types:

• CART – 3490 tape cartridge subsystem
• DASD – Disks, Fat‑DASD, IBM 3995 Optical library Dataserver Model 153 (3390 simulation)
• OAM – IBM Object Access Method for IBM 3995 optical library data server
• Centera - EMC Centera Storage System

DSNPREF

One-, two-, or three-character value. DSNPREF must be the same length as the IXHPREF parameter.

If three characters, DSNPREF is the high level data set name qualifier of CDAM and index data sets migrated to the media.

If one or two characters, the migrated data set name prefix is built by inserting the first DSNPREF character into the non-migrated file prefix. If DSNPREF is one character, it is inserted into the first position of the non-migrated file prefix.

If DSNPREF is two characters, the second character should be a digit from 1 to 7. It represents the number of the position into which the first DSNPREF character is inserted. The one or two characters option should be used if, according to data set naming convention at the site, the high level qualifier must be more than three characters in length.

The value specified for the DSNPREF parameter must be different than the value specified for the IXHPREF and SECPREF parameters.

SECPREF

One-, two-, or three-character value. SECPREF must be the same length as the DSNPREF and IXHPREF parameters.

If three characters, SECPREF is the high level data set name qualifier of CDAM and Index data sets migrated to the media.

If one or two characters, the migrated data set name prefix is built by inserting the first SECPREF character into the non-migrated file prefix. If SECPREF is one character, it is inserted into the first position of the non-migrated file prefix. If SECPREF is two characters, the second character should be a digit from 1 to 7. It represents the number of the position into which the first SECPREF character is inserted. The one- or two- character option should be used if, according to data set naming convention at the site, the high level qualifier must be more than three characters in length.

If SECONDARY is set to Y in the migrated mission definition, the second migrated job uses this prefix, and the first migrated job uses the prefix specified by the DSNPREF parameter.

The value specified for the SECPREF parameter must be different than the value specified for the IXHPREF and DSNPREF parameters.

Notes:

• Migrated job names should be granted ALTER authority to delete files starting with DSNPREF and SECPREF in your security facility.
• Verify that the DSNPREF, IXHPREF and SECPREF parameters contain unique values.

UNITNAME

Generic or esoteric unit name defined for this media in the system. Specify the esoteric unit name only if no generic unit name was defined for this media. The unit name must be a valid unit name ranging from 1 through 8 characters.

If no specific unit name was defined in the system for these devices, type 3490 for UNITNAME.

CARTLEN

For CART media only.

For CART media, the CARTLEN parameter specifies the length, in feet or MB, of the cartridges used. If the value is in foot, only the digital value should be specified. If the value is in MB, the letter 'M' should be added after the value.

For more information, see the Control‑D and Control‑V chapter in the INCONTROL for z/OS Administrator Guide.

COMP

For CART media only. Whether to use IDRC Compression. Valid values are:

• Y (Yes) – Use IDRC compression during the migration process.
• N (No) – Do not use IDRC compression during migration.
• D (Defined) – Use the MVS compression defined for the tape drive. Default.

DEVUSE

For CART media only. This parameter relates to the device handling method used. Valid values are:

• DEDICATED – The devices used by the server are dedicated to its use. The devices are not freed until the connection between the server and the device is stopped.
• DYNAMIC – The devices used by the server are shared. The server uses any free device and releases the device when not in use or after requests for a volume are processed.

For additional information about this parameter, see the Control‑D and Control‑V chapter in the INCONTROL for z/OS Administrator Guide.

DEVADDR

The DEVADDR parameter is optional for CART media and can only be used if the value entered for the DEVUSE parameter is DEDICATED.

The DEVADDR and DEVQTY parameters are mutually exclusive.

The DEVADDR parameter specifies the device numbers that identify each device dedicated to the IOA Archive Server. The syntax is:

(devnum[,devnum...])

where devnum is the 4‑digit number of the device

DEVQTY

For CART media only.

The DEVQTY and DEVADDR parameters are mutually exclusive.

The DEVQTY parameter is mandatory if the DEVUSE parameter is set to DYNAMIC.

The DEVQTY parameter specifies the maximum and initial quantity of devices that can be used by the IOA Archive Server for this media. The devices are allocated according to the DEVUSE parameter. For additional information, see the Control‑D and Control‑V chapter in the INCONTROL for z/OS Administrator Guide.

The syntax is:

(maximum,start)

where:

• maximum is the maximum quantity of devices that can be used by the IOA Archive Server for this media at any time. Default.
• start is the quantity of devices used by the IOA Archive Server for this media when the media is initialized.

DYNDEVRL

Specify this parameter for CART media when DEVUSE is set to DYNAMIC. The SWITCH/NOSWITCH flag indicates how to handle dynamic devices. The idletime subparameter specifies when to release dynamic devices. The syntax is:

(SWITCH|NOSWITCH,idletime)

where:

• SWITCH – Release a device when a volume is switched. The next request may cause allocation of another device, or, if all devices are allocated, may cause a delay. In this allocation method, dynamic allocation is performed in a standard manner, using the MVS catalog. It is the recommended method at sites that have a multiple number of Robotic Tape Libraries, or when the IOASMON non-switched allocation method impacts on the functionality of the Tape Management System.
• NOSWITCH – Release a device only when there are no pending requests. Volume switching does not cause device deallocation. This ensures that if there are pending requests, an allocated device is not reallocated to another job or started task. Default.
• idletime – Time in minutes during which a DYNAMIC device remains allocated to the IOA Archive Server when the device is not used. If this time interval passes and the device is not used, it is freed. This parameter ensures device availability for pending requests, and frees unneeded devices. Default: 1 (minute).

MAXCONN

You can insert a value for this parameter if you are using OAM media.

Maximum number of data sets that can be viewed or printed simultaneously from the OAM or FileTek Storage Machine by Control‑V.

• Default: 20.

OBJSIZE

For OAM media only.

Number of original report CDAM file blocks to combine in each OAM object.

DB2PLAN

Name of the DB2 plan defined during OAM installation. Recommended value: CBRIDBS.

Note: If you change the DB2 plan name in OAM to any name other than CBRIDBS, you must change the DB2PLAN parameter in this facility accordingly.

DB2SID

DB2 Subsystem ID.

POOL1-POOL4

Each POOLx parameter defines Centera access node addresses. If more than 1 address is defined, they should be separated by commas and enclosed in single quotes.

NAME

Y

Y

Y

Y

TYPE

Y

Y

Y

Y

DSNPREF

Y

Y

Y

N

SECPREF

Y

Y

Y

N

UNITNAME

Y

Y

N

N

DEVUSE

Y

N

N

N

DEVADDR

1, 2

N

N

N

CARTLEN

Y

N

N

N

COMP

Y

N

N

N

DEVQTY

(1)

N

N

N

DYNDEVRL

O, 3

N

N

N

MAXCONN

N

N

O

O

OBJSIZE

N

N

Y

N

DB2PLAN

N

N

Y

N

DB2SID

N

N

Y

N

POOL1-POOL4

N

N

N

Y

Y

Parameter is allowed.

N

Parameter is not allowed.

O

Parameter is optional. If not specified, defaults are used.

1

The DEVADDR and DEVQTY parameters are mutually exclusive. One of them should be specified.

2

Allowed only when DEVUSE is set to DEDICATED.

3

Allowed only when DEVUSE is set to DYNAMIC.