7. PARAMETERS › 7.3 Unit-level Parameters › 7.3.4 Network Identifier Exit (SNTNIDRT)

7.3.4 Network Identifier Exit (SNTNIDRT)

This section explains how to code a network identifier exit
for the CA MICS Network Analyzer Option.

The network identifier is an eight-character variable,
NETWRKID, which is the highest (most significant)
sequence/summary variable in each CA MICS Network Analyzer
file.  Data from NPM and CA NetSpy network session accounting
and network gateway accounting supply values for NETWRKID, so
you do not need to code the SNTNIDRT exit for these data
sources.

The other data sources supported by the Analyzer do not
supply a value for this variable.  You must code a unique one
to eight-character network identifier for data from each
network processed by CA MICS.

If NPM is a data source, there are two fields that may help
you to decide the proper value for NETWRKID.  Data elements
PLUNETID and SLUNETID may contain the PLU and SLU network
IDs, respectively.  See the Data Dictionary entries for
these elements to determine if they may be of value to you.
The sample exit provided in Figure 7-7 shows a possible
method for deriving NETWRKID from PLUNETID.

The network identifier coded here appears in several places
in the CA MICS Network Analyzer:

o  As the highest qualifier in each CA MICS file

o  In the CA MICS Tabular Reports and Graphic Inquiry
   Reports

o  In SNTOPS - previously described in this chapter

The Network Identifier Exit is a user-written SAS routine
that is invoked for each input record processed.  You are
responsible for testing the accuracy of the routine.  A
sample network identifier exit routine is provided in
prefix.MICS.PARMS(SNTNIDRT).  Figure 7-7 shows the worksheet
for structuring this routine.

It is important to remember that this routine is invoked
before the SMF System Identifier (SYSID) variable has been
established.  Therefore, if you want to set NETWRKID using
the SYSID, you must use the original system identifier,
ORGSYSID, as recorded in the data.

+------------------------------------------------------------------------------+
| INSTALLATION PREPARATION WORKSHEET:  Network Identifier Exit Routine         |
|                                         Definition                           |
| PARMS Library Member is SNTNIDRT                                             |
| Reference Section:  7.3.4, CA MICS Network Analyzer Guide                    |
+------------------------------------------------------------------------------+
|                                                                              |
| /* ----------------------------------------------------------------- */      |
| /* THIS ROUTINE IS USED TO SET THE VALUE OF NETWRKID AND IS %INCLUDED*/      |
| /* AFTER CA MICS READS THE ORGSYSID BUT BEFORE THE %SYSID ROUTINE IS */      |
| /* INVOKED.  THE EXAMPLE ROUTINE, BELOW, CHECKS TO SEE (1) IF THE    */      |
| /* INPUT DATA SOURCE IS NPM AND (2) IF THE NPM                       */      |
| /* VARIABLE PLUNETID IS NOT BLANK.  IF BOTH THESE CONDITIONS ARE     */      |
| /* MET, NETWRKID IS SET TO THE VALUE OF PLUNETID;  OTHERWISE,        */      |
| /* THE VALUE OF NETWRKID IS SET ACCORDING TO THE VALUE OF ORGSYSID.  */      |
| /*                                                                   */      |
| /*   IF PRODUCT EQ 'NPM' AND NPMVRRL GE '0013' THEN                  */      |
| /*      NETWRKID = PLUNETID;                                         */      |
| /*   IF NETWRKID EQ ' ' THEN DO;                                     */      |
| /*     IF ORGSYSID='PRD1' THEN                                       */      |
| /*        NETWRKID='DCA3033A';                                       */      |
| /*     ELSE                                                          */      |
| /*     IF ORGSYSID='TST3' THEN                                       */      |
| /*        NETWRKID='NYC3081D';                                       */      |
| /*     ELSE                                                          */      |
| /*        NETWRKID='*UNKNOWN';                                       */      |
| /*   END;                                                            */      |
| /*                                                                   */      |
| /* ----------------------------------------------------------------- */      |
|                                                                              |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|     ________________________________________________________________________ |
|                                                                              |
|                                                                              |
+------------------------------------------------------------------------------+
| ....5...10...15...20...25...30...35...40...45...50...55...60...65...70..     |
+------------------------------------------------------------------------------+

 Figure 7-7.  Network Identifier Exit Routine Definition Worksheet