NAME

usam_mig_stage_file_req - Stages request from the foreign data migration program

SYNOPSIS

cc [ flag … ] file … -L∕opt∕SUNWsamfs∕lib -lsamut [ library … ]

#include "∕opt∕SUNWsamfs∕include∕mig.h"

int usam_mig_stage_file_req(tp_stage_t * stage_req );

AVAILABILITY

SUNWsamfs

DESCRIPTION

usam_mig_stage_file_req() is the stage request routine for the Oracle HSM Migration Toolkit. The foreign data migration program adds this stage request to an internally-generated worklist being maintained by third party API. This worklist should be processed by a thread started by usam_mig_initialize(). This worklist is processed by a program started with usam_mig_initialize(). The thread finds and positions the media to stage the file through stage_api.

RETURN VALUES

A successful stage request returns a value of 0. Otherwise, a value of 1 is returned and errno is passed to the file system.

ERRORS

usam_mig_stage_file_req() fails if the following is true:

EEXIST: This is a duplicate stage request for a file.

FILES

∕opt∕SUNWsamfs∕migkit∕mig_cd.c: The example Migration Toolkit program.
∕etc∕opt∕SUNWsamfs∕mcf: The configuration file for StorageTek QFS and Oracle HSM file systems.