gtpc2mipC/C++ Language Support User's Guide

TPFxd_getVOLSERlist-Retrieve a List of VOLSERs and Media Type

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);

positioningStringMap
The location from which the volume serial number (VOLSER) list and device type will be derived.

volser
A pointer to where the VOLSERs will be placed.

devType
A pointer to where the device type will be placed.

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