$$ACTION Verb Examples

The following are examples of updating the network map through the use of action verbs.

$$INSERT Example

The following $$INSERT command inserts an adjacent node into the network map.

$$INSERT
  ADJACENT.NODE=((CD.NODE2  APPLID2  ) -
           PARSESS=(5,2) -
          APPLIDS=(RAPPL1))

The output follows.

= = > * * *   START NETMAP UPDATE         * * *
= = >    DATE:  02/27/2003 TIME=14:59:26
= = >    SMUPNLGI NETLOG=NONE REQUIRED, LOGGING INACTIVE
==============================================================
*INSERT THE FOLLOWING NODE DEFINITION
$$INSERT
  ADJACENT.NODE=(( CD.NODE2  APPLID2 )    -
             PARSESS=(5,2)                -
            APPLIDS=(RAPPL1 ))
= = >    SMUP032I APPLIDS RECORD INSERTED
= = >    SMUP034I ADJACENT.NODE RECORD INSERTED
= = >    SMUP008I REQUEST SUCCESSFUL FOR NODE=CD.NODE2
============================================================

The first message, SMUPNLGI, shows that logging is not requested; therefore, IBM® Connect:Direct® does not keep a record of the transaction (except in the statistics file). The last messages indicate that the information for the specified adjacent node was successfully inserted.

$$UPDATE Example

The following $$UPDATE command updates an adjacent node in the network map by adding the RAPPL2 APPLID and changing the maximum parallel sessions to four.

$$UPDATE
  ADJACENT.NODE=(( CD.NODE2  APPLID2 )   -
          PARSESS=(4,2)                  -
         APPLIDS=(RAPPL1 RAPPL2 ))

The output follows.

= = > * * *  START NETMAP UPDATE      * * *
= = >   DATE:  02/27/2003 TIME=14:59:26
= = >   SMUPNLGI LOGGING ACTIVE - LOG DDNAME=CDLOG
===============================================================

*UPDATE THE FOLLOWING NODE DEFINITION ADDING RAPPL2
*CHANGING MAXIMUM PARALLEL SESSIONS TO FOUR (4).
$$UPDATE
  ADJACENT.NODE=(( CD.NODE2  APPLID2 )   -
           PARSESS=(4,2)                 -
           APPLIDS=(RAPPL1 RAPPL2))

= = >    SMUP032I APPLIDS RECORD UPDATED
= = >    SMUP034I ADJACENT.NODE RECORD UPDATED
= = >    SMUP008I REQUEST SUCCESSFUL FOR NODE=CD.NODE2
================================================================

The first message, SMUPNLGI, shows that logging is requested and that a record of the transaction is recorded in CDLOG. The last messages indicate that the adjacent node information was successfully updated.

$$REPLACE Example

The following $$REPLACE command deletes then inserts an adjacent node in the network map.

$$REPLACE
ADJACENT.NODE=((CD.NODE2 APPLID2) -
PARSESS=(4,2) -
APPLIDS=(RAPPL1 RAPPL2))

The output follows.

==> * * *   S T A R T   N E T M A P   U P D A T E   * * *

==> DATE: 04.02.2010  TIME=14:18:47

==> SMUPLOGI LOGGING ACTIVE - LOG DDNAME=CDLOG

======================================================================

$$REPLACE
   ADJACENT.NODE=(  -
     (CD.NODE2,APPLID2)  -
     PARSESS=(6 2) -
     APPLIDS=(RAPPL1 RAPPL2) -
   )

==> SMUP034I ADJACENT.NODE record  "DELETED ".
==> SMUP032I APPLIDS record  "INSERTED".
==> SMUP034I ADJACENT.NODE record  "INSERTED".
==> SMUP008I Request successful for Node=CD.NODE2
======================================================================

==> SMUP000I C:D Network Map processing completed.


==> DATE: 04.02.2010  TIME=14:18:47

==> * * *   E N D   N E T M A P   U P D A T E    * * *

$$DELETE Example

The following $$DELETE command deletes an adjacent node from the network map.

$$DELETE
 ADJACENT.NODE=((CD.NODE2  APPLID2) -
           PARSESS=(4,2) -
          APPLIDS=(RAPPL1 RAPPL2))

The output follows.

= = > * * *   START NETMAP UPDATE      * * *
= = >     DATE:  02/27/2003 TIME=15:09:36
= = >     SMUPNLGI NETLOG=NONE REQUIRED, LOGGING INACTIVE
=================================================================
$$DELETE
     ADJACENT.NODE=((CD.NODE2 APPLID2) -
               PARSESS=(4,2)           -
              APPLIDS=(RAPPL1 RAPPL2 ))
= = >    SMUP032I APPLIDS RECORD DELETED
= = >    SMUP034I ADJACENT.NODE RECORD DELETED
= = >    SMUP008I REQUEST SUCCESSFUL FOR NODE=CD.NODE1
================================================================

The first message, SMUPNLGI, indicates that logging is not requested, so IBM Connect:Direct does not keep a record of the transaction. The last messages indicate that the APPLIDs and adjacent node records are successfully deleted.

$$SYNTAX Example

The following $$SYNTAX command performs a syntax check on the specified nodes.

$$SYNTAX
  LOCAL.NODE=((CD.NODE1 APPLID1 ,, SUPERUSR) -
                   TCQ=( TCQ TCX  ))
 ADJACENT.NODE=((CD.NODE1  APPLID1) -
           PARSESS=(5,2)  -
          APPLIDS=(LAPPL1  LAPPL2  LAPPL3))
 ADJACENT.NODE=((CD.NODE2  APPLID2)  -
          PARSESS=(5,2) -
         APPLIDS=(RAPPL1 ))
 $$ENDSYNTAX

The output follows. The messages are numbered in the example for clarification; they are not numbered on the actual output.

           = = > * * *         START NETMAP UPDATE             * * *
           = = > DATE:  02/27/2003 TIME=13:49:16
(1)        = = > SMUPNLGI NETLOG=NONE REQUIRED, LOGGING INACTIVE
=====================================================================
           $$SYNTAX
(2)        = = > SMUP011I 'SYNTAX   ' ACTION STARTED
=====================================================================
           LOCAL.NODE=(( CD.NODE1  APPLID1  ,,  SUPERUSR) -
                       TCQ=( TCQ TCX  ))
(3)	        = = > SMUP005I  LOCAL.NODE RECORD PROCESSING NOT ALLOWED
                   BYPASSED
=====================================================================
           ADJACENT.NODE=(( CD.NODE1  APPLID1  ) -
              PARSESS=(5,2)  -
            APPLIDS=(LAPPL1  LAPPL2  LAPPL3))
(4)        = = > SMUP008I REQUEST SUCCESSFUL FOR NODE=CD.NODE1
=====================================================================
          ADJACENT.NODE=(( CD.NODE2  APPLID2 ) -
             PARSESS=(5,2)  -
          APPLIDS=(RAPPL1))
(4)       = = > SMUP008I REQUEST SUCCESSFUL FOR NODE=CD.NODE2
=====================================================================
          $$ENDSYNTAX
(5)       = = > SMUP012I 'SYNTAX   ' ACTION STOPPED
=====================================================================

The numbers in parentheses indicate:

  1. Logging is not requested; therefore, no record is kept of the transaction.
  2. Syntax check of network map control statements starts.
  3. No processing is allowed against the local node record.
  4. Requests for syntax checking on nodes are successful.
  5. Syntax checking completes.

$$VERIFY Example

The following $$VERIFY command verifies the definition of the specified adjacent node record prior to updating the network map.

$$VERIFY
 ADJACENT.NODE=((CD.NODE2 APPLID2) -
          PARSESS=(5,2)  -
          APPLIDS=(RAPPL1))
$$ENDVERIFY

The output follows. The messages are numbered in the example for clarification; they are not numbered on the actual output.

           = = > * * *      START NETMAP UPDATE     * * *
           = = >  DATE:  02/27/2003 TIME=15:35:16
(1)        = = >  SMUPNLGI NETLOG=NONE REQUIRED, LOGGING INACTIVE
=====================================================================
           $$VERIFY

(2)        = = >  SMUP011I 'VERIFY   ' ACTION STARTED
=====================================================================

           ADJACENT.NODE=(( CD.NODE2  APPLID2 ) -
              PARSESS=(5,2) -
             APPLIDS=(RAPPL1 ))
(3)        = = > SMUP092I  APPLIDS RECORD DID NOT MATCH
           = = > SMUP094I ADJACENT.NODE RECORD DID NOT MATCH
           = = > SMUP096I RECORDS DO NOT MATCH - VERIFICATION FAILED
                           FOR NODE
                  =CD.NODE2
=====================================================================

           $$ENDVERIFY

(4)        = = > SMUP012I 'VERIFY   ' ACTION STOPPED
=====================================================================

The number in parentheses indicate the following steps:

  1. Logging is not requested; therefore, no record is kept of the transaction.
  2. Verification of the node definition to the network map file has started.
  3. The APPLIDs and adjacent node records did not match the network map file definitions.
  4. Verification is complete.