Storage Management Foundation User's Guide

Guardian Procedures
HP NonStop Storage Management Foundation User's Guide—523562-008
8-4
Discovery Operations
Discovery Operations
Discovery operations are call sequences using Guardian procedures unique to SMF to
identify the names of SMF objects on a system and optionally retrieve configuration
information for the objects. The procedures that discover SMF objects on a system are
used in groups of three:
1. Call one of the following procedures to start a session for discovering storage
pools, virtual disks, or physical volumes, respectively:
{POOLS }
SMS_GET{VIRTDISKS }START_
{PHYSVOLSINPOOL}
2. Call one of the following procedures repeatedly to retrieve information for a storage
pool, a virtual disk, or a physical volume, respectively:
{POOLS }
SMS_GET{VIRTDISKS }NEXT_
{PHYSVOLSINPOOL}
When information for the last object of a particular type has been retrieved, these
procedures return FEEOF (one).
3. Call one of the following procedures to terminate the retrieval session for storage
pools, virtual disks, or physical volumes, respectively:
{POOLS }
SMS_GET{VIRTDISKS }END_
{PHYSVOLSINPOOL}
You can conduct discovery operations on different SMF objects simultaneously. For
example, you can call SMS_GETPOOLSSTART_, followed by
SMS_GETVIRTDISKSSTART_, followed by SMS_GETPHYSVOLSINPOOLSTART_, to
initiate three simultaneous discovery sessions.
When you start a discovery session for an object of a particular type, you must
terminate the session before starting another one for the same type of object. For
example, after making a successful SMS_GETPOOLSSTART_ call, you call
SMS_GETPOOLSEND_ before calling SMS_GETPOOLSSTART_ again.