EXPORT-ROBAR-VOLUME Export cartridges

Application area: SCSI interface

This statement starts the export of cartridges to the input/output unit.

You can export your system’s own cartridges or imported foreign cartridges at the ABBA interface, see section "Exporting cartridges".

You can use this statement to supply ROBAR with individual archive numbers or a range of archive numbers of cartridges to be removed from the archive.

EXPORT-ROBAR-VOLUME

VOLUME = <alphanum-name 1..6> / *INTERVAL(...)
	*INTERVAL(...)
		|	FROM = <alphanum-name 1..6>
		|	,TO = <alphanum-name 1..6>
,KEEP-POSITION = *YES / *NO
,LOCATION = <alphanum-name 1..8> / *NOT-SPECIFIED

VOLUME = <alphanum-name 1..6> / *INTERVAL(...)

Archive number (VSN) of the cartridge.

VOLUME = <alphanum-name 1..6>

Archive number of a cartridge.

VOLUME = *INTERVAL(...)

Sequence of archive numbers of cartridges to be exported in unbroken ascending order. Note the following before entering numbers:

• the first and last archive number must be the same length

• the numeric field of each archive number must always occupy the same position in the number and must always be the same length

• the numeric field of the last archive number must be higher than that of the first.

  FROM = <alphanum-name 1..6>
  First VSN in the range.

  TO = <alphanum-name 1..6>
  Last VSN in the range.

KEEP-POSITION =

This parameter defines whether the archive record entry of the cartridge is deleted or retained. This operand has no meaning for the SCSI interface.

KEEP-POSITION = *YES

The archive record entry is retained.

KEEP-POSITION = *NO

The archive record entry is deleted.

LOCATION = <alphanum-name 1..8> / *NOT-SPECIFIED

Defines the storage location from which the cartridge is to be exported.

LOCATION = <alphanum-name 1..8>

Defines the storage location. You should use this specification if multiple ROBAR-SV instances are connected. Only the ROBAR-SV instance which administers the specified location will perform the statement. See also the section "Checking the value for the LOCATION operand".

LOCATION = *NOT-SPECIFIED

No storage location is defined.
This value makes sense only when only one ROBAR-SV instance is connected.

Notes

• If MAREN is being used, then you should use the MAREN statement EXPORT-VOLUME instead of this statement.

• ROBAR-CL informs MAREN as soon as the cartridge is exported so that the MAREN catalog is kept up-to-date:

  • If the exported cartridge is a foreign cartridge (FOREIGN), your entry is removed from the MAREN catalog

  • If the exported cartridge is a cartridge that is part of the MAREN Freepool, the temporary storage location of the cartridge (TEMPORARY-LOCATION) is changed to CENTRAL

  • In all other cases, the cartridge is flagged in the MAREN catalog as EXPORTED BY ROBAR-SDF.

• In the case of system cartridges (ABBA interface), the storing position in the archive remains reserved and appropriate information is entered in the archive record.
  
  

Examples

//EXPORT-ROB-VOL VOL=*INT(FROM=X00000,TO=X00009)

This statement starts the export for ten system cartridges, beginning with the VSN X00000.

//EXPORT-ROB-VOL VOL=FREMD7,KEEP-POS=NO

The cartridge FOR7 is to be placed in the output unit. The archive record is subsequently deleted.