The GET-CONFIGS directive An optional \[MODE\] can be specified to the right of the ":" to indicate whether synchronous or asynchronous behavior is desired. Valid values for \[MODE\] are "synchronous" and "asynchronous". If not specified, \[MODE\] defaults to "synchronous". Synchronous behavior implies that the script will block until the GC operation has completed (i.e. the operation terminates with an OK status) or abort if an error is encountered (i.e. the operation terminates with an Error status). Asynchronous behavior implies that the script will continue processing after the GC request is initiated. An example follows:
\\

Example

1. Ensure that NetMRI has the most up-to-date configurations
2. on file. The script will block until the Get Configs operation has

3. Wiki Markup

   completed since the default synchronous mode is used. \\ <span style="color: #323232">#</span> <span style="color: #323232">Ensure</span> <span style="color: #323232">that</span> <span style="color: #323232">NetMRI</span> <span style="color: #323232">has</span> <span style="color: #323232">the</span> <span style="color: #323232">most</span> <span style="color: #323232">up-to-date</span> <span style="color: #323232">configurations</span> <span style="color: #323232">on</span> <span style="color: #323232">file.</span> <span style="color: #323232">The</span> <span style="color: #323232">script</span> <span style="color: #323232">#</span> <span style="color: #323232">will</span> <span style="color: #323232">block</span> <span style="color: #323232">until</span> <span style="color: #323232">the</span> <span style="color: #323232">Get</span> <span style="color: #323232">Configs</span> <span style="color: #323232">operation</span> <span style="color: #323232">has</span> <span style="color: #323232">completed</span> <span style="color: #323232">since</span> <span style="color: #323232">the</span> <span style="color: #323232">#</span> <span style="color: #323232">synchronous</span> <span style="color: #323232">mode</span> <span style="color: #323232">is</span> <span style="color: #323232">used.</span> <span style="color: #323232">GET-CONFIGS:</span> <span style="color: #323232">#</span> <span style="color: #323232">Modify</span> <span style="color: #323232">the</span> <span style="color: #323232">interface</span> <span style="color: #323232">description</span> <span style="color: #323232">for</span> <span style="color: #323232">Fa0/1.</span> \\ <span style="color: #323232">config</span> <span style="color: #323232">t</span> <span style="color: #323232">interface</span> <span style="color: #323232">Fa0/1</span> <span style="color: #323232">description</span> <span style="color: #323232">Get</span> <span style="color: #323232">Configs</span> <span style="color: #323232">Test</span> <span style="color: #323232">end</span> \\ <span style="color: #323232">#</span> <span style="color: #323232">Request</span> <span style="color: #323232">another</span> <span style="color: #323232">Get</span> <span style="color: #323232">Configs</span> <span style="color: #323232">operation</span> <span style="color: #323232">to</span> <span style="color: #323232">audit</span> <span style="color: #323232">the</span> <span style="color: #323232">above</span> <span style="color: #323232">change.</span> <span style="color: #323232">Since</span> <span style="color: #323232">this</span> <span style="color: #323232">#</span> <span style="color: #323232">is</span> <span style="color: #323232">the</span> <span style="color: #323232">end</span> <span style="color: #323232">of</span> <span style="color: #323232">the</span> <span style="color: #323232">script</span> <span style="color: #323232">and</span> <span style="color: #323232">there</span> <span style="color: #323232">is</span> <span style="color: #323232">no</span> <span style="color: #323232">need</span> <span style="color: #323232">to</span> <span style="color: #323232">block</span> <span style="color: #323232">until</span> <span style="color: #323232">the</span> <span style="color: #323232">Get</span> <span style="color: #323232">Configs</span> <span style="color: #323232">#</span> <span style="color: #323232">operation</span> <span style="color: #323232">has</span> <span style="color: #323232">completed,</span> <span style="color: #323232">the</span> <span style="color: #323232">asynchronous</span> <span style="color: #323232">mode</span> <span style="color: #323232">is</span> <span style="color: #323232">used.</span> \\ <span style="color: #323232">GET-CONFIGS:</span> <span style="color: #323232">asynchronous</span> After script execution completes, output similar to the following can be seen in the Status Log of the Job Details Viewer: +++ 1. Action: Get Configs Test +++ 1. \[Action-Commands\] ++ Requesting on demand configuration collection (synchronous) ........ OK +++ Received TrackingID 1 .............................................. OK +++ Getting the status of TrackingID 1 ................................. PENDING +++ Sending 'Keep Alive CR/LF' ......................................... OK +++ Getting the status of TrackingID 1 ................................. QUEUED +++ Sending 'Keep Alive CR/LF' ......................................... OK +++ Getting the status of TrackingID 1 ................................. QUEUED +++ Sending 'Keep Alive CR/LF' ......................................... OK +++ Getting the status of TrackingID 1 ................................. RUNNING +++ Sending 'Keep Alive CR/LF' ......................................... OK +++ Getting the status of TrackingID 1 ................................. OK +++ 1. Sending 'config t' .............................................. OK +++ 1. Sending 'interface Fa0/1' ....................................... OK +++ 1. Sending 'description Get Configs Test' .......................... OK +++ 1. Sending 'end' ................................................... OK +++ Requesting on demand configuration collection (asynchronous) ....... OK +++ Closing session .................................................... OK

   • • Successfully ran configuration command script ***