ADIC Server - Manual (Page 156)

4-114 DAS ACI Functions
601626-B
aci_scratch_set
The aci_scratch_set function sets volume status to scratch. See
Figure 4-104.
Figure 4-104 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.
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.
Table 4-46 Parameters for the aci_scratch_set Function Call
Parameter Description
subpool 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 type of the media in the subpool
(Refer to Media Types on page 2-7)
volser 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).
#include "aci.h"
int aci_scratch_set( char *subpool,
enum aci_media type,
char *volser )
Attention