gtpc2mip | C/C++ Language Support User's Guide |
This function is called to copy the VOLSER list and device type from a position string map into the specified location.
Format
#include <c$tpxd.h> long TPFxd_getVolserList (TPFxd_locationMap *positioningStringMap, char volser[66], char *devType);
Normal Return
The normal return is a positive value.
Error Return
An error return is indicated by a negative return code. For a list of error codes applicable to this function, see Error Codes.
Programming Considerations
TPFxd_getVOLSERlist does not require the external device to be open. This function can be called using a TPFxd_location parameter, which was obtained from an earlier TPFxd_open or TPFxd_nextVolume request.
Examples
The following example takes the positioning string map that was passed and retrieves the list of VOLSERS that were used.
#include <c$tpxd.h> long example(TPFxd_locationMap *positioningStringMap) { long returncode; char VolserList[66]; char deviceType; returncode = TPFxd_getVolserList(positioningStringMap, volserList, deviceType); printf("VOLSER is %6.6s",currentVolser);
·
·
·
}
Related Information