Create Container Volumes (QMOCRTCV) API

The Create Container Volumes (QMOCRTCV) API creates optical image catalog entries and an associated VOLUME_LIST file that are contained on physical optical media within a physical optical device. The created optical volumes are not initialized and will be assigned default system generated volume names based on date/time format.

The QMOCRTCV API currently supports the following device types:

• RDX devices
• Flash drives

Authorities and Locks

Device Description Authority

*USE

Retrieve Device Description (QDCRDEVD) API

*USE

Required Parameter Group

Device name

INPUT; CHAR(10)

The name of the physical optical RDX or flash drive device that will contain the optical image catalog entries. The media within the RDX or flash drive must be pre-initialized as container media before this API can be used.

File name prefix.

INPUT; CHAR(6)

A prefix up to 6 characters to be used as the first characters of the IFS file names for the created container volumes. A incrementing numeric value starting at 001 will be appended to the prefix by the system.

Valid values are:

*DFT	A prefix of VOLIMG will be used.
file-name-prefix	The IFS file name prefix to use for the created image catalog entries. The prefix must consist of characters A through Z (upper case only), 0 through 9, '_', '.', or '-'. The first character must be alphanumeric.

Volume count

INPUT; CHAR(8)

The number of image catalog entries to be created.

Valid values are:

*MAX	256 image catalog entries will be created.
volume-count	The number of image catalog entries to create. The volume count must consist of characters 0 through 9. The maximum value is 256.

Volume size

INPUT; CHAR(8)

The size of the created image catalog entries in MB.

Valid values are:

*MAX	The created image catalog entries will use all of the available space on the on the container media.
*CD650	The created image catalog entries will have a size of 650MB.
*DVD2600	The created image catalog entries will have a size of 2.6GB.
*DVD4700	The created image catalog entries will have a size of 4.7GB.
volume-size	The size in MB to be used for each image catalog entry created. The volume size must consist of characters 0 through 9. The minimum value is 48 and the maximum value is 1000000.

Optional Parameter Group

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.

Examples

The following are examples of calls to the API from command entry:

• CALL QMOCRTCV (RMS01 RMSVOL '10' '100' 0)

  Create 10 100MB image catalog entries within device RMS01. The created image catalog entries will have IFS file names RMSVOL001 through RMSVOL010. Any diagnostic and escape messages are returned to the command entry.

• CALL QMOCRTCV (RMS01 *DFT *MAX *DVD4700)

  Create 256 4.7GB image catalog entries within device RMS01 and use the default IFS file name prefix of VOLIMG for all of the created entries . Any diagnostic and escape messages are returned to the command entry.

• CALL QMOCRTCV (RMS01 A '5' *MAX)

  Create 5 image catalog entries within device RMS01. The created image catalog entries will have IFS file names A001 through A005. The 5 image catalog entries will be large enough to use up all of the space on the physical media. Any diagnostic and escape messages are returned to the command entry.

Error Messages

[ Back to top | Backup and Recovery APIs | APIs by category ]