5. DATABASE FILES › 5.2 SNT Information Area › 5.2.21 VTAM CSM Data File (SNTVCS) › 5.2.21.3 Usage Considerations

5.2.21.3 Usage Considerations

This section identifies the special considerations or
techniques related to using the SNTVCS File.  Additionally,
several retrieval examples are provided to facilitate the use
of this file.


In the examples, a SAS macro variable is used to specify the
DDname part of the CA MICS file name. These macro variables
are a standard part of CA MICS and are available for all
files. The macro variable name has the form &diiit, where d
is the database identifier, iii is the information area
name, and t is the timespan.  For the examples, a database
identifier of P is used.  The identifier is installation
dependent, so you should find out what the identifiers are at
your installation.

Special Considerations/Techniques

1. Care must be exercised in using the special date and time
   data elements contained in each CA MICS file.  As the
   files' granularity increases in higher timespans, certain
   fields lose significance and should not be used in these
   cases:

   o HOUR should not be used in MONTHS.
   o DAY and DAYNAME should not be used in WEEKS or MONTHS.
   o WEEK should not be used in MONTHS.

2. The following data elements are user-defined.  The value
   in each is dependent on user-selected options or user-
   supplied SAS code:

   o NETWRKID - Network Identifier.  A one to eight-character
     descriptive name for each network represented in the
     data.  NETWRKID is set in the Network Identifier Exit
     Routine, SNTNIDRT, discussed in Chapter 7.

   o TMOFFSET - Time offset applied to the data in the file.
     The user can associate a time offset with each unique
     NETWRKID/SYSID combination.  This offset is used to
     adjust data times when data from multiple time zones is
     brought together in the CA MICS database.  To determine
     the original time at which the data was recorded,
     subtract TMOFFSET from the value.  Time offset is
     assigned in the SNTOPS member of prefix.MICS.PARMS,
     discussed in Chapter 7.

3. The following data elements lose significance once
   summarization has been performed.  These data elements
   should only be referenced when the last observed value in
   a summarization interval is significant.

   PRODVRRL - Product Version and Release
   TMOFFSET - Time Offset
   VCSVDTYP - Data Type
   VCS04DSR - Dynamic Expansion On/Off
   VCS16DSR - Storage Type
   VCS04DSR - 4K Data Space CSM Buffer Source
   VCS16DSR - 16K Data Space CSM Buffer Source
   VCS32DSR - 32K Data Space CSM Buffer Source
   VCS60DSR - 60K Data Space CSM Buffer Source
   VCS04ESR - 4K ECSA CSM Buffer Source
   VCS16ESR - 16K ECSA CSM Buffer Source
   VCS32ESR - 32K ECSA CSM Buffer Source
   VCS60ESR - 60K ECSA CSM Buffer Source
   VCS04DSI - 4K Data Space CSM Buffer Size
   VCS16DSI - 16K Data Space CSM Buffer Size
   VCS32DSI - 32K Data Space CSM Buffer Size
   VCS60DSI - 60K Data Space CSM Buffer Size
   VCS04ESI - 4K ECSA CSM Buffer Size
   VCS16ESI - 16K ECSA CSM Buffer Size
   VCS32ESI - 32K ECSA CSM Buffer Size
   VCS60ESI - 60K ECSA CSM Buffer Size


Retrieval Examples

1. Produce a report for CSM storage use.

   PROC PRINT DATA=&PSNTX..SNTVCS01;
     WHERE VCSVDTYP = 'STORAGE';
     ID NETWRKID SYSID SNTSSCP SNTCSM;
     VAR VCSMXFSU VCSMXESU VCSCURFX VCSCUREC;