7. Writing Field-developed Applications › 7.2 Deciding What the Application Must Do › 7.2.1 Input Source › 7.2.1.1 Input Source Example for UNP

7.2.1.1 Input Source Example for UNP

Sample UNP data source documentation
------------------------------------

The Network Performance Analyzer was an IBM Field Developed
Program (FDP), IBM product numbers 5798-CZR and 5798-CZT.
Information about this FDP was found in the NPA Program
Description and Operations Manual, SB21-2479.

The UNP field-developed application processes NPA records
from the SMF log, SMF record type 38.  The records have a set
structure:

+----------------+
| record header  |
| (fixed format) |
+----------------+
| measurement    | There are 3 types of measurement sections:
| section        |  - NCP resource measurement
| (format varies |  - network component measurement
| with record    |  - monitor exception measurement
| type)          |
+----------------+

*************************************************************
* R E C O R D   H E A D E R  (fixed format, in all records) *
*************************************************************
LOGSIZE  0    PIB2.     LOG RDW
         2    PIB2.
LOGSYS   4    PIB1.     SYSTEM INDICATOR
LOGSTYPE 5    PIB1.     RECORD TYPE 38
LOGSTIME 6    PIB4.     SMF WRITE TIME OF DAY, IN SEC/100
LOGSDATE 10   PD4.      SMF WRITE DATE
LOGSYSID 14   $CHAR4.   SMF SYSTEM ID
LOGADDR  18   $CHAR2.   HEX RESOURCE NETWORK ADDRESS
LOGNAME  20   $CHAR8.   NETWORK COMPONENT ID
LOGTOD   28   PIB4.     SMF WRITE TIME IN SECONDS
LOGUNQKY 32   PIB2.     RESERVED
LOGTYPE  34   $CHAR1.   TYPE OF LOG RECORD
*                       01  START COLLECT
*                       04  INTERVAL RECORD
*                       08  TOTAL RECORD
*                       0C  MONITOR EXCEPTION RECORD
*                       0F  STOP COLLECT RECORD
LOGNTYPE 35   $CHAR1.   TYPE OF NETWORK RESOURCE
*                       80  3705/NCP RESOURCE
*                       40  LINK (SDLC) OR LINE (BSC)
*                       20  PHYSICAL UNIT (SDLC)
*                       20  CLUSTER (BSC)
*                       10  LOGICAL UNIT (SDLC)
*                       10  TERMINAL (BSC)
*                       08  COMPONENT
*                       04  SWITCHED RESOURCE (SDLC)
*                       02  NPA PSEUDO DEVICE
*                       01  SDLC RESOURCE (USED WITH ABOVE)
LOGINTER 36   PIB4.     EXPECTED INTERVAL TIME IN SECONDS
LOGFWTOD 40   PIB4.     TOD FORWARD RU WAS SENT TO NCP
LOGLSPDS 44   PIB2.     SENDING LINE SPEED IF LINE/LINK
LOGLSPDR 46   PIB2.     RECEIVING LINE SPEED IF LINE/LINK
LOGNCPNM 48   $CHAR8.   NCP NAME
LOGQUE   56   PIB1.     INTERVAL NUMBER FOR THIS COLLECTION
LOGRSVP2 57   PIB1.     RESERVED
LOGINTCT 58   PIB2.     NUMBER OF INTERVALS IF TOTALS RECORD
LOGTIME  60   PIB4.     ACTUAL COLLECTION TIME THIS RECORD
*************************************************************

NCP Resource Record:

+----------------+
| record header  |
| (fixed format) |
+----------------+
| measurement    |
| section --     |
| NCP resource   |
| data           |
+----------------+

*************************************************************
* M E A S U R E M E N T   S E C T I O N -                   *
* NCP Resource Records                                      *
*************************************************************
LOGFCC   64   PIB4.     FREE CYCLE TIME, 10THS OF SECONDS
LOGFBQ   68   PIB2.     FREE BUFFER QUEUE LENGTH
LOGFBH   70   PIB2.     FREE BUFFER HIGH WATER MARK
LOGFBL   72   PIB2.     FREE BUFFER LOW WATER MARK
LOGCIQ   74   PIB2.     NCP CHANNEL INTERMED. QUEUE LENGTH
LOGCHQ   76   PIB2.     NCP CHANNEL HOLD QUEUE LENGTH
LOGSLH   78   PIB2.     TIME IN SLOWDOWN, 10THS OF SECONDS
LOGSLM   80   PIB2.     NUMBER FREE BUFFERS AT SLOWDOWN ENTRY
LOGMXF   82   PIB2.     MAX AVAILABLE FREE BUFFERS
*************************************************************

End of sample data source documentation