z/OS Distributed File Service zFS Administration
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Statistics Kernel Information

z/OS Distributed File Service zFS Administration
SC23-6887-00

Purpose

This subcommand call is a performance statistics operation that returns kernel counters, including the number of kernel operations and average time for the operation.

Format

syscall_parmlist
   opcode                246              STATOP_KNPFS
   parms[0]              offset to STAT_API
   parms[1]              offset to output buffer
   parms[2]              offset to system name (optional)
   parms[3]              0
   parms[4]              0
   parms[5]              0
   parms[6]              0
STAT_API
   sa_eye                char[4]          "STAP"
   sa_len                int              length of buffer that follows STAT_API
   sa_ver                int              1
   sa_flags              char[1]          0x00
     SA_RESET              0x80           Reset statistics
   sa_fill               char[3]          0
   sa_reserve            int[4]           0
   posix_time_high       unsigned long    high order 32 bits since epoch
   posix_time_low        unsigned long    low order 32 bits since epoch
   posix_useconds        unsigned long    microseconds
   pad1                  int
KERNEL_CALL_STATS
   kc_eye                char[8]          "xxxxADIR"
   kc_version            short            version
   kc_size               short            size of output
   pad1                  int              reserved
  KERNEL_LINE[40]
     kl_operation_name     char[27]         operation name string
     kl_valid              char             operation entry is valid (0x01)
     kl_count              unsigned long    count of operations
     kl_time               two_words      integer part of average time/fractional part of average time
     kl_reserved           int[6]         reserved
   kc_totalops           unsigned long    grand total operations
   pad2                  int              reserved
   kc_totaltime_reserved int              reserved
   kc_totaltime          int              grand total wait time
   kc_valid_slots        int              number of slots in above array that actually contains data
   kc_reserved           int[10]          reserved
   pad3                  int              reserved
systemname               char[9]

Return_value     0 if request is successful, -1 if it is not successful

Return_code
  EINTR          zFS is shutting down
  EINVAL         Invalid parameter list
  EMVSERR        Internal error occurred
  E2BIG          Information too big for buffer supplied
Reason_code
  0xEFnnxxxx     See z/OS Distributed File Service Messages and Codes

Usage notes

  • Reserved fields and undefined flags must be set to binary zeros.

Privilege required

None.

Related services

  • Statistics Vnode Cache Information
  • Statistics Metadata Cache Information

Restrictions

None.

Examples

#pragma linkage(BPX1PCT, OS)
extern void BPX1PCT(char *, int, int, char *, int *, int *, int *);

/* #include <stdlib.h>  */
#include <stdio.h>

#define ZFSCALL_STATS    0x40000007
#define STATOP_KNPFS                  246  /* Performance API queries */

#define u_long unsigned long

typedef struct syscall_parmlist_t
{
    int opcode;               /* Operation code to perform             */
    int parms[7];             /* Specific to type of operation,        */
                              /* provides access to the parms          */
                              /* parms[4]-parms[6] are currently unused*/
} syscall_parmlist;

typedef union {
    struct double_word_t
  {
    unsigned int first_word;
    unsigned int second_word;
    } double_word;
double alignment_dummy;
} two_words;

#define MAX_KERNEL_LINES 40
/*                               */
typedef struct KERNEL_line_t{
  char   kl_operation_name[27];
  char   kl_valid;
  u_long kl_count;
  two_words  kl_time;
  int    kl_reserved[6];
} KERNEL_LINE;
/*                               */
typedef struct kernel_call_stats_t {
  char   kc_eye[8];  /*eye catcher */
  short  kc_version;
  short  kc_len;
  int    pad1;
  KERNEL_LINE  OUTPUT[MAX_KERNEL_LINES];
  u_long kc_totalops;  /*Grand Total operations */
  int    pad2;
  two_words  kc_totaltime;  /*Grand Total wait time*/
  int    kc_valid_slots;  /* Number of slots in the above array*/
                     /* that actually contain data*/
  int    kc_reserved[10];
  int    pad3;
} KERNEL_CALL_STATS;

/* reset timestamp */
typedef  struct  reset_time {
  u_long   posix_time_high;   /* high order 32 bits since epoc */
  u_long   posix_time_low;    /* low order 32 bits since epoch */
  u_long   posix_usecs;        /* microseconds */
  int      pad1;
 } RESET_TIME;

/*********************************************************************/
/* The following structure is the api query control block            */
/* It is used for all api query commands                             */
/*********************************************************************/

typedef struct stat_api_t
{
#define SA_EYE    "STAP"
    char  sa_eye[4];     /* 4 byte identifier must be */
    int   sa_len;        /* length of the buffer to put data into*/
                         /* this buffer area follows this struct*/
    int   sa_ver;        /* the version number currently always 1*/
#define SA_VER_INITIAL 0x01
    char  sa_flags;      /* flags field  must be x00 or x80, x80 means reset statistics*/
#define SA_RESET 0x80
    char  sa_fill[3];    /* spare bytes */
    int   sa_reserve[4];       /* Reserved */
    struct reset_time reset_time_info;
} STAT_API;

struct parmstruct
{
    syscall_parmlist myparms;
    STAT_API myapi;
    KERNEL_CALL_STATS mystats;
    char systemname[9];
} myparmstruct;

int main(int argc, char **argv)
{
    int bpxrv;
    int bpxrc;
    int bpxrs;
    int i;

    STAT_API *stapptr = &(myparmstruct.myapi);
    KERNEL_CALL_STATS *stkcptr = &(myparmstruct.mystats);
    char buf[33];

    myparmstruct.myparms.opcode = STATOP_KNPFS;
    myparmstruct.myparms.parms[0] = sizeof(syscall_parmlist);
    myparmstruct.myparms.parms[1] = sizeof(syscall_parmlist) + sizeof(STAT_API);
    myparmstruct.myparms.parms[2] = 0;

/* Only specify a non-zero offset for the next field (parms[2]) if */
/* you are running z/OS 1.7 and above, and */
/* you want to query the kernel statistics of a different system than this one */

/* myparmstruct.myparms.parms[2] = sizeof(syscall_parmlist) + sizeof(STAT_API) +   */
/*                                 sizeof(KERNEL_CALL_STATS);                      */

    myparmstruct.myparms.parms[3] = 0;
    myparmstruct.myparms.parms[4] = 0;
    myparmstruct.myparms.parms[5] = 0;
    myparmstruct.myparms.parms[6] = 0;

    memset(stapptr,0,sizeof(STAT_API));
    memcpy(stapptr->sa_eye,SA_EYE,4);
    stapptr->sa_ver=SA_VER_INITIAL;
    stapptr->sa_len=(int) sizeof(KERNEL_CALL_STATS);

/* This next field should only be set if parms[2] is non-zero */
/* strcpy(myparmstruct.systemname,"DCEIMGVQ"); */

    BPX1PCT("ZFS     ",
            ZFSCALL_STATS,            /* Perf statistics operation        */
            sizeof(myparmstruct),     /* Length of Argument      */
            (char *) &myparmstruct,   /* Pointer to Argument     */
            &bpxrv,                   /* Pointer to Return_value */
            &bpxrc,                   /* Pointer to Return_code  */
            &bpxrs);                  /* Pointer to Reason_code  */
    if( bpxrv < 0 )
    {
        printf("Error querying kernel calls, BPXRV = %d BPXRC = %d BPXRS = %x\n",bpxrv,bpxrc,bpxrs);
        return bpxrc;
    }
    else
    {
        printf("%34s\n","zFS Kernel PFS Calls");
        printf("%34s\n","--------------------");
        printf("\n");
        printf("Operation               Count          Avg Time\n");
        printf("---------          ----------        ----------\n");

        i=0;
        while (myparmstruct.mystats.OUTPUT[i].kl_valid == 1)
        {
            printf("%13s     %10u     %9u.%3.3u\n",myparmstruct.mystats.OUTPUT[i].kl_operation_name,
                             myparmstruct.mystats.OUTPUT[i].kl_count,
                             myparmstruct.mystats.OUTPUT[i].kl_time.double_word.first_word,
                             myparmstruct.mystats.OUTPUT[i].kl_time.double_word.second_word);
         i+=1;
        }

        printf("---------          ----------        ----------\n");
        printf("*TOTALS*           %10u     %9u.%3.3u\n",
               myparmstruct.mystats.kc_totalops,
               myparmstruct.mystats.kc_totaltime.double_word.first_word,
               myparmstruct.mystats.kc_totaltime.double_word.second_word);

        if (0==ctime_r((time_t *) &stapptr->reset_time_info.posix_time_low, buf))
        {
            printf("Could not get timestamp.\n");
        }
        else
        {   /* Insert the microseconds into the displayable time value */
            strncpy(&(buf[27]),&(buf[20]),6);
            sprintf(&(buf[20]),"%06d",stapptr->reset_time_info.posix_usecs);
            buf[26]=' ';
            buf[19]='.';
            printf("Last Reset Time: %s",buf);
        }
    }
    return 0;
}

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014