Purpose

DosQuerySysState returns information about various resources in use by the system. The EntityList parameter determines which information is returned according to the bits set in this parameter.

Syntax

#define INCL_DOSPROFILE
#define INCL_DOSERRORS
#include  os2.h>

APIRET APIENTRY DosQuerySysState

(ULONG EntityList, ULONG EntityLevel, PID pid, TID tid, PVOID pDataBuf, ULONG cbBuf)

Parameters

EntityList (ULONG) input

Determines what information is returned. May be a combination of the following

QS_PROCESS

0x0001 Requests process information
QS_SEMAPHORE
0x0002 Requests semaphore information
QS_MTE
0x0004 Requests module information
QS_FILESYS
0x0008 Requests file system information
QS_SHMEMORY
0x0010 Requests shared memory information
QS_MODVER
0x0200 Requests module version information
EntityLevel (ULONG) input
Determines the extent of information returned for a given entity. This applies to QS_MTE entities only. If EntityLevel is also set to SQ_MTE, then module object information is returned.
pid (PID) input
Restricts information to a particular process ID. If 0 is specified, then entities for all processes are returned.
tid (TID) input
Restricts information to a particular thread ID. A value of zero only is supported, requesting all threads of a process.
pDataBuf (PVOID) output
Pointer to the buffer allocated by the user into which entity structures are returned. If the buffer is of insufficient size, then an ERROR_BUFFER_OVERFLOW is returned.
cbBuf (ULONG) input
Size of the buffer pointed to by pDataBuf in bytes.

Returns

ulrc (APIRET) returns

Return Code.

DosQuerySysState returns one of the following values

• NO_ERROR

  87

  ERROR_INVALID_PARAMETER
  111
  ERROR_BUFFER_OVERFLOW
  115
  ERROR_PROTECTION_VIOLATION
  124
  ERROR_INVALID_LEVEL

  Remarks

  The information returned by DosQuerySysState begins with a pointer to the global record structure, qsGrec_s. Following this will be a series of other records which depend on what information was requested. Some of these subsequent record structures contain an identifier as their first member, which enables the returned information to be interpreted without any order being imposed.

  Entities that may be requested are

  Process information

  QS_PROCESS
  Semaphore information
  QS_SEMAPHORE
  Module information
  QS_MTE
  File system information
  QS_FILESYS
  Shared memory information
  QS_SHMEMORY
  Module Version information
  QS_MODVER
  Not all entities have been supported in earlier versions of OS/2.

  The structures returned will be a combination of the following

  qsGrec_t

  Global Record structure
  qsTrec_t
  Thread Record structure
  qsPrec_t
  Process Record structure
  qsS16rec_t
  16 bit system semaphore structure
  qsS16Headrec_t
  16 bit system semaphore structure
  qsMrec_t
  Shared Memory Record structure
  QSOPENQ
  32 bit Open Semaphore structure
  QSEVENT
  32 bit Event Semaphore structure
  QSMUTEX
  32 bit Mutex semaphore structure
  QSMUX
  32 bit Mux semaphore structure
  QSHUN
  32 bit semaphore header structure
  qsS32rec_t
  32 bit semaphore header structure
  qsLObjrec_t
  Object level MTE information
  qsLrec_t
  System wide MTE information
  qsExLrec_t
  Module version information
  qsSft_t
  System wide FILE information one per open instance
  qsFrec_t
  System wide FILE information one per file name
  qsPtrRec_t
  System wide FILE information

  Related Functions

  • DosQueryMemState

  • DosQuerySysInfo

  Example Code

  #define BUFSIZE 64*1024int main(int argc, char *argv[], char *envp[])
  {
     APIRET rc;
     qsGrec_t ** pBuf;
     qsGrec_t * pGrec;
     qsLrec_t * pLrec;
  
  
     pBuf=malloc(BUFSIZE); /* allocate a 64K buffer */
     if (pBuf == NULL) {
        printf("Not enough memoryan");
        return ERROR_NOT_ENOUGH_MEMORY;
     } /* endif */
  
     /* query module information */
  
     rc=DosQuerySysState(QS_MTE, 0L, 0L, 0L, pBuf, BUFSIZE);
     if (rc!=0) {
        printf("DosQuerySysState returned rc=%u\n",rc);
        return rc;
     } /* endif */
  
     pGrec = *  pBuf;
  
     printf("Threads=%u 32-bit Sems=%u File Names=%u\n\n",
                  pGrec->cThrds,
                  pGrec->c32SSem,
                  pGrec->cMFTNodes);
  
     pLrec = (ULONG)pGrec + sizeof(qsGrec_t);
  
     while (pLrec) {
        if (pLrec->pName) printf("hmte=%04x %s\n", pLrec->hmte, pLrec->pName);
        pLrec = pLrec->pNextRec;
     } /* endwhile */
  
     return rc;
  }
  

  ---

  [Back] [Next]