Edit Information - Last Update: N/A; Next Review: 01/27/2002

OPINFO
Number 1405
Title XIS ZRAM - Set-up/Modification Procedures
Type Information Procedure
System/Service XIS
Keywords ZRAM - Zero volatile Random Access Memory, XIS/UIS SITE, PC-0A, PC-0B

1. INTRODUCTION
Purpose of this OPINFO / Overview
This OPINFO gives the recommended procedures for ZRAM setting on one or more XIS unit/s in a site. The
site can be a mixed (XIS/UIS systems) one also. The Zram setting is essential for One-For-N mechanism of
XIS to work properly. The One-For-N mechanism deals with switchover mechanism of an failed XIS unit to
back-up unit and to release the back-up unit when the actual unit was restored.
Intended audience

GNMC; RSO

2. PLEASE NOTE ...

The procedure for ZRAM setting has to be used in the following cases:
a) When a new site is configured with a set of XIS/UIS units.
b) When there is a addition/deletion of XIS/UIS units in the site.
c) When there is an unwanted ZRAM is online in the site/unit(s).

This procedure has to be adopted even if the ZRAM setting has to be changed/modified for one of
the XIS/UIS units.

The XIS/UIS unit will show the EXCEPTION 410A 000X (where X is the XIS/UIS unit Number) during
unit reset, indicating 'Inconsistency in Zram configuration'.

In the mixed site, the back-up unit must have the UIS Flash product loaded when not in use by the
XIS.

3. PROCEDURE:

3.1 ZRAM set-up procedure:

The ZRAM set-up procedure for a site/unit through the XIS-PC is as follows:

3.1.1. ZRAM (ISM)

The system parameters include information such as PC and printer identification, E-link address, unit
switchover priority etc. The parameters can be changed using the PC ZRAM editor menu. The contents
of the RAM can be displayed by the console command /ZRAM 1.
3.1.2. Zram File Specification:

The system parameters are stored in the /fs/zram Sub Directory. The system parameter file name is as
follows: ZRAM-XXXN.gZ, Where XXX = IATA Locator Code Ex. LON
N = Sequence Number Ex .1, Z = XIS Group Number Prefixed By Character g

Note: Normally g is in lower case. The separation between ZRAM and locator code may be hyphen or
underscore. ZRAM may be prefixed by N or X.
Ex. NZRAM-LON1.g1, XZRAM-YUL1.g1

Site=UYUL1 Date: Tues Jul 10 1504 2001

UIS/XIS
PC CONSOLE

Menu 1 of 2
F1 = UIS/XISConsole F2 =Site Configuration F3 = Unix Shell F4 = UIS/XIS Products
F5 = ULPS Management F6 = Printer Management F7 = Online Help F9 = More F10 = Quit

XIS-PC Main Utility Menu : Figure 1

3.1.3. ZRAM Setting Procedure through XIS-PC:

1. Access xismenu utility by typing xismenu from Unix prompt. The screen shown in Figure 1 will be
displayed. (After root login).

2. Press F2 key to select 'Site Configuration' option. Press 1, for UIS/XIS ZRAM and press <Enter>.
The ZRAM main menu (Figure 2) will be displayed, and possible options are:

To Press
Select one of the named functions Position the cursor to a name and press F5
Specify the name of the parameter file F1 to go the filename screen
Enter parameter values F2 to go to the configuration screen
Display help texts about parameter editing Ctrl+F1 simultaneously
Exit the Zram Utility F10

3. Press F1 key to select 'FileName Screen' (Figure 3). The possible Options in this screen are:
 a) To create a new Zram File:
- Specify the Output Zram File Name to Write.
- Press F2 to go to ‘Zram Configuration’ Screen(Figure 5).
Once the configuration is finished, press F1 to come back to ‘File Screen’.
- Press F6 to save the configured Zram parameters in to specified output file.
- Press F10 to exit the Zram utility.

Build: Date: Tues Jul 10 1504 2001

Move to required screen and press F5 (or use Scrn Func key)

FILENAME SCREEN
ZRAM CONFIGURATION
ZRAM SCREEN

FILE SCRN-F1 ZRAM SCRN-F2 HLP ON EDIT? CNTRL-F1 EXIT-F10

o.k MAIN MENU

ZRAM Main Menu: Figure 2

b) To Edit/Load an existing Zram File :

- Specify the Input Zram File Name to Edit (for existing file)
- Specify the Output Zram File Name to Write
- Press F5 to load this file from the disk
- Press F2 to go to ‘Zram Configuration’ Screen(Figure 4). Once the configuration is finished,
press F1 to come back to ‘File Screen’.
- Press F6 to save the configured Zram parameters in to specified output file.
- Press F10 to exit the Zram utility.
 FILE
SPECIFICATION

Input Filename: XZRAM-YUL1.g1

Output Filename:XZRAM-YUL1.g2

LOAD F5 SAVE F6 ZRAM SCREEN F2 EXIT F10

FILENAME SCREEN

FileName Menu: Figure 3

To Press
Specify the name of the parameter file to edit Position the cursor and type a name
Load the named file from disk F5
Specify the name of the parameter file to write Position the cursor and type a name
Write the data to the named file on disk F6
Edit the parameter file F2 to go the config screen
Exit the Zram Utility F10

Note: The system parameter files are sotred in the /fs/zram directory. The names of the files in the
/fs/zram directory can be displayed by entering the command lc /fs/zram at the UNIX prompt.

3.1.4. ZRAM Configuration Screen:

The configuration screen presents the values of the system parameters for a group and permits them to
be edited. Use TAB or back tab(Numeric keypad 5) to type in the values for parameters. (to position the
cursor to a field and type in the value)
 UIS / XIS ZRAM

…………………………………VBUS…… 1 .. 2 .. 3 .. 4 .. 5 .. 6 .. 7 .. 8.
Site Name XYUL1 | HLD 4B01 4B02
One/N Group 1 | Unit Addr 00 01
ONLINE Units 2 | XIS? 1/N Pri y -1 y -2
| 1-4 y y
| 5-8 y y
Printer: Unit ASYNC? | 9-12 y y
Main 0a n | L 13-16 y y
Alt 0b n | C 17-20 y y
| ? 21-24 y y
|
FileSvr:Unit Backup |
Main 0a UNIT |
Alt 0b 09 |
…………………………………………………………………………………..
FILE SCRN F1 ZRAM TRANSMIT F3 ZRAM HELP F9 EXIT F10
ZRAM SCREEN

ZRAM Configuration Parameters Screen for Non-Mixed Site: Figure 4

3.1.5. PARAMETERS CONFIGURATION : Refer to Figure 4 above.

(a) System Parameters

The configuration fields to be filled for the XIS system parameters are:

Unit Address: This is the E-Link address of the W1657 online unit (0, 1…7).

Site Name : The site name field consists of four alpha-numeric characters, e.g. LON1.

OFN Group: This is the group number in the range 1-8. As most Sites have one group
this is normally set to 1.

Online Units : This represents the number of online UIS/XIS units within the OFN group.

Printer
Main The E-Link address of the PC to which the printer is connected.
Alternate The E-Link address of the backup PC. When there is only one PC connected the address of
the alternate PC is set to that of the main.
Asynch
This is set to Y or N. When Y (Yes) is selected all printer reports will go to the asynchronous console if
connected. If N (No) is selected the reports will go the PC console spooler. The normal selection is N
(No).

Back-Up Unit
This is the address of the backup unit of the OFN group (Enter as 09).

Fileserver
Main This field requires the E-Link address of the main disk to be accessed during the local load.
Alt This field requires the E Link address of the alternate disk to be accessed during the local load.

(b) W1657 Unit Parameters

V bus
This is the vertical bus position of an A CPU of a group. The parameters individual to each A CPU of a
group must be entered under the relevant vertical bus position. The vertical bus positions correspond to
the numbering found on the manual control panel.

HLD
This is the High Level Designator of each A CPU of a system. Though not used, the HLD for the XIS/UIS
is a mandatory field in the ZRAM.

Unit Address
This is the E-link address of an A CPU in the range 0-7. It also refers to the CDIR to be read during a
local load. The CDIR is located under the units E-Link address.

XIS
Set to Y (Yes) for an XIS unit. Could be set to N (No) in a mixed system n(No) = UIS.

1/N Priority
This specifies the switchover priority of an A CPU of a group. The range is 1-8. with 8 being the highest
priority. The highest priority is given to the unit which provides the X.25 connections.

LC
The LC fields specify the unit stuffing. Unit stuffing specifies which Line Controller boards will be
checked during the self test. The boards must be physically present in the board cage. If there is an
inconsistency a report will be sent to the printer. The fields are filled with a Y or an N.
When a Y (Yes) is set the board must be present, if an N (No is set the board need not be present.

3.1.6. ZRAM config Transmission

Transfer the parameters to the ZRAM of all units in a group including the backup unit from the
transmission screen. To display the transmission screen, from the main menu press F3.
ZRAM system parameters can be send selectively to one or more units without disturbing the others.
The actions from this screen are:

To Press
Start the transmission F3
Select the Units F4 (use the cursor up/down arrow keys to move to different units
and then press F1)
Exit the ZRAM Utility F10 (May have to press F10 more than once)

The prompt "zram parameters will not be sent to this unit" is displayed for each unit. Each unit can be
selected to receive parameters. XIS unit must be in stable state(26 or 4) to accept the Zram
configuration. The Zram can be transmitted to the selected units by pressing F3. During Transmission a
bar is displayed to show the percentage of the data transmitted to the unit. If a unit is down or the Elink
connection fails, the message 'FAILED' will be displayed besides the unit number, and in this case,
correct the connection failure and re-transmit the data.

Note: To make any Zram change take effect, each unit the parameters were sent to, must be reset.
Use /WD console command or on a unit activation of configuration from XNMS.

3.1.7. ZRAM for Mixed UIS/XIS Site:

The XIS and UIS units share the same back up unit and operate using the same One-For-N messages
and commands. XIS and UIS units can be mixed in any combination in the One-For-N scheme. The UIS
units require the FLASH.0285(or higher) to support mixed systems. The correct type of software is
loaded by the contents of the unit's CDIR file from the PC file server.

……………………………………………………………………….………………..
RCS paths: 1 2 3 4 5 6 7 8
Unit Addr: 00 00 01 ::: ::: ::: ::: :::
Link: 01 02 01 ::: ::: ::: ::: :::
Baud Rate: 0 ext 0 ext 0 ext ::: ::: ::: ::: :::
Opt. DMA: n n n ::: ::: ::: ::: :::
Lnk: 0 1sn 0 1sn 0 1sn ::: ::: ::: ::: :::

…………………………………VBUS…… 1 .. 2 .. 3 .. 4 .. 5 .. 6 .. 7 .. 8.
Site Name XYUL1 | HLD 4B01 4B02 4B03
One/N Group 1 | Unit Addr 00 01 02
ONLINE Units 2 | XIS? 1/N Pri n -1 n -2 y -3
| 1-4 y y y
| 5-8 y y y
Printer: Unit ASYNC? | 9-12 y y y
Main 0a n | L 13-16 y y y
Alt 0b n | C 17-20 y y y
| ? 21-24 y y y
|
FileSvr:Unit Backup |
Main 0a UNIT |
Alt 0b 09 |
…………………………………………………………………………………..
FILE SCRN F1 ZRAM TRANSMIT F3 ZRAM HELP F9 EXIT F10
ZRAM SCREEN

ZRAM Configuration Parameters Screen for a Mixed site : Figure 5

In the mixed site, the backup unit must have the UIS Flash product loaded when not in use by the XIS.
The PC Zram utility can be used to configure the UIS Zram system parameters. When a UIS unit is
selected, (if n is set to XIS?), Zram utility displays the eight RCS path options for degraded mode
operation. Enter the information corresponding to the RCS paths as detailed below:

RCS Paths: 4 RCS paths must be configured, and are used by all UIS units within the concerned group.
If less than 4 possible paths exist, repeat the information in subsequent paths to define all 4.

Unit Address: Elink address of a unit that supports a network connection via P3000, that will reach
RCS.
(Example: 00)

Link: Link Number (1-24) to be used during a degraded mode session. (Example: 05)

Baud rate: Code 0 to f.(Press F9 to display this table after positioning to this field)

Code Speed Code Speed

 0 external 8 600
1 19200 9 300
2 9600 a 200
3 7200 b 150
4 4800 c 110
5 3600 d 100
6 2400 e 70
7 1200 f 50

Example: If Code '0' is entered, the PC will display the information as 'ext'(means external) beside it.

Options: dma - set to 'yes' if the degraded P3000 connection uses a high speed link, and the line
processor is the HD64180 type. Otherwise set to 'no'.

lnk : Link Status Options. See the table below. (Press F9 to display this table after positioning to this
field)

Code Ad Link Extended/Not Extended

0 1 Single Not Extended
1 7 Multi Not Extended
2 1 Single Extended
3 7 Multi Extended
4 3 Single Not Extended
5 f Multi Not Extended
6 3 Single Extended
7 f Multi Extended
Example: If Code '0' is entered, the PC will display the information as 1sn (Ad=1, Link=Single, n=Not
Extended) besides the code.

3.1.8 Console commands:

The related console commands are: /ZRAM, /SWITCH, /ZSET, /ZREAD

/ZRAM - displays the actual ZRAM contents.
/ZRAM 1 - displays the ZRAM working copy.(i.e. the parameters used by the system)

4. QUICK REFERENCE
The ZRAM set-up procedure for a site through the XIS-PC was described in Section 8.6 of XIS Reference Manual.

5. COMPLEMENTARY INFORMATION
Background Technical Information

Glossary

Related OPINFO Links

Relevant documentation

Training available
-----
© SITA JCOIP, 1999. All Rights Reserved. For Internal Use Only.