Previous Section
Previous Section: Tutorials
Document HomeDocument Home
Next Section: Script Debugging
Next Section


Connecting to a Remote Host

This tutorial demonstrates Wozterm’s ability to automate interaction with NEs. Note that for this tutorial, the user must have a valid login to a DCAP, NEAS or NEM NE.

Remote Host Connection to an AXE NE

 

 

  1. Select the connect.cmd script for execution by browsing to it via File>Open, or prepare a new connect.cmd script for use by Copy/Pasting it into Wozterm from Section 6.1.2 or by typing it in manually.
  2. Script>Run. After being prompted to select a connection type (DCAP, NEAS, NEM or NEM MTP), you will be presented with the following connection dialog (with blank/default entries).

    Figure 4.2 - Remote Connection Dialog

    Remote Connection Dialog

  3. Enter the details of the host that you wish to connect to. The asterisk adjacent to the password entry field denotes secure on-screen password entry - characters will be hidden from view by asterisks. Note that you will not be able to log in if you do not have your own DCAP, NEAS or NEM account. For security reasons no generic training login could be created. Hit Ok.
  4. Once connected, you will notice that the NE commands ALLIP; and CACLP; are executed. This will add these commands to the Command History tab. Note also that the script has finished executing, however it did not disconnect from the NE (@logout, @disconnect), or unload (thanks to the @pause command). Using Section 3.4.1 as a guide, re-execute these commands using the Command History tab. Now move to a blank line in the Command History tab and enter and execute the command "ALSTP;"

    Figure 4.3 - Remote host connection to AXE

    Remote host connection to AXE

  5. Having executed several NE specific commands and receiving several sometimes cryptic responses, NE specific command help may be required. NE specific help is available to Wozterm via Wozhelp.
  6. Using Wozhelp, look up the "CACLP;" command. To do so, ensure the Exchange Vendor is "ERICSSON" and type CACLP; into the Search box. Pressing <ENTER> or clicking the Search Button will retrieve the appropriate help - you may now read detailed information on this command.
  7. If there is an NE or NEs commonly connected to by Wozterm, it will be time preserving to create a connection script to these NE(s) and alias it to a Function Key using the Wozterm Function Keys tab. In addition, common manual NE commands / sequences can be aliased to function keys. Firstly, disconnect from the current NE by executing NE>Disconnect. Unload the connect.cmd script that was left paused with the @pause command using File>Close.
  8. Using Section 3.4.5 as a guide, set up the Function Keys tab to contain short-cuts for Ctrl-F1, Ctrl-F2, Ctrl-F3 and Ctrl-F4 as follows:

    Figure 4.4 - Function Key Example

    Function Key Example

    Key

    Action Type

    Action Text

    Description

    Ctrl-F1

    RUN

    tutorials\connect.cmd – This is a fully qualified file name or a file name relative to the wozterm executable working directory.

    Connect to EGSC

    Ctrl-F2

    HOSTCMD

    ALLIP; - This is the host command to be executed. Note that it requires the semicolon.

    Print Alarm List

    Ctrl-F3

    KEYSTROKES

    CACLP; - These are the keystrokes to be sent.

    Print System time via emulated keystrokes

    Ctrl-F4

    SEND

    scommand ‘CACLP;’ – These characters are sent directly to the connected NE without interpretation by Wozterms backend. Thus the need for the "scommand" syntax.

    Print System Time via send character stream


  9. Use the newly enabled function keys to first run the connect.cmd script <Ctrl-F1>. Note that although this script still requires user input to connect to the NE, the @connect command in the script may be provided with sufficient information to automate connection.
  10. Execute the ALLIP; command using <Ctrl-F2>. As this is known by Wozterm to be a host command, no linefeed character is required - Wozterm intelligently executes the command. Note also that in the Messages tab the message "COMM : Printout header:ALARM LIST" is printed.
  11. Execute the CACLP; command using <Ctrl-F3>. Again, in the Messages tab, Wozterm has recognised the command executed, printing the message "COMM : Printout header:TIME".
  12. Execute the CACLP; command using <Ctrl-F4>. As the SEND Function Key type does not use the Wozterm backend, you will see identical output in the VT100 Terminal pane to step 11, however the Messages tab will not record the command’s execution.
  13. Disconnect from the NE as before.
   


Previous Section
Previous Section: Tutorials
Document HomeDocument Home
Next Section: Script Debugging
Next Section



This publication has been prepared and written by Telstra Corporation Limited (ACN 051 775 556), and is copyright. Other than for the purposes of and subject to the conditions prescribed under the Copyright Act, no part of it may in any form or by any means (electronic, mechanical, microcopying, photocopying, recording or otherwise) be reproduced, stored in a retrieval system or transmitted without prior written permission from the document controller. Product or company names are trademarks or registered trademarks of their respective holders.

Note for non-Telstra readers: The contents of this publication are subject to change without notice. All efforts have been made to ensure the accuracy of this publication. Notwithstanding, Telstra Corporation Limited does not assume responsibility for any errors nor for any consequences arising from any errors in this publication.