ADIC Server User Manual page 156

aci_scratch_set
#include "aci.h"
int aci_scratch_set( char *subpool,
Figure 4-104
Table 4-46
Parameter
subpool
type
volser
Attention
4-114 DAS ACI Functions
The aci_scratch_set function sets volume status to scratch. See
Figure 4-104.
enum aci_media type,
char *volser )
aci_scratch_set Function Call
Set volume named volser of media type type to scratch status
in the scratch pool named subpool.
The subpool is created if it does not exist. If a subpool is not
specified and set to the NULL string ("" or '\0'), the default
pool will be used.
If the volume is already defined to another pool, an error
(EOTHERPOOL) will be returned. If this is a new scratch
volume, subpool will be the pool from which the volume can
be selected using the aci_get_scratch function. See
Table 4-46.
Parameters for the aci_scratch_set Function Call
the stored name of the pool for scratch media in the AMU
database. If the information is to be taken from a default
subpool of a media type set type to the media type of the
volser and set subpool to the NULL string ("" or '\0')
type of the media in the subpool
(Refer to Media Types on page 2-7)
set volser to scratch in the named subpool in the AMU
database (only possible, if the volser is already defined in the
AMU database but the status of the volser (ejected, mounted,
etc.) is not relevant).
Data stored on the media may be lost. The command
automatically sets the specified medium as a scratch
medium (without a confirmation prompt). The data on the
medium is overwritten by the next scratch mount command.
Description
601626-B