![](/images/new-backgrounds/1147420/147420215x1.webp)
aci_foreign
The aci_foreign function catalogs a foreign volume. See
Figure
#include "aci.h"
int aci_foreign( enum aci_command action, char *volser,
enum aci_media type, char *coordinate, short position )
Figure | aci_foreign Function Call |
| ||
| When a foreign volume named volser of media type has been | |||
| added to or removed from the AML system in a foreign mount | |||
| area, DAS must be informed of the status. This function | |||
| notifies DAS of the existence of the volume, and its coordinate. | |||
| If added, the volume can be used simply by referencing this | |||
| volser and type in a further aci_mount() or aci_dismount() | |||
| request. See Table |
| ||
Table | Parameters for the aci_foreign Function Call | |||
|
|
|
| |
Parameter |
|
| Descriptions | |
|
|
| ||
action |
| select the command for the foreign catalog procedure | ||
|
|
|
| |
|
| ACI_ADD |
| new volser will be added to the |
|
|
|
| foreign media area in DAS and AML |
|
|
|
| database |
|
|
|
|
|
|
| ACI_DELETE |
| volser entry for a foreign media that |
|
|
|
| will be removed from the DAS and |
|
|
|
| AMU database |
|
|
|
| |
volser |
| volser, that should be used in the application for the | ||
|
| mount (volser with up to 16 digits and alphanumeric | ||
|
| symbols, no special characters) | ||
|
|
| ||
type |
| media type of the named volser | ||
|
| Refer to Media Types on page | ||
|
|
| ||
coordinate |
| 10 digit logical coordinate of the compartment of the | ||
|
| foreign volume in the AMS, e.g. E501010110 | ||
|
| Refer to the AMU Reference Guide | ||
|
|
|
|
|