RASC Operational Directions RASC

businessphone RASC Operational Directions RASC Remote Access Supervision and Configuration

The information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form by any means, electronic or mechanical, for any purpose, without express written permission of Ericsson Schrack AG. RASC is a software program by Ericsson Schrack AG. Ericsson Schrack AG grants you to use and display this copy of the software program and the related literature by means of a Customer s Software Licence Agreement so long as you comply with the terms and conditions of the agreement given by an authorized licensor. 1993 1994 Ericsson Schrack AG. All rights reserved. 2 RASC Operational Directions

CONTENTS 1 General 6 2 General Handling of RASC 6 2.1 Image Layout 8 2.2 Fault Information 9 2.3 Control Keys 10 2.4 Control via Mouse 10 3 Basic Image in RASC 10 3.1 Overviews 11 3.2 Selection of Function 12 Log On... 13 Systems... 13 Connect... 13 Applications... 14 Other... 14 3.3 Search for Correct Menu 15 RASC Operational Directions 3

CONTENTS 4 Functions 16 4.1 Support Functions 17 4.2 User Identity 17 4.3 Customer Database 18 Administration of Customer List...18 Contents of the Customer Database...19 Administration of the Database...20 4.4 Connect Log 21 4.5 Configuration of RASC 21 4.6 Sessions 23 Recording a new Session...24 Playback of a Session...25 Limitations...27 Administration of Sessions...28 Command-controlled Session Start...28 5 Communication with Exchanges 29 5.1 Functions 29 5.1.1 Password for the BusinessPhone Exchange...29 5.1.2 Callback (Recall)...29 5.1.3 Access...30 5.1.4 Redirection of Active Alarms...30 5.2 Handling 31 5.2.1 Connection in Interactive Mode...31 5.2.2 Connection from DOS Command Line...34 5.3 Fault Messages 35 4 RASC Operational Directions

CONTENTS 6 Configuration of Exchanges 39 6.1 Operating Cases 39 6.1.1 ON LINE Programming... 39 6.1.2 OFF LINE Programming... 41 6.1.3 Transfer of Configuration Data from the Exchange to RASC... 42 6.1.4 Transfer of Configuration Data from RASC to the Exchange... 42 6.2 Support Functions 44 6.2.1 Configuration-Data File... 44 6.2.2 Templates (Models)... 45 6.2.3 Comparison Operations... 47 6.2.4 Memory Limits Check... 48 7 Maintenance Functions for Exchanges 50 7.1 Basic Image for Maintenance 50 7.2 Handling of Data Files 51 7.3 Identification of Hardware and Software 53 7.4 Fault Logs and Warning Codes 54 7.5 General System Information 56 7.6 Special Functions 58 FIGURES Figure 1 RASC start screen... 8 Figure 2 RASC start screen with picked system... 11 Figure 3 The menu SYSTEMS /menu... 18 Figure 4 The main screen of the application Configuration... 41 Figure 5 The main screen of the application Maintenance... 50 RASC Operational Directions 5

1 GENERAL 1 GENERAL RASC is an aid for O&M (Operation and Maintenance) work in conjunction with certain BusinessPhone exchanges. RASC uses an IBM-compatible personal computer (PC). The PC is directly connected to the exchange or RASC works with a modem for remote connections. RASC also offers OFF LINE processing of data related to an exchange. RASC contributes a customer database to simplify the work of an O&M organisation that is responsible for several exchanges. There is also certain support for a work procedure whereby several people use the same PC at an O&M centre. The purpose of this document is to explain the functions of RASC and their benefits. RASC offers a support function that provides detailed information relevant to the image currently being displayed. RASC is designed for use in the interactive mode maintaining a dialogue with the user. It is also possible to specify the requested tasks on the DOS command line. Task means e.g. to make a backup of the exchange s configuration data. After RASC has completed its specified task, it returns to DOS stating a code that shows whether the execution of the task was satisfactory or not. RASC can be connected either to the relevant exchange (ON LINE) or work with files of the disk (OFF LINE). In the ON LINE mode RASC reads all data from the connected exchange and transmits changes to the exchange. In the ON LINE mode it is also possible to issue a number of commands that make sense in this mode only, for example to set the real-time clock. In the OFF LINE mode the user can inspect information collected earlier from relevant exchanges. It is also possible to change data. The idea is to use the same procedure in OFF LINE mode and ON LINE mode for reading and modifying data in the exchange. 6 RASC Operational Directions

2 GENERAL HANDLING OF RASC 2 GENERAL HANDLING OF RASC RASC uses window technique to present information. A window consists of a framed image in which information is displayed. The actual image can have many different appearances depending on the information displayed and which operations the user shall be capable to do. A common type of image is a selection menu, where the user can select from different alternatives. Another commonly occurring image comprises a list with alterable values and related text. RASC is controlled via the keyboard and a mouse. The user can move the cursor to the desired lines for selection or for entries. New values are stated alphanumerically or by selection from predefined alternatives. When window contains correct details, the user can store the information by pressing a function key marked SAVE, SEND or suchlike. If the user does not press the key (SAVE, SEND) nothing will be changed when quitting the menu. This signifies the following rules for RASC: When the cursor is moved from the relevant input field, a temporary working copy of the relevant parameter is updated (a plausibility check is often executed as well). When the user orders storage (SAVE, SEND) all values shown in the displayed image will be stored. In the ON LINE mode transmission takes place to the connected exchange, whereas in the OFF LINE mode storage takes place in a working copy of the customer file. Furthermore, in the OFF LINE mode, it is possible, on completion of configuration, to order the working copy of the file to be stored so that the alterations are made permanent. RASC Operational Directions 7

2 GENERAL HANDLING OF RASC 2.1 IMAGE LAYOUT The basic image in RASC consists of a status line at the top of the image, a function-key line at the bottom and a main image field between status line and function-key line. The status line and function key line always have the same layout whereas the main image field is organised according to requirement. Figure 1 RASC start screen The status line displays essential data and its function is to obtain a good overview of earlier selections and of the ongoing situation. The status line displays, from left to the right, the following: Customer code Individual code Operating mode Centre field This is the designation of the exchange with which RASC is working together (no customer files are opened in the above figure). The designation of relevant selected individual, e.g. directory number or similar. ON LINE or OFF LINE. Here is displayed varying information, dependent on which window is active ( STANDARD in above figure). 8 RASC Operational Directions

Wait Transmission Clock 2 GENERAL HANDLING OF RASC Indicator displays the text WORKING when RASC is executing a task that requires time to complete. Shows via symbols when message communication is ongoing and the total number of retransmissions. Displays the time on the PC clock. The function key line comprises eleven small boxes and shows in number order the relevant significance of keys F1 F10. A brief guide text indicates the purpose of the function keys. The function-key line shows the designation of the key, e.g. F4, when the key currently lacks functions. The F1 key is a permanently assigned to the help function. The eleventh box always displays the text EXIT. You will return to the previous window when clicking EXIT with the mouse. The main image field always contains a basic window. Other, smaller windows can be superimposed on this window. All windows have a frame and sometimes an inserted header. Several types of frame exist. A frame with a thickened right-hand side is used to scroll through the window. This bar is indicated, by a different colour. The arrows on the top and bottom of the bar scroll the window when clicked with the mouse. The technique employing superimposed windows is used frequently. Superimposed windows are used primarily when the information of the superimposed window is related to the image below. 2.2 FAULT INFORMATION When RASC discovers faults of various kinds it supplies a fault message. In the interactive mode a descriptive fault text is displayed in a superimposed window. This window is removed by pressing ESCAPE. If she/he presses another (any) key, the fault information will be erased, but the key is also interpreted in the same manner as if the fault information had not been displayed. RASC Operational Directions 9

2 GENERAL HANDLING OF RASC 2.3 CONTROL KEYS Basically all windows are controlled in the same manner. Dependent on (if any) special characteristics of different windows some of the keys listed below can lack function. The following keys are used to control RASC: ENTER executes selections ESCAPE return to previous window SPACE toggles choices in a list, moves cursor within an input field DEL, Ç Delete or Backspace erases character within an input field UP, DOWN moves cursor to above or below field TAB moves cursor to field on right SHIFT TAB moves cursor to field on left HOME, END moves cursor to first or last field PgUp, PgDn Page Up and Page Down moves cursor one page up or down 2.4 CONTROL VIA MOUSE You can use a mouse in addition to the control keys. Use the left mouse key to select. The following facilities offer easiest handling with a mouse: EXIT Scrolling At the far right of the function key line there is a box with the text EXIT, that gives return to the previous window (gives the same effect as pressing the key ESCAPE). Scroll with the arrows at the top and at the bottom of the bar situated on the right hand side of the window. 10 RASC Operational Directions

3 BASIC IMAGE IN RASC 3 BASIC IMAGE IN RASC The basic image in RASC consists of a status line at the top and a function key line at the bottom of the image. The basic image field, between these two lines, is divided as follows: at the top, a line for selection of function, a general overview over essential data for the selected system (customer), an overview of RASC s communication parameters. 3.1 OVERVIEWS The major part of the basic images is occupied by two overviews. It is not possible to directly alter any data in these. Figure 2 RASC start screen with picked system The lower part of the image shows the relevant values of RASC s communication parameters. If it is desired to make temporary alterations to these, select menu CONNECT /parameters. The upper part of the image shows a number of selected essential data relevant to the selected system and current operating mode. RASC Operational Directions 11

3 BASIC IMAGE IN RASC Presented information is collected each time RASC has contact with an exchange, and it is stored in the customer database. The following information is presented: System software shows the exchange s program identity. Last connected states when RASC was last connected to relevant exchange. Last backup states date stored in customer database of last backup copy. Status at connect CHECK states that alarms have been logged. OK means the logs are empty. Active alarms states whether active alarm function is used. Heartbeat states whether monitoring function heartbeat is used. Next heartbeat states time when next call to receiver of heartbeat will arrive. For ON LINE the following applies also: (a) If field Status at connect shows CHECK, the contents of the exchange s alarm logs have to be checked to find out the reason for the alarms. (b) To make optimum use of available space for fault logs in BusinessPhone exchanges these logs are to be reset after the contents have been read (menu APPLICATION /maintenance /LOGGING /reset ). 3.2 SELECTION OF FUNCTION The top line of the main image field shows which main selections can be made. Select by positioning the cursor and pressing ENTER or clicking the mouse. After that a pulldown menu offers a more precise selection. A concise orientation concerning the significance of the various main selections is provided below, while a fuller description will be provided later in this document. Log On This selection allows the user to state user name and to log off from RASC. 12 RASC Operational Directions

Systems 3 BASIC IMAGE IN RASC The system to be programmed is selected via this menu. It also contains functions for administration of the customer database if this is used. The menu embraces the following: pick select menu add new presents a list of all exchanges (customers) in the customer database provides the possibility to select an exchange (customer) by explicitly stating its customer code displays all data that has been stored for selected customer and means that all other functions for administration of the database are made accessible means that a new, empty record is opened in which the user can enter data for a new exchange (customer). Connect This selection concerns functions for communication with an exchange. The menu provides the following selection: connect orders a connection to the selected exchange. disconnect orders termination of the current connection. parameters connectlog shows the current values of RASC s communication parameters. shows details of the connections to various exchanges. Applications This menu contains the actual facilities that RASC can offer the user. The menu provides the following selection: Configuration See chapter 6 Configuration of Exchanges on page 39. Maintenance See 7 Maintenance Functions for Exchanges on page 50. RASC Operational Directions 13

3 BASIC IMAGE IN RASC Other All other functions for administration of RASC and its data files are contained in this menu. The menu provides the following selection: sessions see chapter 4.6 SESSIONS on page 23. setup special datafiles templates see chapter 4.5 CONFIGURATION OF RASC on page 21. contains diverse functions for the administration of RASC, such as: function for creation of new empty databases, function for erasure of delete marked individuals from the customer database (purge), function for erasure of old registrations from connect log (purge). shows which files (of all types) are stored for the relevant customer. shows all stored files that contain templates (models) for configuration. 3.3 SEARCH FOR CORRECT MENU Basically the user is expected to use RASC correctly by successive selections in existing selection menus. However an aid exists, both to shortcuts, if the user knows precisely what she/he wants, but also with which to search one s way forward. In the basic image and certain others a function key designated LOCA has been defined. If the user presses this, the following selections are offered: Command Pick menu Pick session If an arbitrary command number is stated, RASC will display the menu in which the command number exists. RASC displays a list in which most of the menus are listed by name. The cursor is used to indicate the desired menu. Press ENTER or click with the mouse for display of this menu. RASC shows a list where all sessions are listed by name. Indicate the desired session with the cursor and press 14 RASC Operational Directions

Pick facility Search FACs for Search HELP for Return to 3 BASIC IMAGE IN RASC ENTER or click with the mouse to play back the session. RASC shows a list of all facilities contained in the exchange. Use the cursor to mark the desired facility and press ENTER or click with the mouse to obtain a list with all commands for this facility. From this list, in the same manner, the user can select a command whereby RASC will locate the menu on which the value of the command can be read and changed. This is another way to select a facility. RASC searches all facility descriptions for the entered text, and presents a list of all facilities where a match was found. Select as in Pick facility. RASC searches all help texts for the entered string. A list of all chapters where a match was found is displayed. The function key VIEW (F2) displays the help text for the chapter under the cursor. Use ENTER to move to a particular menu. If any text is displayed after Return to then this is the name of the menu accessed by pressing ENTER or clicking with the mouse. If there is no text after Return to, then nothing will happen. RASC Operational Directions 15

4 FUNCTIONS 4 FUNCTIONS 4.1 SUPPORT FUNCTIONS RASC has a built-in support function. In each menu this support function is intended to provide the user with support (help) that is related to the displayed menu and the marker s position. It is always possible to obtain help as a concise instruction or description by pressing function key F1. This type of help is termed standard help and describes the entire image or the field at which the cursor rests. Sometimes additional help is offered. If such help exists, this is usually accessed via function key F2. This help always provides aid with more depth. The help provided can be of different kinds; it can provide the transfer to a window that contains related information or provide a further description, often related to the relevant value. When the user has finished reading the help text, he presses ESCAPE to return to the previous window. 4.2 USER IDENTITY User identity denotes a name (maximum eight characters), that identifies the user (person) who is controlling RASC. User identities are recorded in the connect log. 16 RASC Operational Directions

4 FUNCTIONS 4.3 CUSTOMER DATABASE RASC contains a database for details relevant to the customer s exchanges. This database is extremely useful to organize the storage of various types of data for many different exchanges (customers) in a clear and manageable manner. Although it is possible to run RASC without this database. Each exchange included in the database is identified by its customer code. The customer code is mandatory and is the database s primary search concept. The customer code may contain maximum eight digits and letters. Administration of Customer List The functions described below are accessible in menu SYSTEMS /menu. Figure 3 The menu SYSTEMS /menu RASC Operational Directions 17

4 FUNCTIONS Contents of the Customer Database The customer database stores all types of information related to the individual customer exchanges. The database provides support to store details intended both for normal physical customer exchanges but also for fictive exchanges. The fictive exchanges can be used as templates (models) when configuring normal exchanges. Technically speaking, certain details are stored in the database, while other details are stored in files that are independent of the database although affiliated to it in that the customer code is employed as file name. The information stored in the database is listed below. The customer database contains foremost three types of information. The essential information is used to connect RASC to the exchange locally or remote connected via the public telephone network: Telephone number Password for the exchange Port on the PC to be used (if other than standard is desired) Baud rate (if other than standard is desired) Moreover purely administrative details relevant to included customers can be stored. This information is not used by RASC, but helps the user to identify the customer. The following information is offered for customer-administration purposes: Name of customer (company) at which the exchange is installed Address Postal address Company s contact person A field for arbitrary text, e.g. notes relevant to (if any) special Conditions at the customer. Finally, a number of essential details (data) for the relevant exchange can be stored. These are normally read for each connection of the exchange. Blank fields signify that information is lacking. These details offer a quick overview of the exchange and its administration, in a concentrated and easily accessible manner: Exchange program identity. Number of extensions and trunks. Accumulated number of alarms. Time of latest backup. Time of latest connection. Which user initiated latest connection. If Callback was used for latest connection. Number of connections made from this RASC system. 18 RASC Operational Directions

Administration of the Database 4 FUNCTIONS The database is administered in one of the following four modes: VIEW to read stored details. SEEK to search for an exchange on the basis of similarity between stated text and the contents of an arbitrary field. EDIT to alter details in existing database records. ADD NEW to create new records. In the SEEK mode the user can initiate searches. The search can concern customers, e.g. where the address is known but the customer code has been forgotten, or all customers who have a certain postal address, etc. In this mode the user can place the cursor on most of the fields of the database records and state a text that she/he is searching for. The search is run by RASC comparing entered text with the contents of database record after database record. The result is a list of all matching systems, from which you can select a system. In the ADD NEW mode it is possible to create new database records. In all modes it is possible to delete existing records by using the function key DELETE. When a record is deleted it is marked as erased in the database, but the files (if any) that are affiliated to the customer, are not affected. In the menu OTHER /special there exists a function for the creation of an empty customer database (in the event the original has been destroyed), and a purge function for deletion of erased records. 4.4 CONNECT LOG Each time RASC is connected to an exchange, details are logged up in the connect log. The purpose of this log is to store a detailed history. This history is conceived as an aid for the user in various kinds of fault situations. The connect log is found in menu CONNECT /connectlog. The log saves: The exchange s customer code Time of the connection Duration of connection Type of job the connection involved RASC Operational Directions 19

4 FUNCTIONS User s name Detected communication faults (if any) Menu OTHER /special contains the function Create empty connect-log for the creation of an empty connect log and the function Purge connect-log for the deletion of old recordings. You can keep your log slim with this functions. 20 RASC Operational Directions

4 FUNCTIONS 4.5 CONFIGURATION OF RASC RASC can be configured by the user. The customer can him/herself influence how RASC is to function with regard to: Printouts adjustable page length Remote control Directory Database Customer files Presentation You can state your area code Prefix digits (e.g. if RASC is connected via an exchange to the public telephone network) Type of digit transmission (pulsing or DTMF) Initiation of connected modem Port to which modem is connected whether Callback shall be confirmed manually directory path where different types of files used by RASC are stored the user can choose if customer database and connect log shall be used the user can select the format of the list for selection of customer the user can select the number of versions to be saved of those types of files belonging to the different customers The user can choose from different language variants for help information. RASC initially assigns values to all parameters. To adapt different operating cases and to achieve greater flexibility, the user can thereafter alter the values of these parameters in one or more of the ways listed below. Certain of these listed ways apply for some of the parameters only. Init file In the init file all of the above parameters can be modified. Certain parameters can only be modified in the init file. RASC Operational Directions 21

4 FUNCTIONS Menu OTHER /setup Shows which values apply after start of RASC (except for certain communication parameters see menu CONNECT /parameters ). The values can be altered but any alterations made here are valid for the ongoing run of RASC only. Menu SYSTEMS /menu Contains the possibility to determine the value of certain communication parameters. This possibility is intended foremost for use if the customer exchanges do not use the same communication method. Menu CONNECT /parameters Shows the current setting of a number of communication parameters. The parameters can be altered. The above list is arranged in order of priority. Settings ordered in the init file have lowest priority and a setting made there will be overridden if a new value for the same parameter is issued in a manner possessing higher priority. 22 RASC Operational Directions

4 FUNCTIONS 4.6 SESSIONS Sometimes the user may have reason to repeat a programming sequence several times. For example: He may have discovered a fault in a certain software version and must check all exchanges with regard to their revision states; he wishes to configure several exchanges for a certain facility, where more or less the same commands are required. In such and similar cases a session can be beneficial. A session is an aid by which the user can record an arbitrary sequence of control orders. A name is assigned to each recording. The name is stated when a playback is desired. Select menu OTHER /sessions for all administration of sessions. Recording a new Session 1. Select menu OTHER /sessions 2. Select mode CREATE by pressing the space bar and state name (maximum eight characters) 3. Start the recording by pressing ENTER (in the START field) 4. Recording Use the normal control keys to place the marker on the menu line that contains the first control order to be included in the session. Use function key SESN (F3) to order inclusion of this menu line in the session. This registration can be executed in one of two ways: SESN (F3) ALT + SESN SHIFT + SESN records the position and data that is stated in the appurtenant input field. logs the position only. On playback the session always pauses here to wait for the user to state data. logs position and data and emulates the ENTER key on execution. Needed only in special cases. RASC Operational Directions 23

4 FUNCTIONS Move the cursor is to the next desired menu line and include it in the session as described above. Note that the user can do anything between the registrations. It is only by pressing SESN that recording takes place. The status line indicates that the recording is ongoing. It shows name NEW(n), where name denotes the name of the session and (n) how many registrations have been made so far. 5. End the recording Return to the SESSION menu and press ENTER in the STOP field. 6. Other information If the user connects/disconnects to/from a system when recording a session, this will be logged up automatically. 24 RASC Operational Directions

Playback of a Session 4 FUNCTIONS A session can be played back in two different ways: 1. Use one of the below possibilities to select the session facility 1.a Press the function key LOCA (F3) In menu LOCATE pick session is selected, whereby all recorded sessions are displayed on a list. A session can be started by placing the cursor at the desired session and then pressing ENTER. 1.b Select menu OTHER /sessions. 2. Select mode PLAYBACK. 3. Select manner of playback. The following alternatives exist: Stepping method MANUAL means manual stepping with SESN to each log position. The user has the possibility to modify data on the relevant menu line. AUTO means that the session continues automatically with the next step. The session stops in any case when the user has stated during recording that the session shall always stop. Autosave Autosave stores the data when the user leaves the current menu, without manual pressing of the function key SAVE. Rate FAST means that the recording is performed at full speed. SLOW means that the recording uses a lower speed so that the user can follow the sequence visually. Repeat Means that, by pressing SESN, the session will be restarted from the beginning after the last step has been executed. RASC Operational Directions 25

4 FUNCTIONS 4. Select session State the name of the wanted session or select BROWSER. This function lists all existing sessions. Select the session by placing the marker at the desired session and pressing ENTER. 5. Start playback of the session by pressing ENTER in field START. As indication that a session is being executed the text name m(n) is displayed on the status line. Name is the session s name and m is the sequence number for the next step in the session and (n) states the total number of steps. If the session has been defined for automatic execution, all database control orders will be executed from beginning to end without pause. Otherwise the session will stop and wait for the user to enter the information that was anticipated when the session was created. However, the user is not fully controlled, and in this pause can move the cursor manually to any other menu and use virtually any other applications. The session waits until the user presses SESN and then resumes execution with the next control order without being disturbed, e.g. by removal of the cursor to another menu. During the time the recording is going on, that is when the session s name or PAUSE is indicated on the status line, the user can press: CTRL + SESN to interrupt the session and/or, SHIFT + SESN to restart the session from the beginning, SPACE can be used on playback to set the session in the PAUSE position. Limitations Menus, where function key SESN is not stated on recording, cannot be included in a session. Normally, a session must be recorded in the mode in which it is to be played back, e.g. a session that is to be played back in ON LINE mode must also be recorded in the ON LINE mode. 26 RASC Operational Directions

Administration of Sessions 4 FUNCTIONS It is possible to list names and recording dates of all stored sessions by selecting BROWSER in the menu OTHER /sessions. This list provides an overview of all existing sessions but no direct information on their function. It is advisable to provide descriptive names. A session that is no longer of interest can be deleted from the list by pressing the function key DELETE (F6). It is possible to open a session and read the list of control orders. VIEW (F9) Use the function key F9 to read the list of control orders. EDIT (F8) Use the function key F8 to edit the list of control orders. Each control order occupies one line on the list. Menus and fields are presented by their names. It is also possible to edit the list via control orders. The user can alter the contents on an existing line and can delete or add new lines. DELETE (F6) Use the function key F6 to delete a line. INSERT (F5) The function key F5 inserts a new line. Great caution is recommended as it is easy to make errors. The main use for this editing possibility will probably be to make minor adjustments to long sessions, such as deleting an incorrect control order or maybe change the odd data value, to avoid making a new recording. Command-controlled Session Start It is possible to identify a session with the help of a parameter when RASC is started via DOS. The identified session will then start directly. This presents the opportunity to write a batch file that calls RASC and identifies automatically a session that executes a certain routine task. RASC Operational Directions 27

5 COMMUNICATION WITH EXCHANGES 5 COMMUNICATION WITH EXCHANGES Communication with BusinessPhone exchanges in the interactive mode is described in this chapter. It is also possible to start communication with BusinessPhone exchanges by entering certain parameters directly via the DOS command line. For the description of parameters, fault codes, etc. See document REFERENCES. 5.1 FUNCTIONS RASC communicates with BusinessPhone exchanges via a serial port. The line protocol is specific for BusinessPhone exchanges. The line protocol includes a check-sum function that transmits the data again if it was not received correctly. One level above the line protocol level a protocol for multiplexing divides the link into a number of virtual channels. Normally the user will not notice anything of these two protocols, except that certain fault printouts can refer to them. 5.1.1 Password for the BusinessPhone Exchange The BusinessPhone exchange requires RASC to provide the correct password for connection to be allowed. This password is defined either as a parameter when RASC is started at time of CONNECT or is fetched from the customer database. 5.1.2 Callback (Recall) You can program BusinessPhone exchanges to use the facility Callback. The BusinessPhone exchange checks the authorization by establishing a Recall to the predefined number after receiving a request for system programming. BusinessPhone offers the choice between automatic acceptance and manual confirmation of Recall. Callback with manual confirmation means that the exchange asks you if you want to proceed with the connection. 28 RASC Operational Directions

5.1.3 Access 5 COMMUNICATION WITH EXCHANGES BusinessPhone exchanges allow O&M work to be carried out from several O&M units concurrently. However only one of these units is allowed to carry out alterations and issue commands. The other units must be content to read information. Normally RASC makes all calls to BusinessPhone exchanges with full access. If the BusinessPhone exchange denies full access, the user can request a connection with readonly possibility. A parameter in menu CONNECT /parameters allows your choice. The relevant selection is displayed in the overview of the basic image. 5.1.4 Redirection of Active Alarms You can redirect all active alarms to RASC instead to the receiver defined in the BusinessPhone exchange. When the BusinessPhone exchange has succeeded in transferring the alarm to RASC, all responsibility for further administration of this alarm passes to RASC and its user. RASC indicates that it is ready to receive an active alarm through the definition of key F10 as alarm key and the text MONITOR is shown on the function key line. If an alarm is received, the text will be changed to ALARM. When this key is pressed, RASC shows the active alarms that have arrived. The function key retains the ALARM function until the user deletes the alarm(s). The alarm(s) will also be erased when RASC is logged off. The menu CONNECT /parameters contains the parameter Alarm redir to order redirection. The document RASC References tells how to define the alarm redirection in the init file. RASC Operational Directions 29

5 COMMUNICATION WITH EXCHANGES 5.2 HANDLING 5.2.1 Connection in Interactive Mode In the interactive mode, the connection to BusinessPhone exchanges is achieved from the basic image in RASC. The following sequence shall be executed: Menu LOGON State your user identity (name, signature or suchlike). Menu SYSTEMS State or select the exchange to be called. Menu CONNECT Check and change the selection of port, baud rate, etc. Select connect for connection. Select disconnect for disconnection. When modems are used, RASC normally interprets and reacts to the return codes from the modem. If for some reason this does not work as expected, RASC can be set to ignore modem codes. In that case a prompt press any key is displayed each time RASC is waiting for a modem code. The user must press a key at the right moment to make RASC continue. This mode of operation should be avoided if possible. If there are problems with the modem, the CONNECT /parameters menu has a facility to send commands to the modem. To use this facility, the correct port and baud rate must be selected. Press the function key COMM (F2) to display a menu for entering command strings, and a display for the modem response. The Hayes command AT&V can be used to read the modem settings. 30 RASC Operational Directions

5 COMMUNICATION WITH EXCHANGES The CONNECT procedure, when modems are used, can be handled in three different ways: AUTO MANUAL TRANSFER Select disconnect to interrupt the connect procedure. No action is required from the user. RASC completes the connection automatically. After RASC has sent the set-up string to the modem, the user has to dial the customer s number. When the answer tone of the customer s modem is heard, the user presses any key on the keyboard and RASC completes the connect procedure. Which means transfer by operator. When RASC has set up the modem and dialled the customer s number, RASC releases the line to the phone. When the operator answers, the user asks to be transferred to the O&M modem. When the answer tone of the modem is heard, the user presses any key on the keyboard and RASC completes the connect procedure. RASC displays the progress of the connect procedure step by step. The order and number of messages displayed depends on the selected configuration, and the list below is an example. RASC Operational Directions 31

5 COMMUNICATION WITH EXCHANGES Connect process example: Setting up modem parameters 1 Dialling number. Waiting for modem CONNECT code 1 Waiting for system response Waiting for initial SEIZE message Waiting for password request Waiting for password acknowledge Waiting for access grant Requesting additional channel Reading system status Connected On Callback the sequence is extended as below: Setting up modem parameters 1 Number dialled. Waiting for answer 1 Waiting for system response Waiting for initial SEIZE message Waiting for password request Waiting for password acknowledge (Callback is required. Continue?) 2 Hanging up 1 Waiting for Callback Call from system received Waiting for SEIZE after Callback Waiting for Callback psw request Waiting for Callback identity Waiting for password request Waiting for acknowledgement Waiting for access grant Requesting additional channel Reading system status Connected Information on disconnection On disconnection the progress of the disconnection sequence is indicated step by step: 1 This information applies for connection via modem only. When a modem is used, all return codes supplied by the modem will be shown also. A return code is always preceded by: RET:. 2 This prompt appears when only when Callback with manual confirmation is programmed. 32 RASC Operational Directions

Releasing channels Disconnecting modem 1 Disconnected 5 COMMUNICATION WITH EXCHANGES Indication of transmission/reception The status line contains two fields within square brackets [/] [nn]. [/] shows a rotating indicator when transmission/reception is in progress. [nn] shows the sum of the number of retransmissions performed between RASC and the BusinessPhone exchange. For local connection, the number of retransmissions shall be zero, if not the use of a lower baud rate should be attempted. For remote connection, the user should ensure that the number of retransmissions is small. If more than a few retransmissions take place one should disconnect and then reconnect in order to obtain a new and, hopefully, better line. 5.2.2 Connection from DOS Command Line It is also possible to order connection directly from the DOS command line. In this case the connection forms a part of a job that the user defines for RASC. The order is entered via parameters. Document REFERENCES contains a list of all parameters and some examples. Specify the working mode (type of job) by stating one of the following parameters: E Read fault information A Read all information for maintenance B Make a backup copy of the exchange s configuration data R Reload backup copy Also define the values for the following parameters: A = customer code Customer code for selected exchange U = user Name of RASC operator M = modemtype defines the connect procedure (modemtype) with or without modem. 0 AUTO The connect procedure is fully automatic. 1 MANUAL DIAL RASC expects the user to dial. 2 TRANSFER Transfer means transfer by operator. RASC assumes that an operator answers when RASC Operational Directions 33

5 COMMUNICATION WITH EXCHANGES RASC calls. RASC releases the phone line to the user, who must ask the operator to transfer the call to the system modem. RASC resumes when the transfer is complete. 3 LOCAL V24 RASC is connected locally to the exchange no modem is used. 34 RASC Operational Directions

5 COMMUNICATION WITH EXCHANGES 5.3 FAULT MESSAGES In the event of a communication fault, a fault message will be issued. If a fault occurs in the connection or disconnection sequence, the connection will be disconnected, and a fault text shows at which point (step) the fault occurred. A list of fault messages is presented below. The list is in the number order provided above and a number of tips about possible fault reasons. Setting up modem parameters Warning DSR is low. No device connected? This is a warning. The program continues. Check the connection. Modem command not accepted Check connection and programming of the connected Hayes modem. Dialling number Waiting for modem CONNECT code Check number and programming of the BusinessPhone exchange. No connection. Busy tone detected Try again. No dialtone detected Waiting for system response Waiting for initial (SEIZE message) Verify programming of Hayes modem and connection to public telephone network. Verify programming of response BusinessPhone exchange. (Foremost baud rate.) Verify programming of SEIZE message BusinessPhone exchange. No connect channel available Contact a colleague with more experience. (This may denote a design fault.) Access denied by system Same as No connect channel available. RASC Operational Directions 35

5 COMMUNICATION WITH EXCHANGES Waiting for password request Waiting for password acknowledge Verify programming of request BusinessPhone exchange (6012). Invalid password used. Password error. Port locked Password not accepted Illegal connect procedure Verify password. Too many invalid passwords. The log on is locked for certain (adjustable) time. Verify that BusinessPhone exchange permits log on in the manner now being executed. The manner in which the connection was made (e.g. via extending) is not permitted. Waiting for access grant Access locked by previous process System telephone or other PC is logged on that forbids log on with full access. Test with log on with read access only. Note: If a system telephone is logged on not even read access is permitted! Access not permitted Reading system Status Incompatible system release Programming model mismatch. Use the latest RASC version. Connected Requested access denied Received if one attempts to execute other jobs than reading when logged on with read access only. Connection failed. Carrier lost Data transmission interrupted. Try to reconnect. Completed connection failed Try to reconnect. 36 RASC Operational Directions

Waiting for Callback identity 5 COMMUNICATION WITH EXCHANGES Wrong identity in Callback Wait a few more minutes. Then try with a new connect. RASC Operational Directions 37

6 CONFIGURATION OF EXCHANGES 6 CONFIGURATION OF EXCHANGES This chapter describes the configuration of BusinessPhone exchanges with the help of RASC. The description concentrates on the operating cases (application methods) and support functions. RASC s support function gives you information for programmable parameters. 6.1 OPERATING CASES Using RASC it is possible to configure a BusinessPhone exchange in two ways. ON LINE You connect RASC to the exchange (direct connection at site or remote connection). OFF LINE The OFF LINE mode is very useful to prepare for configuration and maintenance tasks before connecting to the exchange. In OFF LINE mode the RASC processes the exchange s data without any connection to the exchange. You can store your work on the disk and transfer it to the exchange. Formats and administration of menus are generally independent of the used operating case. 6.1.1 ON LINE Programming Programming can be executed by connecting RASC directly to the BusinessPhone exchange or via a dialled connection in the public telephone network. This method of programming is called ON LINE mode. In this mode RASC fetches values for all programmable parameters directly from the exchange and, when the user orders storage of altered values, these are transferred directly to the exchange. This means that when the user selects a certain menu that displays values of programmable parameters, data needs to be transferred from the BusinessPhone exchange to RASC. Thus, it can require some time to depict the menu. The menu is illustrated in two stages. First, all permanent information such as headers and guide texts are depicted, 38 RASC Operational Directions

6 CONFIGURATION OF EXCHANGES thereafter the values of the parameters. The various menus require different times dependent on the number of parameters, how the parameters on the menu are stored in the BusinessPhone exchange and the transmission rate between exchange and PC. To reduce the time required to depict the images from the BusinessPhone exchange, RASC transfers data continuously from BusinessPhone exchange to a temporary file. This gives the possibility of fetching the required data from this file instead of from the exchange. When values are altered, this file is updated in parallel to the exchange. The transfer to the temporary files takes place at background level and consequently the user notices little of this. This transfer at background level takes place in two stages. (1) Information regarding hardware configuration, memory volume and directory number is transferred first. RASC has to complete this initial transfer before programming can start. This is the reason why the user must wait a while before commencing programming. (2) The next stage embraces the transmission of all programmable parameters. No programming is permitted during this period. Transfer of data to those menus selected by the user is given priority over transfer at background level. If the ON LINE programming proceeds long enough, all values of the programmable parameters are transferred to the temporary file. RASC asks for saving the file in the customer database, on termination of programming. A data file that is created by ON LINE programming in this manner thus contains the same information as if the user had performed a transfer to RASC after completion of programming. Figure 4 The main screen of the application Configuration RASC Operational Directions 39

6 CONFIGURATION OF EXCHANGES 6.1.2 OFF LINE Programming In the OFF LINE mode RASC is not connected to any exchange. RASC can emulate the configuration data of a BusinessPhone exchange, and consequently the user can program in the same manner as when connected. On the one hand a new (customer) exchange can be defined and programmed this according to requirements, and on the other hand a file of an existing exchange can be modified. For execution of the programming, RASC must of course later be connected to the relevant exchange and the altered configuration data be transferred. In the OFF LINE mode the exchange is represented by a configuration-data file, that contains all programmable parameters belonging to the exchange. If several configuration-data files are available, RASC will select the latest. In the event that the user is not satisfied with this file, another file can be selected. See 6.2.1 Configuration-Data File on page 44. If no configuration-data file exists RASC will ask whether a new file is to be created when the user attempts to start programming. When programming commences, the selected file will be copied to a temporary file. When a menu is to be depicted, all values are fetched from the temporary file. If the user alters any value on the menu and stores this, the temporary file will be updated with the new value and a marking is made that the data record has been altered. When the user has completed programming and selects to save his work, the contents of the temporary file will be copied to a configuration-data file. See 6.2.1 Configuration-Data File on page 44. Unique for OFF LINE mode is a menu in which the user can determine which PBAs (Printed Board Assemblies) the exchange is to contain and where these are to be situated. This menu also provides the possibility for a cold start of the virtual exchange. Cold start means that default values are assigned to all programmable parameters. The user can define own initial values. See 6.2.2 Templates (Models) on page 45. Note that the physical exchange must be configured with those PBAs that have been stated in this menu before it is permitted to transfer the file to the exchange. This irrespective of whether the user adds new PBAs or removes existing ones. The reason for this is that it is undesirable to achieve a state that the BusinessPhone exchange would comprehend as a fault situation. 40 RASC Operational Directions

6 CONFIGURATION OF EXCHANGES 6.1.3 Transfer of Configuration Data from the Exchange to RASC With the aid of RASC it is possible to transfer all programmable data in BusinessPhone exchange to a configuration-data file. The file can be saved as a backup copy or it can be used for programming in the OFF LINE mode. The transfer can be ordered from the MS-DOS command line 3 or from the menu APPLICATION /configuration /Transfer to file. 6.1.4 Transfer of Configuration Data from RASC to the Exchange With the aid of RASC it is possible to transfer the contents of a configuration-data file to the BusinessPhone exchange. This transfer can have the purpose of recreating the programming of an exchange from a backup copy, of transferring OFF-LINE programmed information or suchlike. The transfer can be ordered from the MS-DOS command line 3 or from the menu APPLICATION /configuration /Transfer to exchange. Before is permitted to commence programming, a check is executed. This check embraces: 1. that the identified file is structured as a customer data file, to prevent erroneous transfer of a word processing file or suchlike 2. that the revision state of the exchange s control program agrees with the stored revision state of the file 3. that the exchange memory houses the volume of information contained in the file 4. that the exchange s PBAs and their position agree with the information contained in the file 5. that the exchange s PBA-independent facilities and their call numbers agree with the information contained in the file. (PBA-independent facilities are those created via the commands in group 54.) The precise execution of the check depends on the selected transfer alternative. See also 6.2.2 Templates (Models) on page 45. If transfer is initiated from the MS-DOS command line the same logic as described in Transfer complete will be adhered to. The alternatives listed below exist for selection from menu Transfer to exchange. 3 The command parameters that can be entered on the MS-DOS command line are described in the document REFERENCES. RASC Operational Directions 41