gtpc2m7j | C/C++ Language Support User's Guide |
This function is used to retrieve the tape volume serial number (VOLSER) for the specified tape name.
Format
#include <tpftape.h> tpvstat *tdspc_v (const char *name, char type, enum t_lvl level);
Normal Return
When completed successfully, the return code will point to the tpvstat structure that was placed in the FARW of the data level specified.
Error Return
An error return is indicated by a zero return code.
Programming Considerations
When returned, the data level will be unchanged, but the FARW will contain the VOLSER and tape module number.
Examples
The following example retrieves the VOLSER from the tape name indicated.
#include <tpftape.h> long example() { char *tape_name; struct tpvstat *tape_volser_status;
·
·
·
tape_volser_status = tdspc_v (tape_name,ACTIVE,DF); printf("the volser is %6s\n",tape_volser_status->vsn);
·
·
·
}
Related Information