4396 unisynce tl1 reference guide rev 1_12

GILLAM-FEi

Written by : C. HOUZARD Approved by : D. LEONARD Quality Assurance : Date : 24 February 2009 Doc. Ref. : 4396CHbf Revision : 1.12

UNISYNCe

TL1 REFERENCE GUIDE

GILLAM-FEi

4396CHbf – Rev. 1.12 UNISYNCe 02/24/2009 TL1 REFERENCE GUIDE

REV. DATE OBJECT MODIFIED

PAGES

1.0 21 Dec 05 Creation of document for UNISYNCe Software version 1.0

1.1 2 May 06 Update of document for UNISYNCe Software version 1.1

1.2 21 Sep 06 Update of document for UNISYNCe Software version 1.4

1.3 11 Oct 06 Update of document for UNISYNCe Software version 1.4.4

1.4 20 Dec 06 Update of document for UNISYNCe Software version 1.5

Support of new parameters:

• NTPACT (SSU data dictionary)

• CONF and FACTORYRESET (GPXM data dictionary)

• FFOFFTH, TDPLLGPS and TDPLLINP (OSC data dictionary).

1.5 25 Jan 07 Update of document for UNISYNCe Software version 1.5.2

New management of parameters:

• CONF, FACTORYRESET and SITESURVEY (GPS data dictionary).

1.6 16 Mar 07 Update of document for UNISYNCe

HISTORY SHEET

GILLAM-FEi


Software version 1.5.4

o Elevation and azimuth parameters added to the RTRV-SAT response.

o Support of new Time Zones to take into account of the new DST 2007 rules in US and Canada:

o AZERBAIJANST

o CENTRALBRAZILIANST

o CENTRALSTMEXICO

o GEORGIANST

o JORDANST

o MIDDLEEASTST

o MONTEVIDEOST

o MOUNTAINSTMEXICO

o NAMIBIAST

o PACIFICSTMEXICO.

o Delete of the following Time Zones to take into account of the new DST 2007 rules in US and Canada:

o MEXICOST

o MEXICOST2.

o Support of two new alarms affecting the SSU object:

o OSCMISSING alarm

o FPGAERR alarm.

o Modification of the alarm description text for the UDCCOMERR alarm affecting the GPS object.

1.7 6 Jun 08 Update of document for UNISYNCe Software version 1.7

Support of the E1 FeedBack Monitoring card:

• new type of output module: E1FBM

• new AID: FBM

GILLAM-FEi


• new FBM data dictionary

• new FBM <condtype> table

• new <montype> DFF

• update of the SCHED-PMREPT command

• new DFF REPT^PM message

• new FBM PDMA examples: provisioning and real time supervision.

Support of new parameters:

• WTRTIM (INP data dictionary)

• WTRTIM (GPS data dictionary).

Support of new TL1 commands: SET-TH and RTRV-TH.

Update of the INP <condtype> table.

Update of the OSC <condtype> table.

1.8 6 Aug 08 Update of document for UNISYNCe Software version 1.7.1

Support of the NTP v4 TOD protocol on the UNISYNCe TOD serial interface:

• new parameter TODACT in the SSU data dictionary to provision the TOD protocol support

• new "TOD – Time Of Day on serial interface" paragraph in the appendices to explain the format of the TOD messages and the TOD physical interface.

Update of the INP <condtype> table and of the GPS <condtype> table. A new "Input signal validation" message is now reported by the inputs and the GPS.

Update of the FBM <condtype> table. The "Bad Frequency detected" alarm which was reported by a FeedBack Monitoring object (FBM) is now replaced by a "Configuration error" alarm message.

GILLAM-FEi


1.9 28 Aug 08 Update of document for UNISYNCe Software version 1.7.2

New parameters indicating the state of the LEDs available in the following objects:

• SSU object

• INP objects

• OSC object

• GPS object.

New "LED state change" message reported from the following objects:

• SSU object

• INP objects

• OSC object

• GPS object.

Revision of the TOD Frame format documentation.

1.10 2 Sep 08 Update of document for UNISYNCe Software version 1.7.3

Support of the "MTU" parameter in the SSU object.

1.11 3 Oct 08 Update of document for UNISYNCe Software version 1.7.4

Support of a new GPSDATE event indicating the synchronization of the UNISYNCe date/time to the GPS date/time.

1.12 24 Feb 09 Update of document for UNISYNCe Software version 1.7.8

Support of a new DCF77 input module.

Support of an SNMP v1/v2c agent:

• Examples of SNMP v1/v2c agent configuration.

• New SNMP v1/v2c data dictionary.

GILLAM-FEi


TABLE OF CONTENTS

1. INTRODUCTION 1

2. MEMORY ADMINISTRATION (GR-199-CORE) 2

2.1. Introduction 2

2.2. TL1 Database Model 2 � Conceptual Database level 2 � Logical Database level 2

2.3. UNISYNC Memory administration functions 3

2.4. Message structure 3

2.5. UNISYNC Administration views 6

2.6. Memory Administration Supported TL1 messages 7 � Common Provisioning Input Commands 7

2.6.1.1. RTRV-AO 7 � Common Provisioning Autonomous Messages 9

2.6.1.2. REPT^DBCHG 9 � System Dependent Data Management Commands 11

2.6.1.3. ED-DAT 11 2.6.1.4. RTRV-NETYPE 13 2.6.1.5. RTRV-NETYPE-ALL 14 2.6.1.6. SET-SID 16

� UNISYNC Provisioning Commands 17 2.6.1.7. AID Format Description 17 2.6.1.8. Provisioning Commands 19

2.7. Data dictionaries 24

2.8. Examples of PDMA functions 24 � General comment 24 � Provisioning of the SSU object 24 � Configuration of the SNMP v1/v2c agent 24 � Provisioning of the GPS object 25 � Site Survey 26 � Provisioning of an AUX output 26 � Provisioning of an OUT output 26 � Provisioning of a group of outputs 27 � Provisioning of a Feedback Monitoring input 27 � Real time supervision of a Feedback Monitoring input 27 � Provisioning of an INP synchronization input 28 � Provisioning of the TOD serial protocol 28 � Reset of the Unisync 28 � Factory reset of the Unisync 28

GILLAM-FEi


� Forced Reference Switch 28 � Manual Reference Switch 29 � Modification of the CRAFT ports parameters 29 � Modification of some Telnet parameters 29 � Modification of some TL1MNG resources 30

3. MAINTENANCE AND SURVEILLANCE MANAGEMENT (GR833-CORE) 31

3.1. Introduction 31

3.2. Supported messages 31 � Input Commands and Responses 32

3.2.1.1. ALW-MSG 32 3.2.1.2. HELP 34 3.2.1.3. INH-MSG 35 3.2.1.4. INIT-LOG 36 3.2.1.5. INIT-REG 37 3.2.1.6. INIT-SYS 38 3.2.1.7. MENU 39 3.2.1.8. OPR-ACO 40 3.2.1.9. RTRV-ALM 41 3.2.1.10. RTRV-ATTR 43 3.2.1.11. RTRV-COND 45 3.2.1.12. RTRV-HDR 47 3.2.1.13. RTRV-LOG 48 3.2.1.14. RTRV-PM 50 3.2.1.15. RTRV-SAT 53 3.2.1.16. RTRV-TH 55 3.2.1.17. SCHED-PMREPT 57 3.2.1.18. SET-ATTR 59 3.2.1.19. SET-TH 61

� Automatic Messages 62 3.2.1.20. REPT^ALM 62 3.2.1.21. REPT^EVT 64 3.2.1.22. REPT^PM 66

4. SECURITY ADMINISTRATION (TR-NWT-835) 68

4.1. Introduction 68

4.2. Data Model of NESSA 68

4.3. UNISYNC NESSA functions 68

4.4. Message structure 69

4.5. Supported messages 70 � Security Commands 70

4.5.1.1. ACT-USER 70 4.5.1.2. ALW-USER-SECU 72 4.5.1.3. CANC-CID-SECU 73 4.5.1.4. CANC-USER 74 4.5.1.5. CANC-USER-SECU 75

GILLAM-FEi


4.5.1.6. DLT-SECU 76 4.5.1.7. DLT-USER-SECU 77 4.5.1.8. ED-CID-SECU 78 4.5.1.9. ED-CMD-SECU 79 4.5.1.10. ED-PID 80 4.5.1.11. ED-USER-SECU 81 4.5.1.12. ENT-USER-SECU 82 4.5.1.13. INH-USER-SECU 83 4.5.1.14. RTRV-ALM-SECU 84 4.5.1.15. RTRV-CID-SECU 85 4.5.1.16. RTRV-CMD-SECU 86 4.5.1.17. RTRV-STATUS 87 4.5.1.18. RTRV-USER 88 4.5.1.19. RTRV-USER-SECU 89

� Security Automatic Messages 90 4.5.1.20. REPT^ALM^SECU 90 4.5.1.21. CANC 92

4.6. Data dictionaries 93

5. APPENDICES 94

5.1. Procedure to upgrade UNISYNC software 94 � Introduction 94 � Procedure 94

5.2. Data dictionaries 95 � Equipment data dictionaries 95

5.2.1.1. SSU data dictionary 95 5.2.1.2. GPXM data dictionary 103 5.2.1.3. SNMP v1/v2c data dictionary 105 5.2.1.4. OUTMODULE data dictionary 108 5.2.1.5. GPS data dictionary 109 5.2.1.6. INP input data dictionary 116 5.2.1.7. AUX output data dictionary 121 5.2.1.8. OUT output data dictionary 123 5.2.1.9. OSC data dictionary 126 5.2.1.10. FBM data dictionary 130

� User’s interface port/channel data dictionary 133 5.2.1.11. Craft port data dictionary 133 5.2.1.12. TL1 remote manager data dictionary 136 5.2.1.13. Telnet channels data dictionary 138

� Security data dictionary 139 5.2.1.14. User-Related Security data dictionary 139 5.2.1.15. Channel-Related Security data dictionary 141 5.2.1.16. Command-Related Security data dictionary 142

5.3. List of Time Zones 143

5.4. <aid> - Access Identifier 146

5.5. <almcde> - Alarm Code 147

5.6. <almescl> - Alarm Escalation 148

GILLAM-FEi


5.7. Command Access Privilege (CAP) List 149

5.8. <conddescr> - Condition Description 151

5.9. <condtype> - Condition Types 152 � <condtype> affecting SSU card 153 � <condtype> affecting GPS 154 � <condtype> affecting AUX output ports 155 � <condtype> affecting OUT output ports 156 � <condtype> affecting INP input ports 157 � <condtype> affecting oscillator 162 � <condtype> affecting FBM input ports 163

5.10. <ctag> - Correlation Tag 164

5.11. <errcde> - Error Codes 165

5.12. <inhn> - Inhibition 168

5.13. <logctl> - Logging Control 169

5.14. <lognm> - Log Name 170

5.15. <mondat> - Monitor Date 171

5.16. <montm> - Monitor Time 172

5.17. <montype> - Monitored Parameter Types 173

5.18. <ntfcncde> - Notification Code 177

5.19. <ocrdat> - Occurrence Date 178

5.20. <ocrtm> - Occurrence Time of Day 179

5.21. <srveff> - Service Effecting 180

5.22. <state> - Entity State 181

5.23. <tid> - Target Identifier 182

5.24. TOD – Time Of Day on serial interface 183 � TOD Physical interface 183 � TOD Frame format 183

6. REFERENCES 185

GILLAM-FEi


1

1. INTRODUCTION This document presents a description of the TL1 commands that an UNISYNC supports in order to be fully TL1 manageable. The data model of the UNISYNC is introduced based on the TL1 terminology (administrative view, object entity, object instance, object attribute, data dictionary, …). All these TL1 concepts are very similar to the ones found in an object model described in UML. Four main functional areas of a TMN are covered:

• Configuration management • Fault management • Performance management • Security management

GILLAM-FEi


2

2. MEMORY ADMINISTRATION (GR-199-CORE)

2.1. Introduction

Memory administration of the UNISYNC refers to functions such as adding, deleting or altering data stored in the UNISYNC database. The input commands that request database changes in a NE (UNISYNC) are known as provisioning messages.

2.2. TL1 Database Model

The Conceptual Database level of an NE database is defined as an arrangement of the data elements into sets of one or more matrixes (or tables) called administrative views. These views provide a high-level conceptual view of the major data files in the database and identify the data elements in each file. The Logical Database level of an NE database is a set of tables in which each data item within each administrative view is defined in terms of its mnemonic representation, data type, range of permissible values (domain), function and interdata relationships. This level is presented in the form of a data dictionary.

2.2.1. Conceptual Database level

The administrative views are conceptual, representing the various data elements in the form of tables or matrixes. Each row of the tables represents an instance of an object entity of the NE that is a logical service or physical resource entity associated with the NE. Each column of the tables represents a parameter (attribute) of the object entities. Each individual attribute is called a data element. Examples of UNISYNC object entities are an equipment unit, a synchronization input, a synchronization output, …. The OS transmits to the NE various commands that cause either a query or an update of the database. These commands specify the portions of the database to be queried or modified in terms of the conceptual data forms “seen” in the administrative views.

2.2.2. Logical Database level

The logical model of NE data defines the set of administrative views a NE may have and specifies the various data items that make up each administrative view. The method of representing data at this logical level is by means of a data dictionary. For each administrative view in a NE, each data item (or parameter) is defined in terms of the following characteristics:

• The acronym or keyword that uniquely identifies the data item • The data type (e.g., alphanumeric character string, integer, Boolean or an

enumeration of specific acronyms or abbreviations) • The domain or range of values permissible for the data item • A brief description of the data item

GILLAM-FEi


3

• Restrictions (data contingencies, associations, etc.) imposed on the data item and identification of interdependencies with other data items (i.e., data items may be independent, dependent on the existence of another data item, or may be mutually exclusive with another data item.)

The data items as described in the data dictionaries are the form used within the data blocks of the memory administration message structures.

2.3. UNISYNC Memory administration functions

The following is a partial list of the PDMA (Provisioning Driven Memory Administration) functions for UNISYNC:

• Edit equipment card (SSU card, …) • Query equipment card attributes and states • Edit oscillator attributes and states • Query oscillator attributes and states • Edit GPS attributes and states • Query GPS attributes and states • Create/Edit/Delete synchronization inputs • Query synchronization inputs • Create/Edit/Delete synchronization outputs • Query synchronization outputs • Create/Edit/Delete measurement inputs • Query measurement inputs • Edit user’s interface ports/channels • Query user’s interface ports/channels

2.4. Message structure

The messages from OSs to UNISYNC are called input commands. These messages can be entered by a user at craft ports or via telnet sessions. They can also be sent from a TMN Manager on TCP/IP sessions.

General Input Command Format Command Code Block Staging Parameter Blocks Data Blocks

Verb Modifier Modifier TID AID CTAG GEN BLK

<verb> -<modifier> [-<modifier>] :[a] :b :c [:[d] [:e[:[f][:g]]]]; The command code describes the action to be performed on an object entity in the UNISYNC. The verb defines the specific action to be performed, while the modifiers indicate the nature of the object entity to be acted on. Through a small set of verbs, all memory administration tasks can be performed with a minimum of command messages. The modifiers are references to Administrative Views, whose data components are defined in the data dictionaries.

GILLAM-FEi


4

Staging Blocks

TID Target Identifier AID Access Identifier CTAG Correlation Tag GEN BLK General Block

The TID may be null, but that block may not be omitted from the input command. If the TID is received by the UNISYNC, it will be checked against the Source Identifier (SID). The GEN BLK may be omitted altogether if no blocks follow it in the input command message. The termination character (semicolon) may immediately follow the CTAG. The AID block uniquely identifies the object entity within the target UNISYNC. Functional AIDs will be used in the UNISYNC. The CTAG block contains one position-defined parameter to serve as a means of correlating an input command with its associated output response(s). The value of CTAG must either be a TL1 identifier or a non-zero decimal number, consisting of no more than six characters. The GEN BLK will be null (i.e., the GB is represented by two successive colons). All three blocks “e”, “f” and “g” apply (format used in TL1 to control the Transport NEs). Block “e” is referred to as the Common Data Block, while “f” is called the Specific Data Block and “g” is the State Block. The Common Data Block and the State Block are position-defined, while the Specific Block is keyword-defined. The Common Data Block is used for parameters needed for a large majority of instances of a command, and/or the parameter(s) in the Common Data Block puts the Specific Data Block in context. The Specific Data Block is used for parameters not used in the majority of instances or in the case where, for a given instance of a command, only a few parameters are needed from a choice of many possible parameters. The State Block is used for the state parameters (GR-1093-CORE).

UNISYNC Verbs and Abbreviations VERB ABBREV MEMORY ADMINISTRATION FUNCTION

DELETE DLT Remove completely an object entity with associated attributes, or unassign an object entity and its attributes and make the object entity ready for reinitialization.

EDIT ED Change the attributes associated with an existing object entity.

ENTER ENT Add a new object entity including associated attributes, or initialize (assign) the attributes associated with a given object entity.

RETRIEVE RTRV Retrieve specified service attributes from an object entity.

GILLAM-FEi


5

Output messages, which originate from the UNISYNC, may indicate either a completed state or an error state for the input command to which they respond. Messages that indicate a completion shall have the following general format: NORMAL RESPONSE cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG> ^^<completion_code> ([cr lf ^^^ ″<AID>|[AID] ( :<parameter block>)+) ″] [cr lf ^^^/*<optional_free_format_text>*/])* cr lf; where <completion_code>::= COMPLD (we will not support DELAY) COMPLD shall be returned upon successful completion of DLT, ED, ENT and RTRV commands submitted for immediate execution. Output messages that indicate a failure shall adhere to the following formats: DENIAL RESPONSE cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG>^DENY cr lf ^^^<error_code> ([cr lf ^^^″ (<AID>|[<AID>] (:<parameter block>)+)″] [cr lf ^^^/*<optional_free_format_text>*/])* cr lf; PARTIAL ERROR RESPONSE cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG>^PRTL ([cr lf ^^^″[<AID>]:ERCDE=<error_code>[,<parameter block>](:<parameter block>)*″] [cr lf ^^^/*<optional_free_format_text>*/])+ cr lf; PRTL shall be returned for responses to input commands specifying multiple AIDs of which only a subset have been successfully executed. If all AIDs have failed to be executed, the response shall indicate a DENY code. ACKNOWLEDGMENTS If an UNISYNC experiences an excessive delay in the processing of an input command, the UNISYNC will send an acknowledgment message indicating the pending state to the OS. The message format that indicates this In-Progress (IP) state of the input command is: IP^<CTAG> cr lf < The CTAG is the CTAG of the input command to which the acknowledgment refers. The UNISYNC continues to send IP acknowledgments at every interval of the delay period (typically 2 seconds) until the actual response is sent.

GILLAM-FEi


6

2.5. UNISYNC Administration views

• EQPT view modelling the equipment card (SSU card), the GPS, the oscillator, the synchronization inputs, the synchronization outputs or some UNISYNCe functional blocks (SNMP, …).

• CID view modelling the user’s interface ports/channels. A modifier ALL specifies all entity types (no specific address is provided).

GILLAM-FEi


7

2.6. Memory Administration Supported TL1 messages

2.6.1. Common Provisioning Input Commands

2.6.1.1.RTRV-AO

2.6.1.1.1Command format: RTRV-AO:[<tid>]::<ctag>:::<keyword>=<value>;

2.6.1.1.2Description:

RETRIEVE-AUTOMATIC_OUTPUT allows the OS to retrieve a copy of a queued autonomous message or a missing autonomous message. The UNISYNC keeps a copy of every already sent autonomous message for the purpose of later retrieval in case the message is missed by the OS. Upon an activation of the communication link, the UNISYNC passively waits for the OS to retrieve the queued messages by using the RTRV-AO command.

2.6.1.1.3Description of parameters:

Name Description

<keyword> ATAGSEQ - integral part of the ATAG of the autonomous message to be retrieved.

DBCHGSEQ - sequence number of REPT DBCHG message.

<value> Valid values are integers between 0 and 9999. Multiple or range of values can be specified by using the "&" or "&&" notation.

2.6.1.1.4Example: RTRV-AO:::SS20:::ATAGSEQ=2;

2.6.1.1.5Response format: cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG>^COMPLD [cr lf /* cr lf (<autonomous message including the message header,

GILLAM-FEi


8

but without the termination indicator, i.e., ";">)+ cr lf */] cr lf; See REPT^ALM, … for AO format details.

2.6.1.1.6Example of normal response: UNISYNCSID 05-12-22 09:16:56 M SS20 COMPLD /* UNISYNCSID 05-12-22 09:12:54 A 0002 REPT EVT EQPT "SSU:DBLOAD,TC,12-22,09-12-54,,,,\"Start WKG DB loading from PRI DB\"" */

2.6.1.1.7Note:

A deny response can occur in the following cases:

• Illegal syntax or parameter values

• Missing security permissions for this command

GILLAM-FEi


9

2.6.2. Common Provisioning Autonomous Messages

2.6.2.1.REPT^DBCHG

2.6.2.1.1Message format: <cr> <lf> <lf> ^^^<SID>^<YY-MM-DD>^<HH:MM:SS><cr> <lf> A^^<atag>^REPT^DBCHG(<cr> <lf> ^^^”b:c:d([:e])*”)+ <cr> <lf>;


REPORT^DATA_BASE_CHANGE is an immediate report to the OS(s) on the UNISYNC database changes that have occurred (results of commands, card insertion or removal, ….). The UNISYNC temporarily stores the queued autonomous messages in a log (DBCHG). Upon an activation of the communication link, the UNISYNC passively waits for the OS to retrieve the queued messages by using the RTRV-AO command.


Name Description <SID> System Identifier.

<atag> Autonomously generated correlation tag. b This block has a keyword defined format, the

list of keywords is following: TIME=HH-MM-SS DATE=YY-MM-DD SOURCE=<ctag of the original command> LINKID=<channel identifier> USERID=<name of the user who originated the command> DBCHGSEQ=<integer from 0 to 9999>

c This block contains the command code block of the original command

d AID(s) that were affected by the original command

e Describes the details of the change effected. There may be up to three blocks : the Common Block, the Specific Block and the State Block.

GILLAM-FEi


10

2.6.2.1.4 Examples:

UNISYNC 04-03-03 14:45:04 A 0663 REPT DBCHG "DATE=04-03-03,TIME=14-45-04,SOURCE=t1,LINKID=TELN, USERID=RP,DBCHGSEQ=2:ED-CID:CRAFT2::PMRFSH=1000" ;

GILLAM-FEi


11

2.6.3. System Dependent Data Management Commands

2.6.3.1.ED-DAT

2.6.3.1.1Command format:

ED-DAT:[<tid>]::<ctag>::[<DATE>][,<TIME>[,<UTC>]];


EDIT-DATE_AND_TIME instructs the UNISYNC to change its system date and time to a given value that should be interpreted as UTC or LOCAL time. Changing the system date and time may result in corruption of performance monitoring data for one or more time periods. When the UNISYNC is equipped with an In Service GPS receiver, the UNISYNC UTC time is continuously updated from the GPS. In that situation, the command ED-DAT will be denied. The conversion between UTC time and LOCAL time depends on the value of the programmable parameters DST (Daylight Saving Time) and TZ (Time Zones) (see GPXM data dictionary). All the TL1 messages generated by the UNISYNC use the local time.


Name Description

<DATE> New value of the system date in a format YY-MM-DD, where YY is the last two digits of the year ranging from 00 to 99, MM is the month of the year ranging from 01 to 12, and DD is the day of the month ranging from 01 to 31.

<TIME> New value of the system time in a format of HH-MM-SS, where HH is the hour in a 24 hour format ranging from 00 to 23, MM is the minute ranging from 00 to 59, and SS is the second ranging from 00 to 59.

<UTC> This field can take two values: • UTC: the system date and time introduced by the user is

considered as being UTC (Coordinated Universal Time).

• LOCAL: the system date and time introduced by the user is considered as being local time.

• If this field is omitted in the command, the system date and time programmed by the user is considered as being LOCAL.

GILLAM-FEi


12

2.6.3.1.4Examples: ED-DAT:::T1::05-01-12,23-59-59,UTC; ED-DAT:::T2::06-05-03,10-01-30; ED-DAT:::T3::06-04-10,02-08-09,LOCAL;

2.6.3.1.5Note:




• UNISYNC configuration with GPS and GPS set In Service

GILLAM-FEi


13

2.6.3.2.RTRV-NETYPE


RTRV-NETYPE:<tid>::<ctag>;


RETRIEVE-NETWORK_ELEMENT_TYPE retrieves the equipment related information.


There should be no parameter.

2.6.3.2.4Examples: RTRV-NETYPE:::T34;

2.6.3.2.5Response format: cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG>^COMPLD cr lf ^^^"<vendor>,<model>,<netype>,<version>" cr lf ;

Name Description <vendor> Equipment vendor name. <model> Equipment model name. <netype> Equipment type. <version> Software release version.

2.6.3.2.6Example of a normal response: UNISYNCSID 05-01-12 18:58:41 M T34 COMPLD "\"FEi\",\"UNISYNCe\",\"PRS\",\"V1.0\"" ;

2.6.3.2.7Note:




GILLAM-FEi


14

2.6.3.3.RTRV-NETYPE-ALL


RTRV-NETYPE-ALL:<tid>::<ctag>;


This command retrieves the UNISYNC inventory information.



2.6.3.3.4Examples: RTRV-NETYPE-ALL:::T34;

2.6.3.3.5Response format: cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG>^COMPLD cr lf /* cr lf <rspblk>+ */ cr lf ;

where rspblk has the format: ^^^^"<aid>,<clei>,<hwversion>,<sn>,<swversion>" cr lf

Name Description <aid> Identifies the object instance. <clei> Indicates the CLEI (Common Language Equipment Identifier) of the concerned

equipment. <hwversion> Indicates the hardware version of the installed card. <sn> Indicates the serial number of the installed card. <swversion> Indicates the version of the software installed in the card (if any).

2.6.3.3.6Example of a normal response: UNISYNCSID 05-01-12 18:58:41 M T34 COMPLD /* "SSU,\"\",\"V1.0\",\"UNIS19103-054500003\",\"\"" "GPXM,\"\",\"V1.0\",\"GPXM11901-054300003\",\"V1 .1\""

GILLAM-FEi


15

"OUTMODULE,\"\",\"V2.0\",\"E110 -060800001\", \"\"" "INP1,\"\",\"V1.0\",\"INPM24314-034600019\",\"\" " */ ;

2.6.3.3.7Note:




GILLAM-FEi


16

•

2.6.3.4.SET-SID


SET-SID:::<ctag>::<system identifier>;


This command changes the UNISYNC system identification code.


Name Description Type

<system identifier>

New system identification code. TL1 identifier, or quoted string.

2.6.3.4.4Examples: SET-SID:::T90::”New SID”;

2.6.3.4.5Note:




GILLAM-FEi


17

2.6.4. UNISYNC Provisioning Commands

2.6.4.1.AID Format Description

The AID identifies the specific instance of an object entity that is addressed by a message. The AID for each of the UNISYNC entity types will be specified as a functional identifier. AIDs in a message can be grouped so a single occurrence of a message may be applied to more than one entity (interest to minimize the number of views and so the number of messages). The grouping can be done to generate a list of AIDs or a range of AIDs: use of ampersand (&) character or .double-ampersand (&&). If the command verb modifier is ALL, then the <aid> parameter must be ALL or null. To address all entities of a given type specified by the command verb modifier, ALL is used as the AID. The first column of the following table gives the modifier for the particular object entity to be specifically identified by the AID. Verbs in all cases can include ENTER, EDIT, DELETE and RETRIEVE. The second column gives the name that is used on the message page (message description) to identify the AID parameter. The next two columns TYPE and DESCRIPTION supply additional information on the allowed values.

AID Staging Parameter Details MODIFIER(S) KEYWORD TYPE DESCRIPTION EQPT AID A/N 1. For the SSU card

SSU: identifies the UNISYNC main card. 2. For the CPU module

GPXM: identifies the GPXM module (General Purpose Xscale Module). The GPXM module is a versatile piggy-back card that must be plugged into the UNISYNC main card.

3. For the GPS GPS: identifies the GPS.

4. For the oscillator OSC: identifies the oscillator.

5. For an output module OUTMODULE: identifies the pluggable output module. This module is optional. Several types of module are available:

� 10 outputs E1/2048 Khz � 10 outputs E1/2048 Khz and

10 E1/2048 Khz Feedback Monitoring inputs

GILLAM-FEi


18

� … 6. For a synchronization input

INPn: where n varies between 1 and 2 identifies the synchronization input #n. The input module is optional and supports one input. Two input modules can be plugged into the UNISYNC main card.

7. For an AUX output AUXn: where n varies between 1 and 2 identifies the AUX synchronization output #n (1, 5 or 10 Mhz). AUX1 and AUX2 are supported by the UNISYNC main card.

8. For an OUT output OUTn: where n varies between 1 and 12 identifies the OUT synchronization output #n (E1 or 2048 Khz). OUT1 and OUT2 are supported by the UNISYNC main card. OUT3, … OUT12 are supported by an additional output module which is supplied as an option. Two types of modules are now available: E1 or E1FBM.

9. For a Feedback Monitoring input FBMn: where n varies between 3 and 12 identifies the Feedback Monitoring input #n (E1 or 2048 Khz). FBM3, … FBM12 are supported by an additional E1FBM module which is supplied as an option.

10. For the SNMP functional block SNMP: addresses the SNMP configuration parameters.

CID&CID-SECU

AID A/N 1. For a CRAFT port CRAFTn: where n varies between 1 and 2 identifies the craft port #n of the UNISYNC.

2. For a remote OS TL1MNGn: where n varies between 1 and 6 identifies the remote TL1 manager #n accessible in TCP/IP.

3. For Telnet channels TELN: identifies the Telnet channels

GILLAM-FEi


19

2.6.4.2.Provisioning Commands

2.6.4.2.1DLT-<view name>

Command format: DLT-<view name>:[<tid>]:<aid>:<ctag>;

Description:

This command deletes an object entity from the database. In order to be deleted, an object entity must have been set 00S-MA(Out Of Service).

Possible view names: EQPT,

Description of parameters:

Name Description Type <aid> Identifies the object entity. Any suitable AID(s) for

the given view. Examples: DLT-EQPT::OUT3:T1; DLT-EQPT::AUX1:T2; Note:




GILLAM-FEi


20

2.6.4.2.2ED-<view name>

Command format: ED-<view name>:[<tid>]:<aid>:<ctag>:::[f][:g];

Description:

This commands changes the attributes associated with an existing object entity. See Object-Entity Data Dictionaries for data parameters details.

Possible view names: EQPT, CID,

Description of parameters:

Name Description <tid> Target Identifier <aid> AID parameter for object entity(ies) <ctag> Correlation Tag f Specific Block (name-defined) g State Block (position-defined) : only the

desired Primary State (IS or OOS) Examples: ED-CID::CRAFT1:112:::AO=N,DATA=7,ECHO=Y,FLOW=NONE,H MI=Y; ED-EQPT::AUX1:T1::::OOS; ED-EQPT::OUT12:T2::::IS; ED_EQPT::OUT3:T7:::TYPE=S2048KHZ:IS; ED-EQPT::SSU:T3:::IPADDR=212-1-2-5,SUBNET=255-255-2 55-0; ED-EQPT::GPS:T5:::LATITUDE="50D 38M 42.386S N",LONG ITUDE="5D 33M 55.200S E"; ED-EQPT::GPS:T6:::HEIGHT="156.28m";

Note:




GILLAM-FEi


21

2.6.4.2.3 ENT-<view name>

Command format: ENT-<view name>:[<tid>]:<aid>:<ctag>[:::[f][:g];

Description:

This command creates an object entity in the database. See Object –Entity Data Dictionaries for data parameters.

Possible view names: EQPT, Description of parameters:

Name Description <tid> Target Identifier <aid> AID parameter for object entity(ies) <ctag> Correlation Tag <f> Specific Block (name-defined) <g> State Block (position-defined) : only the

desired Primary State (IS or OOS). By default : IS.

Examples: ENT-EQPT::OUT1:t1:::TYPE=E1; UNISYNCSID 05-01-03 19:02:38 M t1 COMPLD ;

ENT-EQPT::OUT4:t2:::TYPE=S2048KHZ; UNISYNCSID 05-01-03 19:02:50 M t2 COMPLD ;

ENT-EQPT::AUX1:t3:::TYPE=S10MHZ; UNISYNCSID 05-01-03 19:02:55 M t3 COMPLD ;

Note:




GILLAM-FEi


22

2.6.4.2.4 RTRV-<view name>

Command format: RTRV-<view name>:[<tid>]:<aid>:<ctag>[:[:[:[<list o f parameters>]]]];

Description: This command retrieves the data parameters and state parameters for the object entities. See Object-Entity Data Dictionaries for data parameters details. Possible view names: ALL EQPT CID Description of parameters:

Name Description <aid> Identifier of the object entity. There can be grouped values.

To retrieve all object entities in a particular view, use the value ALL in the AID field

<list of parameters>

List of any parameters present in the data dictionary of the mentioned AID. In case of using “ALL” instead of AID only parameters common to all AIDs are accepted. This list of parameter sets search conditions that limit the retrieved result set. The command response will return all the parameters of all object entities that match the specified conditions. The symbols ‘:’ and ‘,’ act as a “logical AND”, the ‘&’ and ‘&&’ act as “logical OR”.

An additional parameter in the keyword-defined block named “PARAMETER” can define a subset of parameters to be retrieved. Its value is a list of parameters combined by ‘&’ ’. The format is:

PARAMETER=<parameter1>&<parameter2>&…&<parameterN>

Examples: RTRV-CID::CRAFT1&&CRAFT2:123:::PARAMETER=PRTY&SPEED, AO=Y;

Response format: cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG> ^^<completion_code> ([cr lf ^^^ ″<AID>|[AID] ( :<parameter block>)+) ″] [cr lf ^^^/*<optional_free_format_text>*/])* cr lf; Where <parameter block> has a format: <parameter na me>=<parameter value>

GILLAM-FEi


23

Example of normal response: UNISYNCSID 03-12—2 18:08:09 M 123 COMPLD “CRAFT2:PRTY=NONE,SPEED=9600” ; Note:




GILLAM-FEi


24

2.7. Data dictionaries

The following data dictionaries are provided in the appendices:

• Equipment data dictionaries • User’s interface port/channel data dictionaries

2.8. Examples of PDMA functions

2.8.1. General comment

Any UNISYNC parameter is provisionable: • Locally from 2 craft ports (TL1/ASYNC)

o CRAFT1 (configured in local mode) o CRAFT2 (configured in local mode)

• Remotely from o 4 telnet sessions (TL1/Telnet/TCP/IP/Ethernet) o 6 TCP/IP sessions (TL1/TCP/IP/Ethernet) o 2 ASYNC sessions (TL1/ASYNC/PSTN)

� CRAFT1 (configured in remote mode) � CRAFT2 (configured in remote mode)

2.8.2. Provisioning of the SSU object

• Login ACT-USER::fei:t::fei.1;

• Modification of the network parameters ED-EQPT::SSU:t:::DHCP=N, IPADDR=192-10-7-8, GATEW=192-10-7-62; ED-EQPT::SSU:t:::SUBNET=255-255-255-0;

• Programming of the E1 output type and E1 alarming modes ED-EQPT::SSU:t:::E1TYPE=E1MF,E1SFALM=AIS,E1MFALM=SSM;

• Programming of the ID parameter ED_EQPT ::SSU :t :::ID="UNISYNC system";

• TCP/IP restart of the Unisync (needed after a modification of the network parameters)

ED-EQPT::SSU:t:::ETHRST=Y; ED-EQPT::SSU:t:::ETHRST=Y,CONF=Y;

2.8.3. Configuration of the SNMP v1/v2c agent

• By default:

GILLAM-FEi


25

o The UNISYNCe allows any SNMP managers to issue SNMP v1/v2c requests

o The report of authentication failure traps is enabled but no trap addresses are programmed

o Any programmed trap reports are formatted in SNMP v2 o The read-only access community name is set to “public” o The read-write access community name is set to “private” o The trap community name is set to “public”

• Modification of the read-only access community string ED-EQPT::SNMP:t:::ROCOMMUNITY=”my ro community name”;

• Modification of the read-write access community string ED-EQPT::SNMP:t:::RWCOMMUNITY=”my rw community name”;

• Modification of the trap community string ED-EQPT::SNMP:t:::TRAPCOMMUNITY=”my trap community name”;

• Programming of a trap destination (i.e., all the traps are sent to the remote station located at IP address 216.45.78.125)

ED-EQPT::SNMP:t:::TRAP1ADDR=216-45-78-125; • Programming of the access control (i.e., only the remote station 216.45.78.125

is authorized to issue SNMP operations) ED-EQPT ::SNMP :t :::ACCESSCTL=y ; ED-EQPT ::SNMP :t :::NMS1ADDR=216-45-78-125 ;

• Provisioning of the contact (can be controlled from SNMP) ED-EQPT::SNMP:t:::SYSCONTACT=”My contact”;

• Provisioning of the location (can be controlled from SNMP) ED-EQPT::SNMP:t:::SYSLOCATION=”My location”;

• Provisioning of the name (can be controlled from SNMP) ED-EQPT::SNMP:t:::SYSNAME= “My name” ;

• To modify the reported traps version (if necessary) ED-EQPT ::SNMP :t :::TRAPVERSION=v1 ;

• To deactivate a trap destination ED-EQPT::SNMP:t:::TRAP1ADDR=0-0-0-0;

• To remove the SNMP access control of a remote NMS ED-EQPT::SNMP:t:::NMS1ADDR=0-0-0-0;

• To disable the SNMP access control logic ED-EQPT::SNMP:t:::ACCESSCTL=N;

• To disable the report of authentication failure traps ED-EQPT::SNMP:t:::ENBAUTHTRAP=N;

2.8.4. Provisioning of the GPS object

• Programming of the antenna cable length ED-EQPT::GPS:t:::ANTCABLELGTH= 10;

GILLAM-FEi


26

• Programming of the cable length between the Up Down Converter and the Unisync

ED-EQPT::GPS:t:::SSUCABLELGTH = 20; • Programming of the mask angle

ED-EQPT::GPS:t:::MASKANGLE=15; • Manual programming of the GPS position (see also "Site Survey").

Before programming the GPS parameters, always be sure that the GPS is correctly connected to the UNISYNC and that no communication alarm is generated.

ED-EQPT::GPS:t:::HEIGHT= "140.00m"; ED-EQPT::GPS:t:::LATITUDE="10D 34M 45.090S N",LONGITUDE="24D 12M 34.800S E";

2.8.5. Site Survey

• Automatic programming of the GPS position. Before starting a site survey, always be sure that the GPS is correctly connected to the UNISYNC and that there is no communication alarm.

ED-EQPT::GPS:t:::SITESURVEY=Y;

2.8.6. Provisioning of an AUX output

• Creation of an AUX output ENT-EQPT::AUX1:t:::TYPE=S1MHZ,ALMDE=SQUELCH;

• Set it Out Of Service ED-EQPT::AUX1:t::::OOS;

• Change its type (when Out Of Service) ED-EQPT::AUX1:t:::TYPE=S5MHZ;

• Set it In Service ED-EQPT::AUX1:t::::IS;

• Set it Out Of Service ED-EQPT::AUX1:t::::OOS;

• Delete it (when Out Of Service) DLT-EQPT::AUX1:t;

2.8.7. Provisioning of an OUT output

• Creation of an OUT output ENT-EQPT::OUT5:t:::TYPE=S2048KHZ,ALMDE=SQUELCH;

• Set it Out Of Service ED_EQPT::OUT5:t::::OOS;

• Change its type (when Out Of Service) and set it In Service

GILLAM-FEi


27

ED-EQPT::OUT5:t:::TYPE=E1:IS; • Modify its E1 framing

ED-EQPT::OUT5:t:::E1TYPE=E1MF; • Set it Out Of Service

ED-EQPT::OUT5:t::::OOS; • Delete it (when Out Of Service)

DLT-EQPT::OUT5:t;

2.8.8. Provisioning of a group of outputs

• Creation of outputs OUT1, OUT2, OUT3 and OUT4 as 2048 Khz ENT-EQPT::OUT1&&-4:t:::TYPE=S2048KHZ;

• Creation of outputs OUT5, … OUT11 and OUT12 as E1 ENT-EQPT::OUT5&&-12:t:::TYPE=E1;

• Set OUT1 … OUT12 Out Of Service ED-EQPT::OUT1&&-12:t::::OOS;

• Delete OUT1 … OUT12 (When Out Of Service) DLT-EQPT::OUT1&&-12:t;

2.8.9. Provisioning of a Feedback Monitoring input

• Creation of a Feedback Monitoring input ENT-EQPT::FBM5:t:::TYPE=S2048KHZ;

• Change its type ED-EQPT::FBM5:t:::TYPE=E1;

• Set it Out Of Service ED-EQPT::FBM5:t::::OOS;

• Delete it (when Out Of Service) DLT-EQPT::FBM5:t;

2.8.10. Real time supervision of a Feedback Monitoring input

• Creation of a Feedback Monitoring input ENT-EQPT::FBM3:t:::TYPE=E1;

• Start a SCHEDULE-PERFORMANCE MONITORING REPORT SCHED-PMREPT-EQPT::FBM3:t::,,,DFF,,,,;

• REPT^PM messages are sent every 4 seconds • Stop the SCHEDULE-PERFORMANCE MONITORING REPORT

SCHED-PMREPT-EQPT::FBM3:t::,,0,DFF,,,,;

GILLAM-FEi


28

2.8.11. Provisioning of an INP synchronization input

• Creation of an INP input ENT-EQPT::INP2:t:::TYPE=S2048KHZ;

• Set it Out Of Service ED-EQPT::INP2:t::::OOS;

• Modify its type (when Out Of Service) ED-EQPT::INP2:t:::TYPE=E1SF;

• Set it In Service ED-EQPT::INP2:t::::IS;

• Change its priority ED-EQPT::INP2:t:::PRTY=2;

• Set it Out Of Service ED-EQPT::INP2:t::::OOS;

• Delete it (when Out Of Service) DLT-EQPT::INP2:t;

2.8.12. Provisioning of the TOD serial protocol

• Activation of the TOD serial protocol ED-EQPT::SSU:t:::TODACT=Y;

• Deactivation of the TOD serial protocol ED-EQPT::SSU:t:::TODACT=N;

2.8.13. Reset of the Unisync

• Force the hardware reset of the Unisync ED-EQPT::SSU:t:::RESET=Y;

• Confirm the operation as requested ED-EQPT::SSU:t:::RESET=Y,CONF=Y;

2.8.14. Factory reset of the Unisync

• Force the factory reset of the Unisync ED-EQPT::GPXM:t:::FACTORYRESET=Y;

• Confirm the operation as requested ED-EQPT::GPXM:t:::FACTORYRESET=Y,CONF=Y;

2.8.15. Forced Reference Switch

• Select reference input #2 (OSC goes to HOLDOVER if INP2 is in alarm) ED-EQPT::SSU:t:::SYNMDE=FRCD,INPFRCD=INP2;

GILLAM-FEi


29

• Select GPS reference input (OSC goes to HOLDOVER if GPS is in alarm) ED-EQPT::SSU:t:::SYNMDE=FRCD,INPFRCD=GPS;

• Return to AUTO synchronization mode ED-EQPT::SSU:t:::SYNMDE=AUTO;

2.8.16. Manual Reference Switch

o Configuration 1 � No alarm on GPS (PRTY=1, QLCUR=PRS) � No alarm on INP1 (PRTY=1, QLCUR=PRS) � No alarm on INP2 (PRTY=2, QLCUR=PRS)

ED-EQPT::SSU:t:::INPSEL=GPS; selects GPS reference input ED-EQPT::SSU:t:::INPSEL=INP1; selects reference input #1 ED-EQPT::SSU:t:::INPSEL=INP2; is denied (because of PRTY) ED-EQPT::SSU:t:::INPOVR=INP2; selects reference input #2

o Configuration 2 � No alarm on GPS (PRTY=1, QLCUR=PRS) � No alarm on INP1 (PRTY=2, QLCUR=PRS) � No alarm on INP2 (PRTY=2, QLCUR=STU)

ED-EQPT::SSU:t:::INPSEL=GPS; selects GPS reference input ED-EQPT::SSU:t:::INPSEL=INP1; is denied (because of PRTY) ED-EQPT::SSU:t:::INPOVR=INP1; selects reference input #1 ED-EQPT::SSU:t:::INPSEL=INP2; is denied (because of PRTY) ED-EQPT::SSU:t:::INPOVR=INP2; is denied (because of QLCUR)

2.8.17. Modification of the CRAFT ports parameters

• Modification of some CRAFT1 parameters ED-CID::CRAFT1:t:::SPEED=115200, PRTY=NONE, STOP=1, DATA=8;

• Modification of some CRAFT2 parameters ED-CID::CRAFT2:t:::ECHO=Y, HMI=Y;

2.8.18. Modification of some Telnet parameters

• Suppress the echo ED-CID::TELN:t:::ECHO=N;

• Suppress the generation of the Autonomous Output messages ED-CID::TELN:t:::AO=N;

GILLAM-FEi


30

2.8.19. Modification of some TL1MNG resources

• Reserve the TL1MNG1 communication resource for the remote OS (143.13.7.5)

ED-CID::TL1MNG1:t:::IPADDR=143-13-7-5; • Reserve the TL1MNG2 communication resource for the remote OS

(12.7.98.5) ED-CID::TL1MNG2:t:::IPADDR=12-7-98-5;

• Use TL1MNG3, … TL1MNG6 with other remote Oss ED-CID::TL1MNG3&&-6:t:::IPADDR=0-0-0-0;

GILLAM-FEi


31

3. MAINTENANCE AND SURVEILLANCE MANAGEMENT (GR833-CORE)

3.1. Introduction

The generic functions and messages defined in the GR833-CORE document pertain among others to the Timing Signal Generator (TSG) generic type of NE. The access parameters of the messages address a particular entity within the NE. The entity type is expressed in the final modifier in the VERB-MODIFIER-MODIFIER structure of the message. In general, the messages use a single access parameter called the AID. The AID for various types of entities will have a format or meaning appropriate for each particular entity type. The AID formats used in the UNISYNC equipment are described in the memory administration section of this document. The second (or final) of the two allowed modifiers will be one of the following:

Modifier Equivalence EQPT SSU card, GPS, Oscillator, Synchronization

inputs, Synchronization outputs, … CID CRAFT ports, remote OS channels, Telnet

channels, … ALL All entity types (no specific address is provided)

3.2. Supported messages

The messages specified are of two types: input commands and responses, and automatic messages (“autonomous messages”, “unsolicited site reports”). Message names beginning with the verb REPORT are automatic messages; the others are input commands and responses.

GILLAM-FEi


32

3.2.1. Input Commands and Responses

3.2.1.1.ALW-MSG

3.2.1.1.1Command format: ALW-MSG-<modifier>:[<tid>]:[<aid>]:<ctag>::[<ntfcnc de>],[<condtype>][,];


ALLOW-MESSAGE permits or allows the UNISYNC to resume transmission of automatic messages to an OS after having been in the INHIBIT-MESSAGE mode.

Parameters are provided to selectively enable messaging. Unreported alarms in existence at the time of resumption will be transmitted to the OS with the REPORT ALARM message. Unreported non-alarmed standing conditions in existence at the time of resumption will be transmitted to the OS with the REPORT EVENT message.

ALLOW-MESSAGE commands sent on one OS/UNISYNC or user session will not impact other sessions.

3.2.1.1.3Possible values of <modifier>:

ALL EQPT


Name Description Type <aid> Identifies the single equipment unit,

synchronization interface etc. that has an alarm condition.

Any suitable AID(s) for the given view

<ntfcncde> Notification code associated with a single alarm condition.

CR, MJ, MN, NA, NR

<condtype> A single type of alarm condition being reported.

3.2.1.1.5Examples:

ALW-MSG-EQPT::SSU:t1234:: MJ,LOGBUFROVFL-SECU;

GILLAM-FEi


33

3.2.1.1.6Note:




GILLAM-FEi


34

•

3.2.1.2.HELP


HELP:[<tid>]::<ctag>::<command verb>[,<modifier1>][ ,<modifier2>];


This command provides the help information about all the TL1 commands supported by the US5G/UNISYNC product family. Some of these commands could not be supported by the UNISYNC.


Name Description Type <command verb>

Valid UNISYNC command verb. All allowed UNISYNC command verbs

<modifier1> Valid UNISYNC command modifier

<modifier2> Valid UNISYNC command modifier

Allowed UNISYNC command modifiers. The complete command name should be valid for UNISYNC.

3.2.1.2.4Examples:

HELP:::006::ACT,USER;

3.2.1.2.5Example of normal response: UNISYNCSID 04-12-02 14:10:11 M 006 COMPLD

“Command format is:

act-user::<user_name>:<Ctag>:password”

;

3.2.1.2.6Note:




GILLAM-FEi


35

3.2.1.3.INH-MSG

3.2.1.3.1Command format: INH-MSG-<modifier>:[<tid>]:[<aid>]:<ctag>::[<ntfcnc de>],[<condtype>][,];


INHIBIT-MESSAGE instructs the UNISYNC to enter a mode in which certain automatic messages associated with a specific equipment unit, synchronization input, … are prevented from being transmitted to the OS.

This command only applies to the OS/UNISYNC or user session on which this command is sent. Parameters are provided to selectively disable messaging.

This command should not have any effect on indicators in the office where the UNISYNC resides or on the UNISYNC itself.

The condition may be restored to normal with the ALLOW-MESSAGE command.


ALL EQPT


Name Description Type <aid> Identifies the single equipment unit,

synchronization interface, … that has an alarm condition.

Any suitable AID(s) for the given view.

<ntfcncde> Notification code associated with a single alarm condition.

CR, MJ, MN, NA, NR

<condtype> A single type of alarm condition being reported.

3.2.1.3.5Examples:

INH-MSG-EQPT::SSU:t1234::MJ,LOGBUFROVFL-SECU;

3.2.1.3.6Note:




GILLAM-FEi


36

•

3.2.1.4.INIT-LOG

3.2.1.4.1Command format: INIT-LOG:[<tid>]::<ctag>::<lognm>;


The command instructs the UNISYNC to initialize a specified message log (event log, security log, event autonomous output log, UNISYNC database change log) at a specified time. When this command is executed, it does not change the current log attributes, but rather clears the contents of the existing log. Also, a copy of the command will be placed in the log.


Name Description Type <lognm> Name of the log. EVT, EVTAO, SECU,

DBCHG

3.2.1.4.4Examples:

INIT-LOG:::t167::EVTAO;

INIT-LOG:::t::EVT;

INIT-LOG:::t::SECU;

3.2.1.4.5Note:




•

GILLAM-FEi


37

•

3.2.1.5.INIT-REG

3.2.1.5.1Command format: INIT-REG-EQPT:[<tid>]:<aid>:<ctag>[::<montype>,,,,, [,]];


INITIALIZE-REGISTER instructs the UNISYNC to reset one or more storage registers or event counters associated with the synchronization inputs. INPUT FORMAT: All parameters in this command are positional.


Sign Description Formal type <aid> Identifies a synchronization object instance

(input). INP1 or INP2.

<montype> Identifies the storage register to be initialized. When TIE1S is specified, all the <montype>s are reset. When no parameter block is entered, all the <montype>s are reset.

See table.

3.2.1.5.4Examples: INIT-REG-EQPT::INP1:t1::FFOFF3s&FFOFF10S,,,,,; INIT-REG-EQPT::INP1:t2::TIE1S,,,,,; INIT-REG-EQPT::INP2:t3; INIT-REG-EQPT::INP1&INP2:t4;

3.2.1.5.5Note:




• Object instance not provisioned

• Object instance set Out Of Service The PM features are available in the UNISYNC from software V1.4.4. The GPXM module of the UNISYNC must also be equipped with 64 Mbytes of RAM.

GILLAM-FEi


38

•

3.2.1.6.INIT-SYS

3.2.1.6.1Command format: INIT-SYS:[<tid>]:<aid>:<ctag>::<ph>;


INITIALIZE-SYSTEM instructs the UNISYNC to restart the UNISYNC.


Sign Description Type

<aid> Access Identifier identifies the equipment unit that is to be initialized

SSU

<ph> Integer value that specifies the degree of thoroughness of the system initialization: in the UNISYNC, 0 specifies the “cold restart” of the SSU card

0

3.2.1.6.4Examples: INIT-SYS::SSU:005::0;

3.2.1.6.5Note:




GILLAM-FEi


39

3.2.1.7.MENU


MENU::::;


MENU instructs the UNISYNC to quit its TL1 CLI and to enter its VT100 menu-driven diagnostic user interface. This interface is backdoor password protected.

GILLAM-FEi


40

3.2.1.8.OPR-ACO

3.2.1.8.1Command format: OPR-ACO-ALL:[<tid>]::<ctag>;


OPERATE-ALARM_CUTOFF instructs the UNISYNC to cut off the office audible alarm indications without changing the local alarm indications. This command has no effect on future alarms at the UNISYNC, but rather will direct the UNISYNC to provide conditioning only on those alarms that are currently active. The ACO retires the Central Office (CO) alarm audible indicators without clearing indicators that the trouble still exits.


None

3.2.1.8.4Examples: OPR-ACO-ALL:::t123;

3.2.1.8.5Note:




GILLAM-FEi


41

3.2.1.9.RTRV-ALM

3.2.1.9.1Command format: RTRV-ALM-<view name>:[<tid>]:[<aid>]:<ctag>[::,,,,[ ,]];


RETRIEVE-ALARM instructs the UNISYNC to retrieve and send the current status of its alarm conditions associated with one or more equipment units, synchronization inputs, … The command may be used to retrieve UNISYNC information, which in turn may be used to update an OS database when it is suspected that autonomous alarm messages issued by the UNISYNC using REPORT ALARM were not received or properly processed. It may also be used to evaluate the system before or after UNISYNC maintenance operations.

3.2.1.9.3Possible view names:

ALL, EQPT,


None.

3.2.1.9.5Examples: RTRV-ALM-ALL:::t1::,,,,; RTRV-ALM-ALL:::t2; RTRV-ALM-EQPT::INP1:t3; RTRV-ALM-EQPT::OUT2:t4;

3.2.1.9.6Response format:

The response format depends on whether any alarm conditions exist to report. <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> M^^<ctag>^COMPLD <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”<aid>:<ntfcncde>,<condtype>,<srveff>,<ocrdat>,< ocrtm>:<conddescr>” <cr> <lf>

GILLAM-FEi


42

The normal response must contain at least one occurrence of <rspblk> if there is at least one alarm condition to report. It is allowed to contain multiple <rspblk>s.

Name Description <aid> Identifies the single equipment unit, synchronization interface, … that has

an alarm condition <ntfcncde> 2-character notification code associated with a single alarm condition <condtype> Single type of alarm condition being reported <srveff> Effect on service caused by the alarm condition <ocrdat> Date when the event occurred <ocrtm> Time when the event occurred <conddescr> Detailed text description of the trouble. This field is limited to 64 characters

enclosed with escaped quotes (\”) for a maximum of 68 characters (counting the escaped quotes).

3.2.1.9.7Example of normal response: UNISYNCSID 03-01-27 19:22:20 M 123 COMPLD "SSU:MN,LOGBUFR90-SECU,NSA,03-01,17-44-04:\"Secu rity log buffer 90% full\"" "SSU:MJ,LOGBUFROVFL-SECU,NSA,03-01,17-44-05:\"Se curity log buffer overflow\"" ;

3.2.1.9.8Note:




GILLAM-FEi


43

•

3.2.1.10.RTRV-ATTR

3.2.1.10.1Command format: RTRV-ATTR-<modifier>:[<tid>]:[<aid>]:<ctag>::,[<con dtype>],,[,];


RETRIEVE-ATTRIBUTE instructs the UNISYNC to send the current attributes associated with the specified events. This command may be used to review these attributes before making new settings with the SET-ATTRIBUTE.


ALL EQPT


Name Description Type <aid> Identifies the equipment unit, synchronization

input depending on the command code modifier, to which the specified event pertains.


<condtype> Type of event for which the current attributes are being retrieved.

Any valid condition type.

3.2.1.10.5Examples: RTRV-ATTR-EQPT::SSU:TT2::,LOGBUFR90-SECU,,;

3.2.1.10.6Response format: Response message has the followed format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> M^^<ctag>^COMPLD <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”<aid>:<ntfcncde>,<condtype>,,,,<srveff>,<logctl >, <almescl>, <escltim>” <cr> <lf>

GILLAM-FEi


44

The normal response must contain at least one occurrence of <rspblk> if there is at least one set of attributes to report. It is allowed to contain multiple <rspblk>s.

Name Description <aid> Identifies the equipment unit, the synchronization input, … for the requested

event. <ntfcncde> Notification code specifies the type of notification to be generated by the

UNISYNC on the occurrence of the event described in <condtype>. <condtype> Identifies the type of event for which a notification attribute (<ntfcncde>) is

being changed. <srveff> Effect on service caused by the standing or alarm condition. <logctl> Indicates if the generated notification must be logged or not. <almescl> Indicates if the alarm condition must be escalated after the time specified in

<escltim>. <escltim> Specifies the time expressed in hours after which an alarm will be escalated

to the next higher severity level.

3.2.1.10.7Example of normal response: UNISYNCSID 05-01-03 21:12:23 M TT2 COMPLD «SSU:MN,LOGBUFR90-SECU,,,,NSA,LOG,NESCL,0» ;

3.2.1.10.8Note:




GILLAM-FEi


45

3.2.1.11. RTRV-COND

3.2.1.11.1Command format: RTRV-COND-<modifier>:[<tid>]:[<aid>]:<ctag>[::,,[,] ];


RETRIEVE-CONDITION instructs the UNISYNC to return the current standing condition and state associated with one or more specified equipment units, interfaces, synchronization inputs, …


ALL EQPT


Name Description

<aid> Identifies the equipment unit, synchronization input, … to which the specified event pertains.

3.2.1.11.5Examples: RTRV-COND-ALL:::T1::,,,; RTRV-COND-ALL:::T2; RTRV-COND-EQPT::GPS:T3;

3.2.1.11.6Response format:

Response message has the following format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> M^^<ctag>^COMPLD <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”<aid>:[<ntfcncde>],<typerep>,<srveff>,<ocrdat>, <ocrtm>,,,,<conddescr>,<inhn>” <cr> <lf>

GILLAM-FEi


46

Name Description <aid> Identifies the equipment unit, the synchronization input, … to which the

condition given by the <typerep> parameter below pertains. <ntfcncde> Two-character notification code. It governs the type of notification

generated by the UNISYNC for this condition when it occurs. <typerep> Type of indication or entity state being reported on this line of the message.

Valid values can be any specific <condtype> or <state>. <condtype> can be of the form T-x for a threshold violation on <montype>x.

<srveff> Effect on service caused by the alarm or status condition. <ocrdat> Date when the triggering event occurred. <ocrtm> Time of day when the triggering event occurred. <conddescr> Detailed text description of the condition or state. <inhn> Indicates if an inhibition is in effect or not.

3.2.1.11.7Note:




GILLAM-FEi


47

3.2.1.12. RTRV-HDR


RTRV-HDR:[<tid>]::<ctag>;


RETRIEVE-HEADER requests that the UNISYNC simply replies with a normal response indicating COMPLD. The information of interest in the reply is the reply itself, along with information that the UNISYNC has about itself, namely the SID, the <date> and the <time>.


None

3.2.1.12.4Examples: RTRV-HDR:::0123;

3.2.1.12.5Example of normal response: UNISYNCSID 05-01-03 13:25:09 M 0123 COMPLD ;

3.2.1.12.6Note:




GILLAM-FEi


48

3.2.1.13.RTRV-LOG

3.2.1.13.1Command format: RTRV-LOG:[<tid>]::<ctag>::<lognm> [,<nbmsg>];


RETRIEVE-LOG instructs the UNISYNC to retrieve the contents of an existing message log.

The UNISYNC supports four logs: • Event log to save the events and alarms (size: 1100 events) • AO log to save the Autonomous Output TL1 messages (size: 400 events) • DBCHG log to save the REPT^DBCHG TL1 messages (size: 400 events) • Secu log to save the security TL1 messages (size: 100 events).

This information is available up to the next UNISYNC reset. It is also possible to issue a RTRV-AO TL1 command to selectively retrieve messages from the AO log or from the DBCHG log based on a range of ATAGSEQ or DBCHGSEQ values.



<lognm> Name of the log. EVT, EVTAO, SECU, DBCHG

<nbmsg> Indicates the number of messages the user wants to retrieve from the log. If not specified, the complete log is retrieved.

Decimal number

3.2.1.13.4Examples:

;RTRV-LOG:::tt1::SECU, 5;

;RTRV-LOG:::t::EVT;

;RTRV-LOG:::t::EVTAO,100;

;rtrv-log:::t::dbchg;

3.2.1.13.5Response format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> M^^<ctag>^COMPLD <cr> <lf> <rspblk> + ; where <rspblk> has the format:

GILLAM-FEi


49

^^^”<lognm>” <cr> <lf> ^^^/* <contents of message log> */ <cr> <lf>

The normal response must contain at least one occurrence of <rspblk>. It is allowed to contain multiple <rspblk>s if applicable.

3.2.1.13.6Note:




GILLAM-FEi


50

•

3.2.1.14.RTRV-PM

3.2.1.14.1Command format: RTRV-PM-EQPT:[<tid>]:[<aid>]:<ctag>::<montype>,,,,[<tmper>] ,[<mondat>][,<montm>];


RETRIEVE-PERFORMANCE_MONITORING instructs the UNISYNC to send its current set of PM data associated with the synchronization inputs and the oscillator.

It may be used when it is suspected that automatic PM messages issued using REPORT PM were not received or properly processed. Parameters are provided to retrieve past PM data (history of PM information).

It is suggested in the GR-1244-CORE that the NE supports a data storage scheme that allows user-access to PM parameters in the current and previous 15-minute and 1-day periods, as well as in the 31 next-most-recent 15-minute periods and (possibly) the six next-most-recent 1-day periods.

The UNISYNC stores in its data base :

• The 31 next most recent 15 minute periods for each of the PM parameters (average value in the 15-minute interval for a fast varying PM parameter) (FFOFF, MRTIE, LMRTIE, TDEV, FREQCORR)

• The max values of the following PM parameters in a 1-hour period for two days (FFOFF, MRTIE, LMRTIE, TDEV)

• The min values of the following PM parameters in a 1-hour period for two days (FFOFF, MRTIE, LMRTIE, TDEV)

• The TIE parameter for one day (TIE1S) • The min/average/max values of the oscillator commands in a 1-hour period for six

days (FREQCORR) • The average values of the oscillator commands in a 1-day period for thirty-two days

(FREQCORR) • The max values of the oscillator commands in a 1-day period for thirty-two days

(FREQCORR) • The min values of the oscillator commands in a 1-day period for thirty-two days

(FREQCORR)

The PM features are available in the UNISYNC from software V1.4.4. The GPXM module of the UNISYNC must also be equipped with 64 Mbytes of RAM.

GILLAM-FEi


51


Sign Description Type <aid> Identifies a synchronization object instance INP1 or INP2 for a

synchronization input. OSC for the oscillator.

<montype> Specifies the type of monitored parameter for which a value is requested.

See <montype> table.

<tmper> Specifies the accumulation time period for the PM information.

1S, 15M, 1H, 1D

<mondat> Date of the beginning of the requested PM period specified in <tmper>.

YY-MM

<montm> Beginning time of day of the requested PM period specified in <tmper>.

HH-MM

3.2.1.14.4Examples: RTRV-PM-EQPT::INP1:WWW::FFOFF3S,,,,15M; RTRV-PM-EQPT::INP1:t2::TDEV100S,,,,15M; RTRV-PM-EQPT::INP1:t3::TDEV100S-C,,,,1H; RTRV-PM-EQPT::INP2:t4::TIE1S,,,,1S,06-09,10-00; RTRV-PM-EQPT::OSC:t5::FREQCORR,,,,1H; RTRV-PM-EQPT::OSC:t6::FREQCORR-F,,,,1H; RTRV-PM-EQPT::OSC:t7::FREQCORR-C,,,,1H;

3.2.1.14.5Response format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> M^^<ctag>^COMPLD <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”<aid>:<montype>,<monval>,[<vldty>],,,[<tmper>], [<mondat>][,<montm>]” <cr> <lf>

Name Description <aid> Identification of the synchronization object instance (input, oscillator). <montype> Indicates the type of monitored parameter for which a value is being

retrieved. <monval> Measured value of the monitored parameter. <vldty> Validity indicator for the reported PM data. <tmper> Indicates the accumulation time period for the PM information. <mondat> Date of the beginning of the PM period specified in <tmper>. <montm> Beginning time of day of the PM period specified in <tmper>.

GILLAM-FEi


52

3.2.1.14.6 Example of normal response: UNISYNC 06-10-09 15:37:18 M WWW COMPLD “INP1:FFOFF3S,0.2,COMPL,,,15M,10-09,15-00” “INP1:FFOFF3S,0.3,COMPL,,,15M,10-09,15-15”

“INP1:FFOFF3S,0.2,COMPL,,,15M,10-09,15-30”

3.2.1.14.7Note:




GILLAM-FEi


53

3.2.1.15.RTRV-SAT


RTRV-SAT:<tid>::<ctag>;


This command retrieves information about the satellites managed by the GPS receiver.

It gives indication about the satellite visibility and tracking status:

• NBSATVISIBLE: number of visible sats 0..32

• NBGPSTRACKED: number of satellites tracked 0..32 For each of the GPS receiver channels:

• SATID: ID of the satellite 0..37

• CNO: carrier to noise density ratio 0..255 dB-Hz

• TYPE: type of GPS GPS or GLONASS

• TIMING: used for timing Y or N

• ELV: elevation 0..90 deg

• AZM: azimuth 0..359 deg



3.2.1.15.4Examples: RTRV-SAT:::T34;

3.2.1.15.5Response format: cr lf lf ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> cr lf M^^<CTAG>^COMPLD cr lf /* cr lf ^^^"NBSATVISIBLE=<visiblesat>,NBGPSTRACKED=<sattrac ked>" cr lf <rspblk>* */ cr lf ;

GILLAM-FEi


54

where rspblk has the format: ^^^^"SATID=<id>,CNO=<cno>,TYPE=<type>,TIMING=<y/n>,ELV=<elv>, AZM=<azm>" cr lf

3.2.1.15.6Example of a normal response: UNISYNCSID 05-01-12 18:58:41 M T34 COMPLD /* "NBSATVISIBLE=5,NBGPSTRACKED=5" "SATID=11,CNO=46,TYPE=GPS,TIMING=Y,ELV=55,AZM=28 0" "SATID=14,CNO=45,TYPE=GPS,TIMING=Y,ELV=38,AZM=93 " "SATID=19,CNO=37,TYPE=GPS,TIMING=Y,ELV=58,AZM=16 3" "SATID=28,CNO=44,TYPE=GPS,TIMING=Y,ELV=25,AZM=30 3" "SATID=22,CNO=45,TYPE=GPS,TIMING=Y,ELV=29,AZM=54 " */ ;

3.2.1.15.7Note:




•

GILLAM-FEi


55

•

3.2.1.16.RTRV-TH

3.2.1.16.1Command format: RTRV-TH-ALL:[<tid>]:[<aid>]:<ctag>[::<montype>,[,]] ; RTRV-TH-EQPT:[<tid>]:[<aid>]:<ctag>[::<montype>,[,] ];


RETRIEVE-THRESHOLD instructs the UNISYNC to send the current threshold level of one or more monitored parameters for which violation will trigger an automatic message. The threshold levels may apply to one or more synchronization objects (input or oscillator).


Name Description Type <aid> Identifies a synchronization object instance

(input, osc). There can be grouped parameters. Any “EQPT” aid

<montype> Identifies the particular monitored parameter for which threshold level is being retrieved.

Any valid montype

3.2.1.16.4Examples: RTRV-TH-EQPT::INP2:t2::FFOFF30S,; RTRV-TH-EQPT::OSC:t2::FREQCORR,;

3.2.1.16.5Response format : NORMAL RESPONSE FORMAT : <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> M^^<ctag>^COMPLD <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”<aid>:<montype>,,,<thlev>,<tmper>” <cr> <lf>

Name Description <aid> Identification of the synchronization object instance (input, oscillator). <montype> identifies the particular monitored parameter for which threshold level is

being retrieved. <thlev> current threshold level for the monitored parameter. <tmper> accumulation time period for the PM information.

GILLAM-FEi


56

3.2.1.16.6Note:




•

GILLAM-FEi


57

•

3.2.1.17.SCHED-PMREPT

3.2.1.17.1Command format: SCHED-PMREPT-EQPT:[<tid>]:<aid>:<ctag>::,,[<numrept >], <montype>,,,,[<tmper>][,];


SCHEDULE-PERFORMANCE MONITORING REPORT instructs the UNISYNC to start or remove the reporting of performance-monitoring data on a synchronization input, on a Feedback Monitoring input or on the oscillator.

When this command requests it, the UNISYNC will periodically return data using the REPORT PERFORMANCE MONITORING message :

− every 10 sec for the TIE1S

− every 4 sec for the DFF

− every PMRFSH sec for the other <montype> as programmed in the parameter PMRFSH defined in the interface port/channel data dictionary (by default : 900 sec).


Name Description Type <aid> Identifies a synchronization object instance. INP1 or INP2 for a

synchronization input. OSC for the oscillator. FBM3, .. FBM12 for a Feedback Monitoring input.

<numrept> At null initiates performance monitoring and at 0 terminates the performance-monitoring reporting schedule that was introduced by a previous SCHEDULE-PM REPORT command.

Null (no numrept value) or “0”

<montype> Type of monitored parameter. One of the PM parameters (see table).

<tmper> Accumulation time period for the performance monitoring information. By default:

- TIE1S : 1S - DFF: 1S - Other <montype>: 15M

1S, 15M, 1H, 1D

3.2.1.17.4Examples:

GILLAM-FEi


58

SCHED-PMREPT-EQPT::INP1:t1::,,,FFOFF100S,,,, 15M; SCHED-PMREPT-EQPT::INP1:t2::,,0,FFOFF100S,,,, 15M; SCHED-PMREPT-EQPT::INP2:t3::,,,TIE1S,,,, 1S; SCHED-PMREPT-EQPT::INP2:t4::,,0,TIE1S,,,, 1S; SCHED-PMREPT-EQPT::FBM3:t5::,,,DFF,,,, 1S; SCHED-PMREPT-EQPT::FBM3:t6::,,0,DFF,,,, 1S; SCHED-PMREPT-EQPT::FBM12:t7::,,,DFF,,,,; SCHED-PMREPT-EQPT::FBM12:t8::,,0,DFF,,,,;

3.2.1.17.5Note:




• Trying to terminate not started schedule-performance monitoring report.

The SCHEDULE-PERFORMANCE MONITORING REPORT is automatically stopped when the concerned synchronization object instance is set out of service. The PM features are available in the UNISYNC from software V1.4.4. The GPXM module of the UNISYNC must also be equipped with 64 Mbytes of RAM.

GILLAM-FEi


59

•

3.2.1.18.SET-ATTR

3.2.1.18.1Command format: SET-ATTR-<modifier>: [<tid>]:[<aid>]:<ctag>::<ntfcncde>,<condtype>,,[,[, [<srveff>],[<logctl>],[<almescl>],[<escltim>]]];


SET-ATTRIBUTE instructs the UNISYNC to set the notification code and various attributes associated with the specified event.

The notification code attribute governs whether the event is reported automatically by the UNISYNC on each occurrence of the event.

For events reported automatically, it also specifies whether the event notification is alarmed (reported via REPORT ALARM) or not alarmed (reported via REPORT EVENT).

In general, an alarmed event causes a standing condition on, and has immediate or potential impact on, the operation or performance of the entity. Some form of maintenance effort is required to restore normal operation or performance of the entity after the event occurs. A non-alarmed event is not classified as an alarmed event.

The OS has the capability to set the notification attribute of events.

For an alarmed event, alarm severity may be classified as critical, major or minor.

RETRIEVE-ATTRIBUTE may be used to review these attributes before making a new setting.


EQPT

GILLAM-FEi


60

3.2.1.18.4 Description of parameters:

Name Description Type <aid> Identifies the equipment unit, the

synchronization input, … depending on the command code modifier, to which the given event pertains.


<ntfcncde> Notification code specifies the type of notification to be generated by the UNISYNC on the occurrence of the event described in <condtype>.

CR, MJ, MN, NA, NR

<condtype> Identifies the type of event for which a notification attribute (<ntfcncde>) is being changed.

See <condtype> table

<srveff> Effect on service caused by the standing or alarm condition.

SA, NSA

<logctl> Indicates if the generated notification must be logged or not.

LOG, NLOG

<almescl> Indicates if the alarm condition must be escalated after the time specified in <escltim>.

ESCL, NESCL

<escltim> Specifies the time expressed in hours after which an alarm will be escalated to the next higher severity level (by default, 24 hours as recommended in GR-1244-CORE).

Decimal number.

3.2.1.18.5Examples:

SET-ATTR-EQPT::OUT3:t1::CR,UEQ,,,,SA,LOG,NESCL,0;

SET-ATTR-EQPT::INP1:t2::MJ,LOS,,;

3.2.1.18.6Note:




GILLAM-FEi


61

3.2.1.19.SET-TH

3.2.1.19.1Command format: SET-TH-EQPT:[<tid>]:<aid>:<ctag>::<montype>,<thlev> [,,,];


SET-THRESHOLD instructs the UNISYNC to set the threshold level for a monitored parameter that, when exceeded, will trigger an automatic message. The threshold level may apply to one or more synchronization objects (input or oscillator).

Threshold setting for multiple monitored parameters will require multiple commands from the OS.

The corresponding commands are RTRV-TH to retrieve the threshold values and ED-EQPT to suppress them.


Name Description Type <aid> Identifies a synchronization object instance

(input, oscillator). Any suitable AID for the given view.

<montype> Identifies the particular monitored parameter for which threshold level is being set.

See <montype> table.

<thlev> Desired threshold level to be set for <montype>. Decimal number

3.2.1.19.4Examples:

SET-TH-EQPT::INP1:t1::FFOFF30S,30000;

ED-EQPT::INP1:t2:::FFOFF30S=DLT;

SET-TH-EQPT::OSC:t3::FREQCORR,10000;

ED-EQPT::OSC:t4:::FREQCORR=DLT;

3.2.1.19.5Note:




GILLAM-FEi


62

3.2.2. Automatic Messages

3.2.2.1.REPT^ALM

3.2.2.1.1Message format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> <almcde>^<atag>^ REPT^ALM^{EQPT} <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”[<aid>]:<ntfcncde>,<condtype>,<srveff>,<ocrdat> ,<ocrtm>,,,[<monval>],[<thlev>] : <conddescr>” <cr> <lf>

This automatic message must contain at least one occurrence of <rspblk>. It is allowed to contain multiple <rspblk>s if applicable.

3.2.2.1.2Description

REPORT ALARM is generated by the UNISYNC to report the occurrence of alarmed events. Trouble events occurring in the UNISYNC are classified as alarmed or non-alarmed events. In general, an alarmed event causes a standing condition and has immediate or potential impact on the operation or performance of the entity. Some form of maintenance effort is required to restore normal operation or performance of the entity after the event has occurred. A non-alarmed event is not reported with this message; the REPORT EVENT message is used. The designation of specific trouble events as alarmed or non-alarmed events shall be settable by using the SET-ATTRIBUTE input command. Related messages are RETRIEVE-ALARM, RETRIEVE-CONDITION and REPORT EVENT.


Name Description <rsphdr> Response header <almcde> Alarm code, identifies the nature of the automatic message based on its

priority of action. If multiple alarms are reported, <almcde> is the highest severity of those reported. If the notification code, <ntfcncde>, is CL, <almcde>, will be A^

<atag> Automatic message tag <aid> Access identifier identifies the single equipment, interface, synchronization

input, oscillator, … in the UNISYNC, depending on the message code modifier, to which the alarm pertains

GILLAM-FEi


63

<ntfcncde> 2-character notification code <condtype> Type of alarm indication <srveff> Effect on service caused by the alarm condition <ocrdat> Date when the event occurred <ocrtm> Time when the event occurred <monval> Measured value of a monitored parameter, which may contain data related

to synchronization performance, if <condtype> is of the form T-x for a threshold violation on <montype>x. This value is provided if this alarm report has resulted from a degradation that has exceeded the defined or specified threshold level

<thlev> User defined threshold level <conddescr> Detailed text description of the trouble

3.2.2.1.4Examples:

UNISYNC 04-03-03 14:57:31 ** 0003 REPT ALM EQPT "OUT2:MJ,UEQ,SA,03-03,14-57-31,,,,:\"Unequipped with necessary card\"" ;

GILLAM-FEi


64

3.2.2.2.REPT^EVT

3.2.2.2.1Message format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> A^^<atag>^ REPT^EVT^{EQPT|T1} <cr> <lf> <rspblk> + ;

where <rspblk> has the format: ^^^”[<aid>]:<condtype>,<condeff>,<ocrdat>,<ocrtm>,, , [<monval>],[<thlev>] : <conddescr>” <cr> <lf>

This automatic message must contain at least one occurrence of <rspblk>. It is allowed to contain multiple <rspblk>s if applicable.


REPORT EVENT is generated by the UNISYNC to report the occurrence of non-alarmed events. Trouble events occurring in the UNISYNC are classified as alarmed or non-alarmed events. Designation of specific trouble events as alarmed or non-alarmed events shall be settable by using the SET-ATTRIBUTE input command. The event being reported may be the change of the status or the occurrence of an irregularity, which by itself is not severe enough to warrant an alarm notification. This message may also be used to report the recovery from off-normal or trouble conditions that were reported initially via REPT-EVT. This is done by using the <condtype> sent by the original event report and using the value CL for <condeff>. Related messages are RETRIEVE-CONDITION and REPORT ALARM (for reporting the occurrence of an alarmed event).


Name Description <rsphdr> Response header <atag> Automatic message tag <aid> Access identifier identifies the single equipment, interface, synchronization

input, oscillator, … in the UNISYNC, depending on the message code modifier, to which the event pertains.

GILLAM-FEi


65

<condtype> Type of event <condeff> Indicates the effect of the event on the condition of the UNISYNC. The

event may initiate a standing condition, which can later be retrieved using the RETRIEVE-CONDITION command or may initiate a transient condition that does not change the basic condition of the UNISYNC for an extended time period. Valid values for <condeff> are as follows:

CL Standing Condition Cleared SC Standing Condition Raised TC Transient Condition A null value for <condeff> defaults to TC.

Parameter grouping shall not be used with this parameter <ocrdat> Date when the event occurred <ocrtm> Time when the event occurred <monval> Measured value of a monitored parameter, which may contain data related

to synchronization performance, if <condtype> is of the form T-x for a threshold violation on <montype>x. This value is provided if this event report is the result of a threshold for a monitored parameter exceeding the defined or specified threshold level

<thlev> Threshold level for the monitored parameter specified in <condtype> if <condtype> is of the form T-x for a threshold violation on <montype>x. This value is provided if this event has resulted from degradation in the monitored parameter causing it to exceed the specified threshold level.

<conddescr> Detailed text description of the specific event that caused this notification.

3.2.2.2.4Examples:

UNISYNC 05-01-12 14:53:15 A 0802 REPT EVT EQPT "SSU:DBLOAD,TC,01-12,14-53-15,,,,:\"Start WKG DB loading from PRI DB\"" ;

GILLAM-FEi


66

3.2.2.3.REPT^PM

3.2.2.3.1Message format: <cr> <lf> <lf> ^^^<rsphdr> <cr> <lf> A^^<atag>^REPT^PM^T1 <cr> <lf> <rspblk> + ; where <rspblk> has the format: ^^^”<aid>:<montype>,<monval>,<vldty>, , , <tmper>, <mondat>, <montm>” <cr> <lf>

This automatic message must contain at least one occurrence of <rspblk>. It is allowed to contain multiple <rspblk>s.


REPORT PERFORMANCE MONITORING is generated to inform the OS or maintenance personnel of PM information. REPT PM is an automatic message that is generated by the UNISYNCe as a result of a previous SCHEDULE-PMREPT command received by the UNISYNCe. PM data may also be retrieved on demand by a RETRIEVE-PM command, however REPT PM is not used to respond to a RETRIEVE-PM command.


Name Description <aid> Identifies the synchronization object instance (input, oscillator, feedback

monitoring input). <montype> Indicates the type of monitored parameter whose value is being reported <monval> Measured value of the monitored parameter <vldty> Validity indicator for the reported PM data <tmper> Indicates the accumulation time period for the PM information <mondat> Date of the beginning of the PM period specified in <tmper> <montm> Beginning time of day of the PM period specified in <tmper>

3.2.2.3.4Examples: UNISYNCE 05-01-12 10:15:17 A 4153 REPT PM T1 “IOP-1:TDEV100S,0.2,COMPL,,,15M,01-12,10-00-00” ;

GILLAM-FEi


67

UNISYNCE 08-06-12 10:15:17 A 0200 REPT PM T1 “FBM3:DFF,\"5.3e-012,1000 sec,40 nsec\",COMPL,,, 1S,06-12,10-15-17” ; UNISYNCE 08-06-16 14:59:02 A 0077 REPT PM T1 “FBM3:DFF,\"0.0e+000,0 sec,0 nsec\",N/A,,,1S,06- 16,14-59-02” ;

GILLAM-FEi


68

4. SECURITY ADMINISTRATION (TR-NWT-835)

4.1. Introduction

The NESSA (Network System Security Administration) messages and NE/NS responses described here are necessary to satisfy the needs related to NE/NS security administration (see TR-NWT-835).

The security functionalities of the UNISYNC will be managed from TL1 commands.

4.2. Data Model of NESSA

The conceptual data model of NESSA is similar to that of memory administration (see GR-199-CORE and paragraph 1 of this document). The OS, “looking” into an NE, “sees” a set of one or more administrative views of the NE database. Administrative views are conceptual, representing the various data elements in the form of tables or matrices. Each row of a table represents an object entity. Each column of a table represents an attribute of the object entity. For example, security parameters related to a user constitute an administrative view, where each user is an entity, and attributes are parameters such as passwords, access privileges, etc. The OS transmits various NESSA commands to the NE to cause either a query or an update of the security parameters in the NE database. The logical model of NESSA specifies the various data items that make up each administrative view in the conceptual model. The method of representing data at this logical level is by means of a data dictionary.

4.3. UNISYNC NESSA functions

NESSA supported in an UNISYNC consists of the following types of messages: 1. Automatic messages indicating alarm/alert conditions:

• Session logged off due to timeout • Intrusion suspected • Security log overflow

2. User initiated messages and responses associated with: • Setting up a session (login) • Terminating a session (logoff) • Updating a password • Retrieving, by a user, of certain security attributes associated with

that user or with the channel used by that user • Retrieving all User-Ids of users that are currently logged on • Retrieving all channels that are currently logged on.

3. Messages initiated by a security administrator to inquire/modify the current status of sessions:

• Terminate (log off) a current session associated with a specific user

GILLAM-FEi


69

• Terminate (log off) a current session associated with a specific port 4. Messages initiated by a security administrator to enter, edit, delete (not

retrieve) any of the following: • Password (PID)

5. Messages initiated by a security administrator to enter, edit, delete or retrieve any of the following:

• User-Ids (UID) and their associated attributes (UAP, list of user interfaces, …)

• Channel/Port Identifiers (CIDs) and their associated attributes (CHAP, TMOUT, …)

• Commands and the corresponding access privileges required for executing them (CAP)

4.4. Message structure

The TL1 messages structure related to the administration of the UNISYNC security parameters follows the rules described in the documents GR-831-CORE and TR-NWT-835. Different types of format are considered for:

• Automatic messages • Input commands with their associated responses.

Depending on the nature of the automatic message, the UNISYNC may transmit it to all users, a particular user, or only to a security administrator responsible for NE security. The convention followed is that automatic messages reserved for a security administrator have “SECU” as a modifier. Other messages do not have this modifier. The non-automatic messages are of two categories:

• Commands to be used only by a security administrator: they have “SECU” as a modifier

• Commands to be used by other users In general, all messages , whether automatic or user-initiated, that are reserved for a security administrator have the “SECU” modifier.

GILLAM-FEi


70

4.5. Supported messages

4.5.1. Security Commands

4.5.1.1.ACT-USER


ACT-USER:[<tid>]:<uid>:<ctag>::<pid>;


This command starts a user session by logging on to UNISYNC.



<uid> User Identifier (i.e. login) Symbolic name up to ten symbols. <pid> Private Identifier (password) Symbolic name up to ten characters,

where at least two are non-alphabetic characters with at least one special character.

4.5.1.1.4Examples: ACT-USER::FEI: t3:fei.1;

4.5.1.1.5Example of normal response: UNISYNC 05-01-12 14:43:33 M t3 COMPLD "FEI:2005-01-12 14:18:19,11" ;

This displayed data gives : - date and time of the last session established by this UID, - number of unsuccessful session attempts since last session.

4.5.1.1.6Note:

In human-machine interface mode password symbols are replaced by ‘*’ when echoing the command.

GILLAM-FEi


71

A deny response can occur in the following cases: • Wrong user identity,

• Wrong password.

• Missing permissions for this channel.

• Session is already running on the channel

Related command is CANC-USER.

GILLAM-FEi


72

4.5.1.2.ALW-USER-SECU


ACT-USER:[<tid>]::<ctag>::<uid>;


This command reinstates a UID that was inhibited by INH-USER-SECU so the user can establish again a session with the UNISYNC..



<uid> User identifier (i.e. login) Symbolic name up to ten symbols

4.5.1.2.4Examples: ALW-USER-SECU:::t11: :RP;

4.5.1.2.5Note:

A deny response can occur in the following cases: • Missing security permissions for this command.


•

GILLAM-FEi


73

4.5.1.3. CANC-CID-SECU


CANC-CID-SECU:[<tid>]:<cid>:<ctag>;

•


This command terminates a session that is ongoing with the UNISYNC over a CID (craft, telnet, …).

•



<cid> Channel identifier for which the ongoing session is being terminated.

CRAFT1, … CRAFT2 TELN TL1MNG1, … TL1MNG6

4.5.1.3.4Examples: CANC-CID-SECU::TL1MNG1&&-6:t1;

4.5.1.3.5Note:

A deny response can occur in the following cases: • Missing security permissions for this command.


• One or more of the target channels was not opened If the command has the valid syntax but there is no user connection on some of the channels, a partial response will be sent. The users logged on the channels to be closed will receive CANC messages.

GILLAM-FEi


74

4.5.1.4. CANC-USER


CANC-USER: [<tid>]:<uid>: <ctag>;


This command terminates a session with the UNISYNC (i.e., logging off). The user can only terminate his own session.



<uid> User identifier. Symbolic name up to ten symbols

4.5.1.4.4Examples: CANC-USER::FEI:008;

4.5.1.4.5Note:

A deny response can occur in the following cases: • Illegal syntax or parameter values

GILLAM-FEi


75

4.5.1.5. CANC-USER-SECU


CANC-USER-SECU: [<tid>]:<uid>:<ctag>;


This command is used by a security administrator to terminate the session of a user with the UNISYNC.



<uid> User identifier(s). It may be a single UID or a block of UIDs.

Each symbolic name up to ten symbols

4.5.1.5.4Examples: CANC-USER-SECU::CA:t1;

4.5.1.5.5Note:


• User with the “uid” is not logged on.

• Missing security permissions for this command The security administrator can cancel any user session, even a session of the other security administrator. Channel is also closed. The user receives a CANC message.

GILLAM-FEi


76

4.5.1.6. DLT-SECU


DLT-SECU: [<tid>]:COM: <ctag>::;


This command deletes the security database of the UNISYNC (all user names, passwords, channels and commands security permissions will be deleted.) and then recreates a default security database. To be able to execute this command, all the user sessions should beforehand have been closed.


None

4.5.1.6.4Examples: DLT-SECU::COM:t1::;

4.5.1.6.5Note:



• Not all the user sessions have been closed.

• A new security database can be entered by the ENT-USER-SECU, ED-CID-SECU and ED-CMD-SECU commands.

GILLAM-FEi


77

4.5.1.7. DLT-USER-SECU


DLT-USER-SECU: [<tid>]:<uids>:<ctag>;


This command deletes user(s)-related information from the UNISYNC security database.



<uids> User identifier(s). It may be a single UID or a block of UIDs.

Symbolic names up to ten symbols each other

4.5.1.7.4Examples: DLT-USER-SECU:UNISYNCSID:FEI:t1;

4.5.1.7.5Note:



A new user can be entered with the ENT-USER-SECU command.

GILLAM-FEi


78

4.5.1.8. ED-CID-SECU


ED-CID-SECU: [<tid>]:< сid>:<ctag>::<chaps>:<keyword params>;


This command edits the security parameters associated with the channel identifiers.

See channel-related security data dictionary.



<cid> Channel identifier(s). Here can be a single CID, grouped and compound value. All the channel names should be correct.

CRAFT1, … CRAFT2 TELN TL1MNG1, … TL1MNG6

<chaps> Channel access privilege. Position-defined parameter block.

NONE, USER, ADMIN, SECU

Keyword defined parameter block. Allowed parameters are:

MXINV – the maximum number of invalid session setup attempts allowed before the channel closing

IntRange from 1 to 9

<keyword params>

TMOUT – timeout interval in minutes. If there is no input from user after the timeout interval, the connection is closed. A value of zero means no inactivity detection.

IntRange from 0 to 4320

4.5.1.8.4Examples: ED-CID-SECU::TELN:t1::ADMIN&SECU&USER: MXINV = 3, T MOUT = 10;

4.5.1.8.5Note:


• Missing security permissions for this command The modified channel access permissions will be applied immediately. The modified MXINV or TMOUT parameters will be applied to the new connections on this channel.

GILLAM-FEi


79

4.5.1.9. ED-CMD-SECU


ED-CMD-SECU: [<tid>]:<command name>:<ctag>::<caps>;


This command edits the security parameters associated with the TL1 commands.

See the command-related security data dictionary.



<command name>

Command verb and modifiers separated by dashes. It may be a single command or a block of commands.

Enum+: all allowed UNISYNC commands

<caps> Command access privilege. It can be a grouped parameter value.


4.5.1.9.4Examples:

ED-CMD-SECU::ED-CMD-SECU&ED-CID-SECU:1::ADMIN&SECU;

4.5.1.9.5Note:



The command access permissions changes will be applied immediately.

GILLAM-FEi


80

4.5.1.10. ED-PID


ED-PID: [<tid>]:<uid>:<ctag>::<old pid>,<new pid>;


This command edits user’s password. User can only change his password.


Name Description

<uid> User's own UID, such as User's Login Name. <old pid> This old PID is being replaced by a new one. <new pid> This new PID replaces the old one.

4.5.1.10.4Examples:

ED-PID::FEI:t2::FEI.23,fei.23;

4.5.1.10.5Note:


In the human-machine interface mode the passwords are replaced with ‘*’. The password is up to 10 characters where at least two are non –alphabetic characters with at least one special character.

GILLAM-FEi


81

4.5.1.11. ED-USER-SECU


ED-USER-SECU:[<tid>]:<uid>:<ctag>::<new uid>,<new p id>,<cid>,<uap>;


This command edits the security parameters associated with a user (UID, PID, CID, UAP). See the user-related security data dictionary.



<uid> User identifier such as User's Login Name, as it currently exists.

Symbolic name up to ten symbols

<new uid> New Login Name to replace the old one. Symbolic name up to ten symbols

<new pid> New user password Symbolic name up to ten characters where at least two are non-alphabetic characters with at least one special character

<cid> Channel identifier(s). It can be a single CID or a grouped parameter value.

CRAFT1, … CRAFT2 TL1MNG1, … TL1MNG6 TELN

<uap> User access privilege. It can be a grouped parameter value.


4.5.1.11.4Examples:

ED-USER-SECU::FEI:118::UNISYNC,Newpass,TELN&TL1MNG1 &TL1MNG4,USER&NONE;

4.5.1.11.5Note:



• The user is currently connected.

• New user identity duplicates existing one

• An administrator tries to attempt self-demotion to a lower authorization level.

GILLAM-FEi


82

4.5.1.12. ENT-USER-SECU


ENT-USER-SECU:[<tid>]:<uid>:<ctag>::<pid>,<cid>,<ua p>;


This command enters the security parameters associated with a new user (UID, PID, CID, UAP). See the user-related security data dictionary.



<uid> User identifier, such as User's Login Name. Symbolic name up to ten symbols

<pid> User password Symbolic name up to ten characters where at least two are non-alphabetic characters with at least one special character

<cid> Channel identifier(s). It can be a single CID or a grouped parameter value.

CRAFT1…CRAFT2 TL1MNG1, …TL1MNG6 TELN

<uap> User access privilege. It can be a grouped parameter value.


4.5.1.12.4Examples:

ENT-USER-SECU::chr:t1::chr.1,ALL,ADMIN&SECU;

4.5.1.12.5Note:


• New user identity duplicates existing one

GILLAM-FEi


83

4.5.1.13. INH-USER-SECU


INH-USER-SECU:[<tid>]::<ctag>::<uid>;


This command inhibits (disables) an existing user (without deleting the user account), so the user can be denied a session with the UNISYNC (the user cannot log on). A disabled UID can be reinstated by using the ALW-USER-SECU command.


Name Description

<uid> Position-defined parameter block. List of UIDs that are being inhibited. Parameter grouping is allowed.

4.5.1.13.4Examples: INH-USER-SECU:::t1::RP&FEI;

4.5.1.13.5Note:


• Missing security permissions for this command The changes apply to the next logging on of the users. If the user is connected the session will not be canceled.

GILLAM-FEi


84

4.5.1.14. RTRV-ALM-SECU


RTRV-ALM-SECU:[<tid>]:COM:<ctag>::,,,,;


The command retrieves the list of security alarms. The UNISYNC security alarms are :

− “Security log buffer 90% full” − “Security log buffer overflow”

4.5.1.14.3Note:



GILLAM-FEi


85

4.5.1.15. RTRV-CID-SECU


RTRV-CID-SECU:[<tid>]:<cid>:<ctag>[:];


This command retrieves the security parameters associated with the channel identifiers.



<cid> Channel identifier(s). It may be a single CID or a block of CIDs.

CRAFT1, … CRAFT2 TL1MNG1, … TL1MNG6 TELN

4.5.1.15.4Examples:

rtrv-cid-secu:: tl1mng1&&-4&craft1&&craft2&TELN:009 ;

4.5.1.15.5Example of normal response: UNISYNCSID 04-12-02 19:22:10 M 009 RTRV “TL1MNG1:ADMIN&SECU&USER:TMOUT=12,MXINV=8” “TL1MNG2:ADMIN&SECU&USER:TMOUT=12,MXINV=8” “TL1MNG3:ADMIN&SECU&USER:TMOUT=12,MXINV=8” “TL1MNG4:ADMIN&SECU&USER:TMOUT=12,MXINV=8” “CRAFT1:ADMIN&USER&SECU:TMOUT=15,MXINV=4” “CRAFT2:ADMIN&SECU&USER:TMOUT=12,MXINV=8” “TELN:NONE&USER&ADMIN&SECU:TMOUT=15,MXINV=3” ;

4.5.1.15.6Note:


• Missing security permissions for this command Security parameters can be changed by ED-CID-SECU.

GILLAM-FEi


86

4.5.1.16. RTRV-CMD-SECU


RTRV-CMD-SECU:[<tid>]:<command name>:<ctag>;


This command retrieves the security parameters associated with TL1 commands.


Name Description

<command name>

Command verb with modifiers separated by dashes. It may be a single command or a block of commands. We can use “ALL” to retrieve the security parameters of all the commands.

4.5.1.16.4Examples:

rtrv-cmd-secu: UNISYNCSID:all:1;

rtrv-CMd-secu::Help&act-user:55:;

4.5.1.16.5Example of normal response: UNISYNCSID 04-12-02 20:00:07 M 55 RTRV “HELP:ADMIN&SECU&NONE&USER” “ACT-USER:ADMIN&USER&SECU&NONE” ;

4.5.1.16.6Note:


• Missing security permissions for this command For parameter changing use ED-CMD-SECU.

GILLAM-FEi


87

4.5.1.17. RTRV-STATUS


RTRV-STATUS:::<ctag>;


This command retrieves the system status (regarding the number of UIDs and CIDs logged on to the UNISYNC).


None.

4.5.1.17.4Examples: RTRV-STATUS:::006;

4.5.1.17.5Example of normal response: UNISYNCSID 04-12-02 18:20:44 M 006 RTRV “:CRAFT1&TELN,RP&YS” ;

4.5.1.17.6Note:


• Missing security permissions for this command The retrieved data are :

• List of CIDs logged on

• List of corresponding UIDs logged on

GILLAM-FEi


88

4.5.1.18. RTRV-USER


RTRV-USER:<tid>:<uid>:<ctag>;


This command retrieves the security parameters associated with the said user (except password which cannot be retrieved). See the security data dictionaries.


Name Description

<uid> UID of the user who is retrieving the security-related parameters related to that UID.

4.5.1.18.4Examples:

rtrv-user::rp:007;

4.5.1.18.5Example of normal response: UNISYNCSID 04-12-02 20:18:02 M 007 RTRV “RP:TL1MNG1&TL1MNG2&TL1MNG3&TL1MNG4&CRAFT1&CRAFT2&TELN,ADMIN&SECU” ;

4.5.1.18.6Note:


• Missing security permissions for this command Only a security administrator can change this data by using the ED-USER-SECU. The user can change his password by ED-PID. The retrieved data are :

• CID

• UAP

GILLAM-FEi


89

4.5.1.19. RTRV-USER-SECU


RTRV-USER-SECU:<tid>:<uid>:<ctag>;


This command retrieves the security parameters associated with a user (except password which cannot be retrieved). See the security data dictionaries.



<uid> User identifier(s). It may be a single UID or a block of UIDs. Use “ALL” to retrieve the security parameters of all the users.

Symbolic names up to ten symbols

4.5.1.19.4Examples: RTRV-USER-SECU::RP&FEI:114;

4.5.1.19.5Example of normal response: UNISYNCSID 09-12-02 20:39:31 M 114 RTRV “RP:TL1MNG1&TL1MNG2&TL1MNG3&TL1MNG4&CRAFT1&CRAFT2&TELN,ADMIN&SECU” “FEI:ALL,USER&ADMIN&SECU” ;

4.5.1.19.6Note:


• Missing security permissions for this command The security administrator can change this data by using the ED-USER-SECU. The retrieved data are :

• UID

• CID

• UAP

GILLAM-FEi


90

4.5.2. Security Automatic Messages

4.5.2.1.REPT^ALM^SECU

4.5.2.1.1Message format: <cr> <lf> <lf> ^^^<SID>^<DATE>^<TIME> <cr> <lf> <almcde>^<atag>^REPT^ALM^SECU <cr> <lf> ^^^<aid>:<ntfcncde>,<condtype>,,<ocrdat>,<ocrtm>,,: <conddescr>”<cr> <lf>;


This REPT ALM SECU message is generated to report the following conditions: − “SECU Log buffer 90% full” − “SECU Log buffer overflow”


Name Description

<SID> System Identifier.

<DATE> Date in a format YY-MM-DD, where YY is the last two digits of the year ranging from 00 to 99, MM is the month of the year ranging from 1 to 12, and DD is the day of the month ranging from 1 to 31.

<TIME> Time in a format of HH:MM:SS, where HH is the hour in a 24 hour format ranging from 00 to 23, MM is the minute ranging from 00 to 59, and SS is the second ranging from 00 to 59.

<almcde> Alarm Code. *C – critical alarm, ** - major alarm, *^ - minor alarm, A^ - automatic message;

<atag> Automatic message tag. <aid> Access Identifier. Identifies the entity to which

the alarm pertains

GILLAM-FEi


91

<ntfcncde> Notification code. CR – critical alarm, MJ – major alarm, MN – minor alarm, CL – clear alarm;

<condtype> Type of alarm indication. <ocrdat> Date when the alarm occurred. <ocrtm> Time when the alarm occurred. <conddescr> Detailed text description of the trouble.

GILLAM-FEi


92

4.5.2.2.CANC

4.5.2.2.1Message format : <cr> <lf> <lf> ^^^<SID>^<YY-MM-DD>^<HH:MM:SS> <cr> <lf> A””<atag>^CANC <cr> <lf> <UID> <cr> <lf>;

Where <SID> is the source UNISYNC identifier, and <UID< refers to the User-ID of the user whose session is terminated due to timeout.


This is an automatic message transmitted by the UNISYNC to a user when a session established by the said user is terminated because of “timeout”.

GILLAM-FEi


93


The following data dictionaries are provided in the appendices: • User-Related Security data dictionary • Channel-Related Security data dictionary • Command-Related Security data dictionary

GILLAM-FEi


94

5. APPENDICES

5.1. Procedure to upgrade UNISYNC software

5.1.1. Introduction

This procedure can be used to install a new revision of software into the UNISYNC.

5.1.2. Procedure

o Download the UNISYNC software to the UNISYNC with a TFTP client (i.e., “PumpKIN”):

� Run PumpKIN and be sure that the PumpKIN options are correctly set up:

• Options -> Network o Send outgoing request to port “69” o Default block size of “512” bytes o Default connection timeout: “30” seconds

� Select “Put File” and then enter: • Local file (file name that you want to download: i.e.,

unisyncV1_1.dwn, …) • Remote file (same than local file) • Remote host (IP address of the UNISYNC unit)

� Click OK. o Wait until the download is completed. o Reset the UNISYNC:

� Open a telnet connection to the UNISYNC � Log into the UNISYNC:

• Act-user::fei:t::fei.1; � Enter the TL1 command: “ed-eqpt::ssu:t:::reset=y;” � Confirm this command: “ed-eqpt::ssu:t:::reset=y,conf=y;”

o Wait until the reset of the UNISYNC is completed. o Open a telnet connection to the UNISYNC. o Log into the UNISYNC:

� Act-user::fei:t::fei.1; o Verify that the new software running on the UNISYNC corresponds to

the new software release number: � Use the TL1 command: “rtrv-eqpt::gpxm:t; � Check the “SWVERSION” parameter.

GILLAM-FEi


95


5.2.1. Equipment data dictionaries

5.2.1.1.SSU data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS CLEI A/N Up to 32 ASCII

characters Indicates the CLEI (Common Language Equipment Identifier) of the SSU card.

Valid Commands: RTRV-EQPT

CONF Y/N Y Confirms Service Affecting TL1 command.

Valid Commands : ED-EQPT

DBACT Y/N Y or N Y: Indicates that the UNISYNC has still some writing activity pending in order to update the PRI DB (flash disk) on the SSU card from the WKG DB (RAM). N: Indicates that the WKG DB and the PRI DB have been synchronized (same DB content).


DBID A/N Up to 50 ASCII characters

Indicates the Identifier of the PRI DB:

• SID. • Version of SSU card

software that has created that DB.

• Transaction Number. • Date. • Time.


DHCP Y/N Y=use a DHCP server ; Default=N.

Uses a DHCP server to get the UNISYNC IP address. If no DHCP server is used, then the IP address of the NIC is programmed by the IPADDR parameter. After a modification of the NIC IP parameters (DHCP, IPADDR, GATEW, MTU and SUBNET), a restart of the TCP/IP stack is necessary (see ETHRST keyword).

Valid Commands: ED-EQPT RTRV-EQPT

E1MFALM ENUM One of the Specifies the behaviour of the Valid Commands:

GILLAM-FEi


96

following: • NONE • AIS • SSM

Default: SSM

UNISYNC regarding its E1MF outputs when the output signals become unsuitable for synchronization use. For the concerned E1MF outputs:

• NONE: the output signal is still supplied

• AIS: the output signal is changed to AIS.

• SSM: the output signal continuously generates synchronization status messages. In normal operation, the UNISYNC generates the "G811" synchronization message. When it enters the bridging mode, the synchronization status messages indicate "Synchronized Traceability Unknown".

The parameter ALMDE must have been programmed to E1ALM on the E1 OUT ports for this behaviour to become active.

ED-EQPT RTRV-EQPT

E1SFALM ENUM One of the following:

• NONE • AIS

Default: NONE

Specifies the behaviour of the UNISYNC regarding its E1SF outputs when the output signals become unsuitable for synchronization use. For the concerned E1SF outputs:


• AIS: the output signal is changed to AIS.

The parameter ALMDE must have been programmed to E1ALM on the E1 OUT ports for this behaviour to become active.


E1TYPE ENUM One of the following:

Programs the type of E1 output supplied on OUT1, … OUT12:

Valid Commands: ED-EQPT

GILLAM-FEi


97

• E1SF • E1MF

Default: E1MF.

• E1SF: G704 frame with no multiframe structure

• E1MF: G704 frame with multiframe structure (CAS and CRC4).

RTRV-EQPT

ETHRST Y/N Y Forces a restart of the TCP/IP protocol stack. In general, this operation is needed after a modification of the network parameters (DHCP, IPADDR, GATEW, MTU and SUBNET). This operation should be confirmed by the user (use of the CONF parameter). Restarting the TCP/IP stack causes a clear of all the current TL1 TCP/IP sessions.


FASTRESET Y/N Y Forces a hardware reset of the UNISYNC (should be confirmed by the user: use of the CONF parameter) . Unlike the "RESET=Y" action, the UNISYNC doesn't wait for the warm-up of the oscillator. That procedure reduces the time of unavailability of the output signals. A FASTRESET should be used with the greatest care.


GATEW INT-INT-INT-INT

Each integer can take the value from 0 to 255. Default=192-1-2-254.

Gateway address of the Ethernet NIC. The 32 bits IP address is coded as 4 integers separated by a dash: i.e., 192-1-2-51. After a modification of the NIC IP parameters (DHCP, IPADDR, GATEW, MTU and SUBNET), a restart of the TCP/IP stack is necessary (see ETHRST keyword).


HIST A/N Up to 100 ASCII characters

Indicates the history information of the card (repairing, guarantee period, …)


HWVERSION A/N Up to 10 ASCII characters

Indicates the hardware version of the installed card.


ID A/N Up to 64 ASCII Could indicate the physical Valid Commands:

GILLAM-FEi


98

characters location of the card (User comment).

ED-EQPT RTRV-EQPT

INPCUR ENUM One of the following:

• GPS • INP1 • INP2 • -

Returns the selected reference synchronization input:

• GPS • INP1 • INP2 • - :means that no

synchronization input is currently selected.


INPFRCD ENUM One of the following:

� GPS � INP1 � INP2

Specifies the reference input to select when the UNISYNC is working in FRCD synchronization mode (see SYNMDE parameter). The selected input will be tracked if qualified otherwise the oscillator will go to HOLDOVER.


INPMODQTY INT 0…2 Gives the number of input modules installed on the UNISYNC card.


INPOVR INT One of the following:

� GPS � INP1 � INP2

Specifies the reference input to select when the UNISYNC is working in AUTO synchronization mode (see SYNMDE parameter). INPOVR overrides the current selection algorithm of the UNISYNC based on the QLCUR and PRTY parameters management. That command will be denied if it causes a switch to a failed reference or to a low quality reference (see input QLCUR parameter). However, it will be accepted if it causes a switch to a low priority reference (see input PRTY parameter).


INPSEL ENUM One of the following:

• GPS • INP1 • INP2

Specifies the reference input to select when the UNISYNC is working in AUTO synchronization mode (see SYNMDE parameter). That command will be denied if it causes a switch to a failed reference, to a low priority reference (see input PRTY


GILLAM-FEi


99

parameter) or to a low quality reference (see input QLCUR parameter).

IPADDR INT-INT-INT-INT


IP address of the Ethernet NIC. The 32 bits IP address is coded as 4 integers separated by a dash: i.e., 192-1-2-50. After a modification of the NIC IP parameters (DHCP, IPADDR, GATEW, MTU and SUBNET), a restart of the TCP/IP stack is necessary (see ETHRST keyword).


LEDACO ENUM One of the following:

• O • Y

Indicates the state of the Alarm Cut Off LED:

• O: Off (all the audible relays are inactive)

• Y: Yellow (the audible relays have been activated).

The Alarm Cut Off condition is automatically raised (LEDACO=Y) when an alarm is set. The Alarm Cut Off condition is automatically cleared (LEDACO=O) when all the alarms have been cleared. That condition can also be cleared manually with the OPR-ACO TL1 command.


LEDCR ENUM One of the following:

• O • R

Default: O

Indicates the state of the CR LED:

• O: Off • R: Red.

This led is turned red in case of any CR alarms affecting the UNISYNCe.


LEDMJ ENUM One of the following:

• O • R

Default: O

Indicates the state of the MJ LED:

• O: Off • R: Red.

This led is turned red in case of any MJ alarms affecting the UNISYNCe.


LEDMN ENUM One of the following:

• O • Y

Indicates the state of the MN LED:

• O: Off • Y: Yellow.


GILLAM-FEi


100

Default: O This led is turned yellow in case of any MN alarms affecting the UNISYNCe.

MTU INT 68 .. 1500 Default: 1500

Specifies the Maximum Transmission Unit (MTU) for the Ethernet network interface. The MTU is the maximum packet size in bytes that the transport will transmit over the underlying network. The size includes the transport header. After a modification of the NIC IP parameters (DHCP, IPADDR, GATEW, MTU and SUBNET), a restart of the TCP/IP stack is necessary (see ETHRST keyword).


NTPACT Y/N Y or N Default: Y

Controls the administrative status of the NTP Server (NTP V3, SNTP V4). Y = enable the NTP Server N = disable the NTP Server


PST ENUM One of the following:

• IS

This keyword indicates the primary state information of the entity as defined in GR-1093-CORE:

• IS: In Service


RESET Y/N Y Forces a hardware reset of the UNISYNC (should be confirmed by the user: use of the CONF parameter). If the oscillator has been warmed up, the "FASTRESET=Y" action can be used instead.


SIGNIN A/N Up to 128 characters.

Indicates the message sent to the user when a TL1 session is opened (the parameter HMI must be set at Y in the communication channel: TELN, CRAFT or TL1MNG). Default: “Welcome to UNISYNCe TL1Agent!”.


SN A/N Up to 20 ASCII characters

Indicates the serial number of the installed card.


SSMGEN ENUM One of the following :

• GEN1 • GEN2

Default: GEN2.

Program the SSM management model as defined in the document ANSI T1.101-1999 (Synchronization Interface Standard):


GILLAM-FEi


101

• GEN1: First-Generation Synchronization Status Messages

• GEN2: Second-Generation Synchronization Status Messages.

SUBNET INT-INT-INT-INT


Subnetmask of the Ethernet LAN. The 32 bits subnetmask is coded as 4 integers separated by a dash:i.e., 255-255-255-64. After a modification of the NIC IP parameters (DHCP, IPADDR, GATEW, MTU and SUBNET), a restart of the TCP/IP stack is necessary (see ETHRST keyword).


SYNMDE ENUM One of the following:

• AUTO • FRCD

Default: AUTO.

Specifies the synchronization mode:

� AUTO Auto synchronization mode: normal state of working (default). The UNISYNC automatically manages the switching to alternate timing references. The selection of a particular reference takes into account the state of the inputs, their priority (PRTY parameter) and their current quality level (QLCUR parameter). That mode also allows the OS to issue a Manual Reference Switch command to a reference specified with the INPSEL parameter. This command will be denied if it causes a switch to a failed reference, to a low priority reference (see input PRTY parameter) or to a low quality reference (see input QLCUR parameter). It is possible to override these checks and to switch to a low priority reference if the OS uses the INPOVR parameter instead of the INPSEL parameter to


GILLAM-FEi


102

specify the reference to switch to.

� FRCD Forced synchronization mode. Allows the OS to issue a Forced Reference Switch command. The reference input specified by the OS with the INPFRCD parameter will be tracked if qualified otherwise the oscillator will go to HOLDOVER. An alarm indicates to the OS that the "Forced Reference Switch Mode" has been entered.

TL1PORT INT 1…9000 Default : 71

Specifies the TCP port of the UNISYNC TL1 agent.


TMRRSW A/N Up to 19 ASCII characters

Indicates the “Time of Most Recent Reference Switch”. Format: “YYYY-MM-DD HH:MM:SS”


TODACT Y/N Y or N Default: N

Controls the administrative status of the TOD Server on the TOD serial interface (NTP clock driver type 4). Y = enable the TOD Server N = disable the TOD Server. Refer to the "TOD – Time Of Day on serial interface" paragraph in the appendices for a description of the TOD physical interface and TOD message format.


TYPE ENUM One of the following:

• UNISYNCE

Indicates the type of SSU: • UNISYNCe


GILLAM-FEi


103

5.2.1.2.GPXM data dictionary


characters Indicates the CLEI (Common Language Equipment Identifier) of the installed GPXM module (General Purpose Xscale Module)




DST Y/N Y=use Daylight Saving Time N=do not use Daylight Saving Time Default=Y.

Programs the Daylight Saving Time. DST is a widely used system of adjusting the official local time forward, usually one hour, from its official winter standard time for the duration of the spring and summer months.


FACTORYRESET Y/N Y Forces a factory reset of the UNISYNC. That command must be confirmed by the user (use of the CONF parameter). The UNISYNC is reconfigured with its configuration by default.



Indicates the history information of the GPXM module (repairing, guarantee period, …)



Indicates the hardware version of the GPXM module.



Indicates the serial number of the GPXM module.


SWVERSION A/N Up to 10 ASCII characters

Indicates the version of the UNISYNC software.


TZ A/N Up to 30 ASCII characters Default: "WEUROPEST"

Specifies the Time Zone in which the UNISYNC is installed. The local time is computed from the UTC (Coordinated Universal Time) received


GILLAM-FEi


104

from the GPS and the value of the parameters DST and TZ. Examples of format used: "WEUROPEST" "WESTPACIFICST" "GREENWICHST" … Refer to the list of Time Zones given in the appendices. Be careful, a modification of the TZ parameter can lead to all the current TL1 sessions being closed.

GILLAM-FEi


105

5.2.1.3.SNMP v1/v2c data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS ACCESSCTL Y/N Y=enable the SNMP

access control N=disable the SNMP access control. Default: N

When the parameter ACCESSCTL=Y, an SNMP access control is performed by checking the IP addresses of the SNMP managers. Only the programmed NMS addresses will be authorized by the UNISYNCe to issue SNMP operations (GET, SET, GETNEXT, ...). Up to four NMS addresses can be provisioned (refer to the NMSADDR parameters in this SNMP data dictionary).


ENBAUTHTRAP Y/N Y=enable the report of the authentication failure traps N=disable the report of the authentication failure traps. Default: Y

A report of an authentication failure trap can be generated by the UNISYNCe when an SNMP manager attempts to access a MIB variable using incorrect community strings. That parameter can also be programmed from SNMP (refer to the snmp group of the UNISYNCe MIB).


NMS1ADDR INT-INT-INT-INT

Each integer can take the value from 0 to 255. Default=0-0-0-0

Specifies the 32 bits IP address of an NMS. When this address is set to 0-0-0-0 (default value), this address is not taken into account by the SNMP access control logic of the UNISYNCe.




Specifies the 32 bits IP address of an NMS. When this address is set to 0-0-0-0 (default value), this address is not taken


GILLAM-FEi


106

into account by the SNMP access control logic of the UNISYNCe.









ROCOMMUNITY A/N Up to 30 ASCII characters. Default: “public”

Specifies the read-only access community string.


RWCOMMUNITY A/N Up to 30 ASCII characters. Default: “private”

Specifies the read-write access community string.


SYSCONTACT A/N Up to 255 ASCII characters. Default: “”

Identifies the primary contact for the equipment. That parameter can also be set and read from SNMP (refer to the system group of the UNISYNCe MIB).


SYSLOCATION A/N Up to 255 ASCII characters. Default: “”

Indicates where the equipment is located. That parameter can also be set and read from SNMP (refer to the system group of the UNISYNCe MIB).


SYSNAME A/N Up to 255 ASCII characters. Default: “”

Indicates the equipment’s fully-qualified domain name. That parameter can also be set and read from SNMP (refer to the system group of the UNISYNCe MIB).


TRAP1ADDR INT- Each integer can take Specifies the 32 bits IP Valid Commands:

GILLAM-FEi


107

INT-INT-INT

the value from 0 to 255. Default=0-0-0-0

address of an NMS where the traps must be sent. The SNMP agent does not take into account an address set to 0-0-0-0 (default value).

ED-EQPT RTRV-EQPT

TRAP2ADDR INT-INT-INT-INT


Specifies the 32 bits IP address of an NMS where the traps must be sent. The SNMP agent does not take into account an address set to 0-0-0-0 (default value).










TRAPCOMMUNITY A/N Up to 30 ASCII characters. Default: “public”

Specifies the community name that is inserted in the reported traps.


TRAPVERSION ENUM One of the following: • V1 • V2

Default: V2

Specifies the version of the reported SNMP traps.


GILLAM-FEi


108

5.2.1.4.OUTMODULE data dictionary


characters Indicates the CLEI (Common Language Equipment Identifier) of the installed output module.



Indicates the history information of the output module (repairing, guarantee period, …)



Indicates the hardware version of the output module.



Indicates the serial number of the output module.


TYPE ENUM One of the following: � E1 � E1FBM

Identifies the installed plug-in card:

� E1: 10 E1 / 2048 Khz output ports

� E1FBM: 10 E1 / 2048 Khz output ports and 10 E1 / 2048 Khz Feedback Monitoring input ports


GILLAM-FEi


109

5.2.1.5.GPS data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS ANTCABLELGTH INT 0 … 500 Specifies the length of

the antenna cable. That length is expressed in meters and includes two sections of cable:

• between the antenna and the lightning arrester

• between the lightning arrester and the Up Down Converter.

In general, an RG213 cable is used. The default value is 0.

Valid Commands : ED-EQPT RTRV-EQPT

ANTOCM Y/N Y or N Default: Y

Programs the detection of antenna open circuit conditions. Y = antenna open circuit monitoring N = no antenna open circuit monitoring.

Valid Commands: RTRV-EQPT ED-EQPT



FACTORYRESET Y/N Y Forces a factory reset of the GPS. That command must be confirmed by the user (use of the CONF parameter). The GPS deletes its position knowledge and forces at zero the parameters HEIGHT, LATITUDE and LONGITUDE. It then automatically starts a site survey. The parameters HEIGHT, LATITUDE and LONGITUDE will be automatically updated when available from the GPS. To facilitate the GPS site


GILLAM-FEi


110

survey, it is recommended to correctly program the date/time fields of the UNISYNC before initiating the factory reset. Use the TL1 ED-DAT command for this purpose.

HEIGHT A/N Up to 10 ASCII characters

Indicates the height with respect to the GPS reference ellipsoid (WGS84). The units are in meters. Format used: "144.32m" Be sure before modifying the HEIGHT that there is no communication problem with the GPS receiver.

Valid Commands: RTRV-EQPT ED-EQPT

ID A/N Up to 64 ASCII characters

Could indicate the physical location of GPS receiver (User comment).


LATITUDE A/N Up to 20 ASCII characters

Specifies the latitude. Latitude is measured in degrees north or degrees south of the earth's equator. Format used: "15D 33M 45.987S N" "32D 12M 25.231S S" Be sure before modifying the LATITUDE that there is no communication problem with the GPS receiver.


LEDSEL ENUM One of the following: • O • G

Indicates the state of the SEL LED:

• O: Off • G: Green (this

GPS reference has been selected to provide the timing reference to the oscillator)


LEDST ENUM One of the following: • O • G

Indicates the state of the STATUS LED:

• O: Off


GILLAM-FEi


111

• Y • R

• G: Green (provisioned GPS and valid signal)

• Y: Yellow (only MN alarms affect the GPS)

• R: Red (if any CR or MJ alarms affect the GPS)

LONGITUDE A/N Up to 20 ASCII characters

Specifies the longitude. Longitude is measured in degrees east or degrees west of the Greenwich Meridian. Format used: "24D 53M 21.765S E" "120D 45M 34.876S W" Be sure before modifying the LONGITUDE that there is no communication problem with the GPS receiver.


MASKANGLE INT 0 … 80 Default value: 15

Specifies the satellite mask angle. The GPS receiver will attempt to track satellites for which the elevation angle is greater than the satellite mask angle.


NBTRACKEDSAT INT 0 … 12 Indicates the number of tracked satellites.


PRTY INT 1 … 11 Specifies the priority of the GPS. The programmed priority is used to select a qualified REF input. The priority 1 is higher than the priority 11. Default value: 1


PST ENUM One of the following: This keyword indicates the primary state and qualifier information of the entity as defined in GR-1093-CORE. When PST is used in commands that use the ENTER or EDIT verbs, the value of PST


GILLAM-FEi


112

indicates the desired state of the object. When used in the ENTER commands, a null value for PST defaults to IS. When used in the EDIT commands, a null value means no change to the current value of PST. Valid values for PST when used in the ENTER and EDIT commands are:

• IS • OOS

• IS: In-Service • OOS: Out-Of-

Service; OOS-MA implied. Out-Of-Service for Management.

The PST parameter can also be present in the input and NORMAL RESPONSE to a command that uses the RTRV (RETRIEVE) verb. Mutually exclusive qualifier values are shown by the {… …} construct. Valid values for PST when used in the RETRIEVE commands are:

• IS-{NR RST} • OOS- {AU

MA AUMA}

• IS: In-Service with qualifier NR(normal), ANR (abnormal), RST (restricted) or ANRST (abnormal and restricted).

• OOS: Out-Of-Service with qualifier AU (autonomous), AURST (autonomous and

GILLAM-FEi


113

restricted), MA (management), MAANR (management and abnormal) or AUMA (autonomous and management).

QLCUR ENUM One of the following: • G811 • G812T • G812L • G813 • DNU • PRS • STU • ST2 • TNC • ST3E • ST3 • SMC • ST4 • DUS • RES • INVSSM • NOSSM • -

Indicates the current Quality Level of the GPS:

• G811 • G812T • G813 • DNU • PRS • STU • … • -: indicates that

the QL is not available


QLSUBST ENUM One of the following: • G811 • G812T • G812L • G813 • DNU • PRS • STU • ST2 • TNC • ST3E • ST3 • SMC • ST4 • DUS • RES • DEA

Default: DEA

Forces the Quality Level of the GPS. This QL value will be considered by the automata to select a REF input. Valid values are:

• G811 • PRS • ST2 • … • DEA:

deactivation of the Quality Level substitution logic.

By default, the QL substitution logic is disabled.


REF Y/N Y = REF synchronization input.

Indicates that the GPS is handled as a REF input.

Valid Commands : RTRV-EQPT

GILLAM-FEi


114

SITESURVEY Y/N Y or N When entered by the user:

• Y: requests the GPS to perform its automatic position determination algorithm

• N: requests the GPS to abort its current site survey.

When retrieved: • Y: indicates that

the GPS is currently calculating its position

• N: indicates that the survey is completed.

Be sure before starting a site survey that there is no communication alarm with the GPS receiver. Do not modify manually the height, longitude and latitude parameters when a site survey is in progress. These parameters will be automatically updated. Before initiating a GPS site survey, it is recommended to correctly program the date/time fields of the UNISYNC. Use the TL1 ED-DAT command for this purpose.


SSUCABLELGTH INT 0 … 500 Specifies the length of the cable between the UNISYNC unit and the Up Down Converter. That length is expressed in meters. In general, an RG59 cable is used. The default value is 0.


GILLAM-FEi


115

STATE ENUM One of the following: • SITESURVEY • CLDSTRT • SATACQ • SATTRK • POSHOLD • -

When retrieved, indicates the state of the GPS:

• SITESURVEY: the GPS is automatically determining its position. The site survey process is user initiated (see the SITESURVEY parameter)

• CLDSTRT: the GPS is in Cold Start

• SATACQ: the GPS is acquiring satellites

• SATTRK: the GPS is in narrow track mode

• POSHOLD: the GPS is in Position – Hold mode

• - : means that the GPS state is unknown.


WTRTIM INT 20 .. 10000 Default: 20

Specifies/indicates the value of the "Wait To Return" timer. This timer is used to validate the signal at the end of the alarms affecting the GPS. Expressed in seconds.


GILLAM-FEi


116

5.2.1.6.INP input data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS BRIDGED Y/N Y or [N] Y means that the input is

bridged and that the signal input level should be raised of 20 db. The default value is N.

Valid Commands : ENT-EQPT ED-EQPT RTRV-EQPT

CLEI A/N Up to 32 ASCII characters

Indicates the CLEI (Common Language Equipment Identifier) of the input module



Indicates the history information of the input module (repairing, guarantee period, …)



Indicates the hardware version of the input module.



Could indicate the physical location of the synchronization input (User comment).


LEDSEL ENUM One of the following: • O • G

Indicates the state of the SEL LED:

• O: Off • G: Green (this

reference has been selected to provide the timing reference to the oscillator)


LEDST ENUM One of the following: • O • G • Y • R


• O: Off • G: Green

(provisioned input and valid signal)

• Y: Yellow (only MN alarms affect the input)

• R: Red (if any CR or MJ alarms affect the input)


LEVEL A/N Up to 10 ASCII characters

Indicates the approximate voltage level of the input expressed in V peak peak.


GILLAM-FEi


117

PRTY INT 1 … 11 Specifies the priority of the synchronization input. The programmed priority is used to select a qualified REF input. The priority 1 is higher than the priority 11. Default value: 1


PST ENUM One of the following: This keyword indicates the primary state and qualifier information of the entity as defined in GR-1093-CORE. When PST is used in commands that use the ENTER or EDIT verbs, the value of PST indicates the desired state of the object. When used in the ENTER commands, a null value for PST defaults to IS. When used in the EDIT commands, a null value means no change to the current value of PST. Valid values for PST when used in the ENTER and EDIT commands are:


• IS • OOS




• IS-{NR RST} • OOS- {AU MA

AUMA}

• IS: In-Service with qualifier NR(normal), ANR

GILLAM-FEi


118

(abnormal), RST (restricted) or ANRST (abnormal and restricted).

• OOS: Out-Of-Service with qualifier AU (autonomous), AURST (autonomous and restricted), MA (management), MAANR (management and abnormal) or AUMA (autonomous and management).

QLCUR ENUM One of the following: • G811 • G812T • G812L • G813 • DNU • PRS • STU • ST2 • TNC • ST3E • ST3 • SMC • ST4 • DUS • RES • INVSSM • NOSSM • -

Indicates the current Quality Level of the input

• G811 • G812T • G812L • G813 • DNU • PRS • STU • … • -: indicates that the

QL is not available because of the installed interface type


QLSUBST ENUM One of the following: • G811 • G812T • G812L • G813 • DNU • PRS • STU • ST2 • TNC • ST3E

Forces the Quality Level of the input. This QL value will be considered by the automata to select a REF input. Valid values are:

• G811 • G812T • G812L • G813 • DNU


GILLAM-FEi


119

• ST3 • SMC • ST4 • DUS • RES • DEA

Default: DEA

• PRS • ST2 • … • DEA: deactivation

of the Quality Level substitution logic.

By default, the QL substitution logic is disabled.

REF Y/N Y=REF synchronization input. N=measurement input. Default: Y.

Specifies if the input is handled as a REF input or as a measurement input.


RSTSSM Y/N Y In auto SSM mode (SSM=AUTO), force a restart of the SSM code detection logic. This command is only valid if applied to DS1 ESF inputs.



Indicates the serial number of the installed input module.


SSM ENUM One of the following: • AUTO • ON • OFF

Default: AUTO

Indicates the SSM mode: • AUTO: the

UNISYNC will automatically activate the SSM logic if a valid SSM code is detected at the input

• ON: the UNISYNC activates the SSM logic

• OFF: the UNISYNC doesn’t manage the SSM codes

The SSM logic can always be restarted in the AUTO mode with the RSTSSM keyword.


TYPE ENUM One of the following: • DS1SF • DS1ESF • E1SF • E1MF

Identifies the input being provisioned:

• DS1SF: T1 signal in Super Frame format (usually

Valid Commands : ENT-EQPT ED-EQPT RTRV-EQPT Other :

GILLAM-FEi


120

• CC • S2048KHZ • S1510MHZ • DCF77

framed all-ones signal)

• DS1ESF : T1 signal in Extended Super Frame format

• E1SF: E1 signal in a Single Frame format

• E1MF: E1 signals in a Multi Frame format with CAS and CRC4

• CC : CC signal • S2048KHZ : 2.048

MHz signal • S1510MHZ: 1

MHz signal, 5 MHz signal or 10 MHz signal

• DCF77: DCF77 signal (requires the installation of a DCF77 input module)

The type of the input can only be modified if the input is set Out Of Service.

WTRTIM INT 20 .. 10000 Default: 20

Specifies/indicates the value of the "Wait To Return" timer. This timer is used to validate the signal at the end of the alarms affecting the input. Expressed in seconds.

Valid Commands: ENT-EQPT ED-EQPT RTRV-EQPT

GILLAM-FEi


121

5.2.1.7.AUX output data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS ALMDE ENUM One of the following:

• NONE • SQUELCH

Default: NONE

Specifies the behaviour of the UNISYNC when the output signal becomes unsuitable for synchronization use:


• SQUELCH: the output signal is squelched (default mode)

It should be noted that all the outputs of the UNISYNC are always squelched during the warm up of the oscillator.



Could indicate the physical location of the output (User comment).




• IS • OOS



The PST parameter can also

GILLAM-FEi


122

be present in the input and NORMAL RESPONSE to a command that uses the RTRV (RETRIEVE) verb. Mutually exclusive qualifier values are shown by the {… …} construct. Valid values for PST when used in the RETRIEVE commands are:


MA AUMA}


• OOS: Out-Of-Service with qualifier AU (autonomous), AURST (autonomous and restricted), MA (management), MAANR (management and abnormal) or AUMA (autonomous and management).

TYPE ENUM One of the following: • S1MHZ • S5MHZ • S10MHZ

Identifies the output being provisioned:

• S1MHZ: signal at 1 Mhz




GILLAM-FEi


123

5.2.1.8. OUT output data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS ALMDE ENUM One of the following:

• NONE • SQUELCH • E1ALM

The default value depends on the TYPE of the output.

Specifies the behaviour of the UNISYNC when the output signal becomes unsuitable for synchronization use. The supported mode depends on the output TYPE: For a S2048KHZ output:


• SQUELCH: the output signal is squelched.

NONE is the default mode for the S2048KHZ output. For an E1 output:

• SQUELCH: the output signal is squelched

• E1ALM: the alarming mode is defined in the E1SFALM parameter for an E1SF output. It is defined in the E1MFALM parameter for an E1MF output.

E1ALM is the default mode for the E1 output. The type of E1 signal supplied by the UNISYNC depends on the E1TYPE parameter of the SSU object entity. Refer also to the SSU data dictionary for definition of the parameters E1MFALM and E1SFALM. It should be noted that all the outputs of the UNISYNC are always squelched during the warm up of the oscillator.



Could indicate the physical location of the output (User comment).


GILLAM-FEi


124



• IS • OOS





MA AUMA}


• OOS: Out-Of-Service with qualifier AU (autonomous), AURST (autonomous and restricted), MA (management), MAANR

GILLAM-FEi


125

(management and abnormal) or AUMA (autonomous and management).

QLCUR ENUM One of the following: • G811 • STU • G812T • G812L • G813 • DNU • -

Indicates the current quality level of the output port:

• G811 • G812T • … • - : indicates that the

QL is not available.

Valid commands : RTRV-EQPT

TYPE ENUM One of the following: • S2048KHZ • E1

Identifies the output being provisioned:

• S2048KHZ: signal at 2048 Khz

• E1: signal at 2048 Kbps

The generated E1 signal depends on the E1TYPE parameter of the SSU object entity. It can be:

• E1SF: G704 frame with no multiframe structure

• E1MF: G704 frame with multiframe structure (CAS and CRC4).


GILLAM-FEi


126

5.2.1.9. OSC data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS CONF Y/N Y Confirms Service Affecting

TL1 command. Valid Commands: ED-EQPT

FFOFFTH INT 100 .. 1000000 0 Default: 60000

Specifies the threshold used for frequency offset alarm detection. Expressed in 10exp-12. The value 0 can be used to deactivate the management of the FFOFF alarm.


FREQCMD INT -5000000 .. 5000000 Controls the frequency of the oscillator: expressed in ∆f/f (10exp-12). The oscillator must be first set in the CMD state (refer to the STATE parameter definition in this dictionary).



Could indicate the physical location of the oscillator (User comment).


LEDACQ ENUM One of the following: • O • G

Indicates the state of the ACQUIRE LED:

• O: Off • G: Green (oscillator

in acquire)


LEDHO ENUM One of the following: • O • R

Indicates the state of the HOLDOVER LED:

• O: Off • R: Red (oscillator in

holdover)


LEDLK ENUM One of the following: • O • G

Indicates the state of the LOCKED LED:

• O: Off • G: Green (oscillator

in locked state)


LEDST ENUM One of the following: • O • G • Y • R


• O: Off • G: Green (normal

operating condition) • Y: Yellow (MN

alarms affecting the oscillator or oscillator in warm-up)

• R: Red (hardware


GILLAM-FEi


127

failure affecting the oscillator)



• IS • OOS




• IS-NR • IS-ANR • OOS- {AU MA

AUMA}

• IS: In-Service with qualifier NR(normal), ANR (abnormal).

• OOS: Out-Of-Service with qualifier AU (autonomous), MA (management), MAANR (management and

GILLAM-FEi


128

abnormal) or AUMA (autonomous and management).

STATE ENUM One of the following: • NORMAL • LOCKED • BRIDGING • HOLDOVER • WMUP • FREERUN • ACQUIRE • CMD • -

When retrieved, indicates the state of the oscillator:

• LOCKED: DPLL in locked mode.

• BRIDGING: in bridging mode

• HOLDOVER: DPLL in confirmed holdover mode

• WMUP: warm-up • FREERUN:

oscillator in free-run • ACQUIRE:

oscillator in fast-start

• CMD: oscillator in command state

• -: unknown When edited, the state of the oscillator can be directed to:

• FREERUN • HOLDOVER • CMD: in this state,

it is possible to control the frequency of the oscillator (see the parameter FREQCMD in this dictionary).

• NORMAL: depending on the conditions affecting the UNISYNC, the oscillator can go to WMUP, HOLDOVER, BRIDGING, ACQUIRE, FREERUN or LOCKED.

Valid Cmds : ED-EQPT RTRV-EQPT

TDPLLDCF77 INT 10 .. 100000 Time constant of the DCF77 DPLL expressed in seconds. Default values automatically


GILLAM-FEi


129

programmed in function of the type of oscillator.

TDPLLGPS INT 10 .. 100000 Time constant of the GPS DPLL expressed in seconds. Default values automatically programmed in function of the type of oscillator.


TDPLLINP INT 10 .. 100000 Time constant of the inputs DPLL expressed in seconds. Default values automatically programmed in function of the type of oscillator.


TYPE ENUM One of the following: • STR2 • STR3E • STR3

Indicates the type of installed oscillator:

• STR2: Stratum 2 oscillator

• STR3E: Stratum 3E oscillator

• STR3: Stratum 3 oscillator

The oscillator type implies the respect of the standards and its associated values for free-run accuracy, holdover stability, pull-in/hold-in range, transient, filtering, ….


WARMUP INT 60…100000; Default: 1800.

Warm-up time for the oscillator expressed in seconds.


GILLAM-FEi


130

5.2.1.10.FBM data dictionary

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS DFF A/N Up to 10 ASCII

characters Indicates the frequency offset of the feedback monitoring input interface. Scientific notation format: i.e., "5.3e-012".


GT10M8 ENUM One of the following: • CR • MJ • MN • NA • NR

Default: MJ

Specifies the notification code associated with the alarm "Frequency error greater than 10exp-8":

• CR: Critical alarm • MJ: Major alarm • MN: Minor alarm • NA: Not Alarmed • NR: Not Reported

(when the event occurs the condition is retained in the Unisync).



Default: MJ






Default: MN



(when the event occurs the condition is retained in the


GILLAM-FEi


131

Unisync). GT10M11 ENUM One of the following:

• CR • MJ • MN • NA • NR

Default: MN






Could identify the feedback monitoring input (User comment).


LEVEL A/N Up to 10 ASCII characters

Indicates the approximate voltage level of the feedback monitoring input expressed in V peak peak. Format: i.e., "5.5 Vpp".


PHASE A/N Up to 20 ASCII characters

Indicates the phase offset since the beginning of the feedback monitoring input measurement process. Expressed in nsec. Format: i.e., "-4 nsec".




• IS • IS: In-Service

GILLAM-FEi


132

• OOS • OOS: Out-Of-Service; OOS-MA implied. Out-Of-Service for Management.


• IS-NR • IS-ANR • OOS- {AU

MA}

• IS: In-Service with qualifier NR(normal), ANR (abnormal).

• OOS: Out-Of-Service with qualifier AU (autonomous), MA (management).

RSTALM Y/N Y Restarts the feedback monitoring input measurement process.


TIME A/N Up to 25 ASCII characters

Indicates the phase measurement time. Expressed in days and seconds. Format used:

• 1000 sec • 1 day 300 sec • 2 days 45213 sec.


TYPE ENUM One of the following: • E1 • S2048KHZ

Specifies the type of the feedback monitoring input:

• E1: E1 signal in Single Frame format or in Extended Super Frame format

• S2048KHZ: 2.048 MHz signal


GILLAM-FEi


133

5.2.2. User’s interface port/channel data dictionary

5.2.2.1.Craft port data dictionary

For each of the commands related to this View, the AID is the Channel Identifier (CID). It may be a single CID or a block of CIDs, where the block may include all CIDs.

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS AO Y/N Y=Enable the

Autonomous Outputs. N=Disable the Autonomous Outputs. Default : Y.

Controls the transmission of the automatic messages.

Valid Commands: ED-CID RTRV-CID

ATSTR A/N NULL or any combination of alphanumeric characters from 1 to 20 characters in length. Default: NULL.

Specifies the initial AT command that must be sent to the modem.

Valid Commands: ED-CID RTRV-CID Applicable only if: LOCAL=N

CNB A/N NULL or any combination of alphanumeric characters from 1 to 20 characters in length. Default: NULL.

Specifies the called PSTN number.

Valid Commands: ED-CID RTRV-CID Applicable only if: LOCAL=N

DATA ENUM • 7 • 8

Default: 8.

Specifies the number of data bits per character:

• 7: 7 data bits per character

• 8: 8 data bits per character


ECHO Y/N Y=local echo N=no local echo Default: Y.

Determines if local echo is needed.


FLOW ENUM • HW • SW • NONE

Default: NONE.

Specifies the type of flow control to apply on the craft port:

• HW: hardware flow control

• SW: XON/XOFF flow control

• NONE: no flow control


GILLAM-FEi


134

HMI Y/N Y=Human Machine Interface. N=Machine Machine Interface. Default : Y.

Programs the behaviour of the TL1 for a Human Machine Interface or a Machine Machine Interface.


LOCAL Y/N Y=local craft terminal N=remote OS Default=Y.

Specifies if the craft port is connected to a local craft terminal or to a remote OS.


PMRFSH INT 1…3600 Default: 900.

Specifies the automatic refresh period of the requested PM parameters. Values expressed in seconds.


PRTY ENUM • NONE • ODD • EVEN

Default: NONE.

Specifies the parity used on the port:

• NONE: no parity • ODD: odd parity • EVEN: even parity



• IS

Indicates the state of the port: • IS: In-Service

Valid Commands: RTRV-CID

SPEED ENUM • 110 • 300 • 600 • 1200 • 2400 • 4800 • 9600 • 14400 • 19200 • 38400 • 56000 • 57600 • 115200

Default: 9600

Specifies the speed of the craft port. Values expressed in bits per second.


STOP ENUM • 1 • 2

Default: 1.

Specifies the number of stop bits used on the craft port:

• 1: 1 stop bit • 2: 2 stop bit


SVREPORT ENUM One of the following:

• CR • MJ • MN • NONE

Default: MJ

Specifies the required severity of a report to force the opening of a remote PSTN connection:

• CR: critical • MJ: major • MN: minor

The following conditions must also be met:

• AO=Y


GILLAM-FEi


135

• PST=IS • LOCAL=N • Valid CNB

GILLAM-FEi


136

5.2.2.2.TL1 remote manager data dictionary


AO Y/N Y=Enable the Autonomous Outputs. N=Disable the Autonomous Outputs. Default : Y.



ECHO Y/N Y=local echo N=no local echo Default: N.



HMI Y/N Y=Human Machine Interface. N=Machine Machine Interface. Default : N.



IPADDR INT-INT-INT-INT

Each integer can take the value from 0 to 255. Default: 0-0-0-0

IP address of a remote manager (OS). The 32 bits IP address is coded as 4 integers separated by a dash: i.e., 192-6-2-65. The IPADDR parameter value determines the behaviour of the UNISYNC: - 0-0-0-0: This resource can be used to manage incoming TCP/IP calls if the IP address of the calling system is not programmed in any of the six TL1MNG communication resources. The UNISYNC is never going to use this resource to generate an outgoing TCP/IP call in case of alarm appearance (see parameter SVREPORT). - An IP address different

from 0-0-0-0: This resource can be used to manage incoming TCP/IP calls whose calling IP address corresponds to the value programmed here.


GILLAM-FEi


137

The UNISYNC can use this resource to generate an outgoing TCP/IP call in case of alarm appearance (see parameter SVREPORT).

TL1PORT INT 1…65535 Default : 71

Specifies the TCP port of the remote OS manager.



Returns the automatic refresh period of the requested PM parameters. Values expressed in seconds.



• IS

Indicates the state of the port: • IS: In-Service


SVREPORT ENUM One of the following:

• CR • MJ • MN • NONE

Default: MJ

Specifies the required severity of a report to force the opening of a TCP/IP connection to a remote manager addressed by the socket formed by the couple IPADDR and TL1PORT:

• CR: critical • MJ: major • MN: minor • NONE: no open of a

remote TCP/IP connection.

The following conditions must also be met:

• AO=Y • PST=IS • Valid IPADDR (not 0-

0-0-0)


GILLAM-FEi


138

5.2.2.3.Telnet channels data dictionary

For each of the commands related to this View, the AID is the Channel Identifier (CID).

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS AO Y/N Y=Enable the

Autonomous Outputs. N=Disable the Autonomous Outputs. Default : Y.



ECHO Y/N Y=local echo N=no local echo Default: Y.



HMI Y/N Y=Human Machine Interface. N=Machine Machine Interface. Default : Y.




Returns the automatic refresh period of the requested PM parameters. Values expressed in seconds.



• IS

Indicates the state of the telnet channels:

• IS: In-Service


TELNCUR INT 0…4 Gives the number of current active telnet sessions.


TELNB INT 1…4. Default: 4.

Specifies the number of simultaneous active telnet sessions authorized.


GILLAM-FEi


139

5.2.3. Security data dictionary

5.2.3.1.User-Related Security data dictionary

For each of the commands related to this View, the AID is the User Identifier (UID, i.e., user’s login name).

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS CID (ENUM)+ A list of user

interface ports/channels:

• CRAFT1 • CRAFT2 • TL1MNG1 • TL1MNG2 • TL1MNG3 • TL1MNG4 • TL1MNG5 • TL1MNG6 • TELN • ALL

Default: ALL.

User’s interface port/channel. When a session initiation request (i.e., log-in) is received, the NE checks the CID against the CID as stored in the NE database. Valid values are:

• CRAFT1: access from craft port #1

• CRAFT2: access from craft port #2

• TL1MNG1: access from remote OS #1






• TELN: Telnet access • ALL: access from all

ports.

Valid Commands: ENT-USER-SECU ED-USER-SECU RTRV-USER-SECU

PID A/N Up to 10 characters, where at least two are non-alphabetic characters with at least one special character.

The Password. It must be stored in a one-way encrypted form so the user-related security view does not reveal it.


UAP A/N A compound parameter of up to 4 access privileges connected by the symbol &.

User Access Privilege. A user is allowed to have up to 4 access privileges:

• NONE • USER


GILLAM-FEi


140

Default: NONE. • ADMIN • SECU

UID* A/N Up to 10 alphanumeric characters.

The User Identifier. It is a nonconfidential identifier that uniquely determines a user (login name). This parameter is the “key” for each record in this view. Each user must have a unique UID.


GILLAM-FEi


141

5.2.3.2.Channel-Related Security data dictionary


KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS CHAP A/N A compound

parameter of up to 4 access privileges connected by the symbol &.

Channel Access Privilege. A channel may be assigned up to 4 access privileges:

• NONE • USER • ADMIN • SECU

Valid Commands: ED-CID-SECU RTRV-CID-SECU

CID* (ENUM) A user interface port/channel :

• CRAFT1 • CRAFT2 • TL1MNG1 • TL1MNG2 • TL1MNG3 • TL1MNG4 • TL1MNG5 • TL1MNG6 • TELN

.

Channel Identifier. It addresses a user interface port/channel. This parameter is the key for each record in this view. Valid values are:

• CRAFT1 : craft port #1 • CRAFT2 : craft port #2 • TL1MNG1: remote OS

#1 • TL1MNG2: remote OS





#6 • TELN: Telnet access


MXINV INT 1 … 9 Default: 9.

Specifies the maximum number of invalid session setup attempts allowed (illegal UID, PID, CID, …) before it is suspected as an intrusion attempt and appropriate action taken such as generating alert messages.


TMOUT INT 0 … 4320 Default: 40.

Time Out Interval expressed in minutes. If there are no exchanged messages on the port/channel over the TMOUT interval, the session is logged


GILLAM-FEi


142

off. Value 0 means no activity time out detection.

5.2.3.3.Command-Related Security data dictionary

For each of the commands related to this View, the AID is the command verb along with verb modifier(s). It may be a single command or a block of commands, where the block may include all commands.

KEYWORD TYPE DOMAIN DESCRIPTION RESTRICTIONS COMMAND* A/N Any combination of

up to 20 characters. Command Verb together with verb modifiers. For example, ENT-CMD-SECU is a command where ENT is the verb that has two modifiers: CMD and SECU. This parameter is the key for each record in this view.

Valid Commands: ED-CMD-SECU RTRV-CMD-SECU

CAP (ENUM)+ A list of up to 4 access privileges:

• NONE • USER • ADMIN • SECU

Command Access Privilege. A command is allowed up to 4 access privileges. Before executing a command, the UNISYNC checks if at least one of these access privileges is contained within the intersection of UAP and CHAP. If not, the NE refuses to execute the command. See the CAP list for default values.

Valid Commands: ED-CMD-SECU RTRV-CMD-SECU

GILLAM-FEi


143

5.3. List of Time Zones

TZ Description of the Time Zone

AFGHANISTANST (UTC+04:30) Afghanistan Standard Time ALASKANST (UTC-09:00) Alaskan Standard Time ARABST (UTC+03:00) Arab Standard Time ARABIANST (UTC+04:00) Arabian Standard Time ARABICST (UTC+03:00) Arabic Standard Time ATLANTICST (UTC-04:00) Atlantic Standard Time AUSCENTRALST (UTC+09:30) AUS Central Standard Time AUSEASTERNST (UTC+10:00) AUS Eastern Standard Time AZERBAIJANST (UTC+04:00) Azerbaijan Standard Time AZORESST (UTC-01:00) Azores Standard Time CANADACENTRALST (UTC-06:00) Canada Central Standard Time CAPEVERDEST (UTC-01:00) Cape Verde Standard Time CAUCASUSST (UTC+04:00) Caucasus Standard Time CENAUSTRALIAST (UTC+09:30) Cen. Australia Standard Time CENTRALAMERICAST (UTC-06:00) Central America Standard Time CENTRALASIAST (UTC+06:00) Central Asia Standard Time CENTRALBRAZILIANST (UTC-04:00) Central Brazilian Standard Time CENTRALEUROPEST (UTC+01:00) Central Europe Standard Time CENTRALEUROPEANST (UTC+01:00) Central European Standard Time CENTRALPACIFICST (UTC+11:00) Central Pacific Standard Time CENTRALST (UTC-06:00) Central Standard Time CENTRALSTMEXICO (UTC-06:00) Central Standard Time (Mexico) CHINAST (UTC+08:00) China Standard Time DATELINEST (UTC-12:00) Dateline Standard Time EAFRICAST (UTC+03:00) E. Africa Standard Time EAUSTRALIAST (UTC+10:00) E. Australia Standard Time EEUROPEST (UTC+02:00) E. Europe Standard Time ESOUTHAMERICAST (UTC-03:00) E. South America Standard Time EASTERNST (UTC-05:00) Eastern Standard Time EGYPTST (UTC+02:00) Egypt Standard Time EKATERINBURGST (UTC+05:00) Ekaterinburg Standard Time FIJIST (UTC+12:00) Fiji Standard Time FLEST (UTC+02:00) FLE Standard Time GEORGIANST (UTC+03:00) Georgian Standard Time GMTST (UTC) GMT Standard Time GREENLANDST (UTC-03:00) Greenland Standard Time GREENWICHST (UTC) Greenwich Standard Time GTBST (UTC+02:00) GTB Standard Time

GILLAM-FEi


144

HAWAIIANST (UTC-10:00) Hawaiian Standard Time INDIAST (UTC+05:30) India Standard Time IRANST (UTC+03:30) Iran Standard Time JERUSALEMST (UTC+02:00) Jerusalem Standard Time JORDANST (UTC+02:00) Jordan Standard Time KOREAST (UTC+09:00) Korea Standard Time MALAYPENINSULAST (UTC+08:00) Malay Peninsula Standard Time MIDATLANTICST (UTC-02:00) Mid-Atlantic Standard Time MIDDLEEASTST (UTC+02:00) Middle East Standard Time MONTEVIDEOST (UTC-03:00) Montevideo Standard Time MOUNTAINST (UTC-07:00) Mountain Standard Time MOUNTAINSTMEXICO (UTC-07:00) Mountain Standard Time (Mexico) MYANMARST (UTC+06:30) Myanmar Standard Time NAMIBIAST (UTC+02:00) Namibia Standard Time NCENTRALASIAST (UTC+06:00) N. Central Asia Standard Time NEPALST (UTC+05:45) Nepal Standard Time NEWZEALANDST (UTC+12:00) New Zealand Standard Time NEWFOUNDLANDST (UTC-03:30) Newfoundland Standard Time NORTHASIAEASTST (UTC+08:00) North Asia East Standard Time NORTHASIAST (UTC+07:00) North Asia Standard Time PACIFICSAST (UTC-04:00) Pacific SA Standard Time PACIFICST (UTC-08:00) Pacific Standard Time PACIFICSTMEXICO (UTC-08:00) Pacific Standard Time (Mexico) ROMANCEST (UTC+01:00) Romance Standard Time RUSSIANST (UTC+03:00) Russian Standard Time SAEASTERNST (UTC-03:00) SA Eastern Standard Time SAPACIFICST (UTC-05:00) SA Pacific Standard Time SAWESTERNST (UTC-04:00) SA Western Standard Time SAMOAST (UTC-11:00) Samoa Standard Time SEASIAST (UTC+07:00) SE Asia Standard Time SOUTHAFRICAST (UTC+02:00) South Africa Standard Time SRILANKAST (UTC+06:00) Sri Lanka Standard Time TAIPEIST (UTC+08:00) Taipei Standard Time TASMANIAST (UTC+10:00) Tasmania Standard Time TOKYOST (UTC+09:00) Tokyo Standard Time TONGAST (UTC+13:00) Tonga Standard Time USEASTERNST (UTC-05:00) US Eastern Standard Time USMOUNTAINST (UTC-07:00) US Mountain Standard Time VLADIVOSTOKST (UTC+10:00) Vladivostok Standard Time WAUSTRALIAST (UTC+08:00) W. Australia Standard Time WCENTRALAFRICAST (UTC+01:00) W. Central Africa Standard Time WEUROPEST (UTC+01:00) W. Europe Standard Time WESTASIAST (UTC+05:00) West Asia Standard Time WESTPACIFICST (UTC+10:00) West Pacific Standard Time

GILLAM-FEi


145

YAKUTSKST (UTC+09:00) Yakutsk Standard Time

GILLAM-FEi


146

5.4. <aid> - Access Identifier

<aid> represents the AID that identifies an entity (or group thereof) in the UNISYNC to which the command pertains. Addressing rules are discussed in section 2.6.4.1.

GILLAM-FEi


147

5.5. <almcde> - Alarm Code

<almcde> identifies the nature of the automatic message based on its priority of action. The valid values of <almcde> in decreasing order of severity are as follows:

<almcde> ALARM DESCRIPTION *C Critical Alarm ** Major Alarm *^ Minor Alarm A^ Automatic Message

If the notification code, <ntfcncde>, is CL, <almcde>, will be A^. If multiple alarms are reported, <almcde> is the highest severity of those reported.

GILLAM-FEi


148

5.6. <almescl> - Alarm Escalation

<almescl> indicates if the alarm condition must be escalated after the time specified in <escltim>

Value Value usage ESCL Escalation of alarm requested NESCL No escalation of alarm requested

GILLAM-FEi


149

5.7. Command Access Privilege (CAP) List

COMMAND COMMAND ACCESS PRIVILEGE (default) NONE USER ADMIN SECU

ACT-USER x x x x ALW-MSG x ALW-USER-SECU x CANC-CID-SECU x CANC-USER x x x CANC-USER-SECU

x

DLT-EQPT x DLT-SECU x DLT-USER-SECU x ED-CID x ED-CID-SECU x ED-CMD-SECU x ED-DAT x ED-EQPT x ED-PID x x x ED-USER-SECU x ENT-EQPT x ENT-USER-SECU x HELP x x x x INH-MSG x INH-USER-SECU x INIT-LOG x INIT-REG x INIT-SYS x MENU x x x x OPR-ACO x x RTRV-ALM x x RTRV-ALM-SECU x RTRV-AO x x RTRV-ATTR x x RTRV-CID x x RTRV-CID-SECU x RTRV-CMD-SECU x RTRV-COND x x RTRV-EQPT x x RTRV-HDR x x x RTRV-LOG x x RTRV-NETYPE x x

GILLAM-FEi


150

RTRV-NETYPE-ALL

x x

RTRV-PM x x

RTRV-SAT x x

RTRV-STATUS x x x x RTRV-USER x x x RTRV-USER-SECU

x

SCHED-PMREPT x x SET-ATTR x SET-SID x

GILLAM-FEi


151

5.8. <conddescr> - Condition Description

<conddescr> is a detailed text description of the condition, state, trouble (ALM commands) or specific event. <conddescr> contains a text string of no more than 64 characters enclosed within a pair of escaped quotes.

GILLAM-FEi


152

5.9. <condtype> - Condition Types

The UNISYNC reports the most specific condition type that describes the condition. The construct T-x allows for <condtype>s that identify threshold violations. For example, T-TDEV-100S pertains to a threshold violation for the monitored parameter TDEV-100S. In the following tables :

- NR* means “Not Reported transient” condition - NA* means “Not Alarmed transient” condition

GILLAM-FEi


153

5.9.1. <condtype> affecting SSU card

<condtype> <conddescr> <ntfcncde> <srveff> <logctl>

LOGBUFRINIT-EVT EVT Log buffer initialized NR* N Y LOGBUFR90-EVT EVT Log buffer 90% full NR N Y LOGBUFROVFL-EVT EVT Log buffer overflow NR N Y LOGBUFRINIT-SECU SECU Log buffer initialized NR* N Y LOGBUFR90-SECU SECU Log buffer 90% full NR N Y LOGBUFROVFL-SECU SECU Log buffer overflow NR N Y LOGBUFRINIT-DBCHG DBCHG Log buffer initialized NR* N Y LOGBUFR90-DBCHG DBCHG Log buffer 90% full NR N Y LOGBUFROVFL-DBCHG DBCHG Log buffer overflow NR N Y BOOT System started NA* N Y SFT Internal Software Event

generated NA N Y

INTRU Intrusion attempt suspected NA* N Y EDDAT Date and time modification NR N Y LOGBUFRINIT-AO AO Log buffer initialized NR* N Y LOGBUFR90-AO AO Log buffer 90% full NR N Y LOGBUFROVFL-AO AO Log buffer overflow NR N Y DBLOAD Start WKG DB loading from

PRI DB NA* N Y

ENDDBLOAD WKG DB loading completed NA* N Y NOCOMPATFF No Compatibility File Found CR Y Y BADCOMPATFF Bad Compatibility File Format CR Y Y BADCOMPATFV Bad Compatibility File Version CR Y Y HWCM Hardware Compatibility

Mismatch CR Y Y

DBCM DB Compatibility Mismatch CR Y Y E48VA No External –48VA detected MJ Y Y E48VB No External –48VB detected MJ Y Y FRCDSYNMDE Forced Reference Switch

Mode MN Y Y

SYNCOOS Loss of all timing references MJ Y Y LOWQLOUT Low quality output signals

(ALMDE) MJ Y Y

OUTSQ Output signals squelched (Warm-up)

MN N Y

FPGAERR FPGA hardware failure MJ Y Y OSCMISSING Oscillator module missing MJ Y Y LEDCHG Change of LED state NA* N N GPSDATE Date and time modification NR* N Y

GILLAM-FEi


154

5.9.2. <condtype> affecting GPS


CNFERR Configuration error MJ Y Y HWERR Hardware failure MJ Y Y SIS Set In Service NR* N Y SOOS Set Out Of Service NR* N Y REFSEL Reference input selected NA* N Y UEQ Unequipped with necessary card MJ Y Y SITESURVEY Site survey in progress NA N Y CLDSTRT GPS in coldstart NA N Y SATACQ Satellites acquisition NA N Y SATTRKNG Satellites tracking NA N Y POSHOLD Position HOLD NA N Y UDCCOMERR No �omm.. with receiver MN Y Y NOPPS No 1 PPS signal MN Y Y UDCOC Up Down Converter open circuit MN Y Y UDCSC Up Down Converter short circuit MN Y Y ANTOC Antenna open circuit MN Y Y ANTSC Antenna short circuit MN Y Y NOSAT No satellite detected MN Y Y TOOFEWSAT Too few satellites detected MN Y Y LOWQL SSM Quality Level below active clock MN N Y PNF Position Not Fixed MJ Y Y INPVAL Input signal validation NA N Y LEDCHG Change of LED state NA* N N

GILLAM-FEi


155

5.9.3. <condtype> affecting AUX output ports


OEENT Object Entity creation NR* N Y OEDLT Object Entity deletion NR* N Y SIS Set In Service NR* N Y SOOS Set Out Of Service NR* N Y HWERR Hardware failure MJ Y Y SCDET Short Circuit detected MN Y Y

GILLAM-FEi


156

5.9.4. <condtype> affecting OUT output ports


OEENT Object Entity creation NR* N Y OEDLT Object Entity deletion NR* N Y SIS Set In Service NR* N Y SOOS Set Out Of Service NR* N Y HWERR Hardware failure MJ Y Y SCDET Short Circuit detected MN Y Y UEQ Unequipped with necessary card MJ Y Y MEA TYPE incompat. with output module MJ Y Y

GILLAM-FEi


157

5.9.5. <condtype> affecting INP input ports


CNFERR Configuration error MJ Y Y LOS Loss of signal MN N Y CCLOS Loss of a CC reference MJ N Y OOF Out Of Frame MN N Y AIS Alarm Indication Signal MN N Y BPV BPV errors dectected MN N Y INVSSM Invalid SSM Code detected MN N Y VCXOSI Signal impairment MJ N Y HWERR Hardware failure MJ Y Y PHCOMPERR Phase comparator not running MN N Y

LOWQL SSM Quality Level below active clock MN N Y

SIS Set In Service NR* N Y SOOS Set Out Of Service NR* N Y REFSEL Reference input selected NA* N Y OEENT Object Entity creation NR* N Y OEDLT Object Entity deletion NR* N Y UEQ Unequipped with necessary card MJ Y Y FFOFF Frequency Offset detected MN N Y OVERVOLTAGE Overvoltage detected MN N Y BADFREQ Bad Frequency detected MN Y Y PPBLDOUT Positive Phase Build OUT detected NA* N Y NPBLDOUT Negative Phase Build OUT detected NA* N Y T-FFOFF3S FF0FF3S Threshold MN N Y T-FFOFF10S FF0FF10S Threshold MN N Y T-FFOFF30S FF0FF30S Threshold MN N Y T-FFOFF100S FF0FF100S Threshold MN N Y T-FFOFF300S FF0FF300S Threshold MN N Y T-FFOFF1000S FF0FF1000S Threshold MN N Y T-FFOFF3000S FF0FF3000S Threshold MN N Y T-FFOFF10000S FF0FF10000S Threshold MN N Y T-FFOFF30000S FF0FF30000S Threshold MN N Y T-FFOFF100000S FF0FF100000S Threshold MN N Y T-TIE1S TIE1S Threshold MN N Y T-TLMRTIE1S LMRTIE1S Threshold MN N Y T-TLMRTIE1M LMRTIE1M Threshold MN N Y T-TLMRTIE15M LMRTIE15M Threshold MN N Y T-TLMRTIE30M LMRTIE30M Threshold MN N Y T-TLMRTIE1H LMRTIE1H Threshold MN N Y T-TLMRTIE2H LMRTIE2H Threshold MN N Y T-TLMRTIE8H LMRTIE8H Threshold MN N Y T-TLMRTIE24H LMRTIE24H Threshold MN N Y T-TDEV1S TDEV1S Threshold MN N Y T-TDEV3S TDEV3S Threshold MN N Y T-TDEV10S TDEV10S Threshold MN N Y T-TDEV30S TDEV30S Threshold MN N Y

GILLAM-FEi


158

T-TDEV100S TDEV100S Threshold MN N Y T-TDEV300S TDEV300S Threshold MN N Y T-TDEV1000S TDEV1000S Threshold MN N Y T-TDEV3000S TDEV3000S Threshold MN N Y T-DEV10000S TDEV10000S Threshold MN N Y T-MRTIE1S MRTIE1S Threshold MN N Y T-MRTIE1M MRTIE1M Threshold MN N Y T-MRTIE15M MRTIE15M Threshold MN N Y T-MRTIE30M MRTIE30M Threshold MN N Y T-MRTIE1H MRTIE1H Threshold MN N Y T-MRTIE2H MRTIE2H Threshold MN N Y T-MRTIE8H MRTIE8H Threshold MN N Y T-MRTIE24H MRTIE24H Threshold MN N Y SSMCHG SSM changed from PRS to ST2 NA* N Y SSMCHG SSM changed from PRS to STU NA* N Y SSMCHG SSM changed from PRS to TNC NA* N Y SSMCHG SSM changed from PRS to ST3E NA* N Y SSMCHG SSM changed from PRS to ST3 NA* N Y SSMCHG SSM changed from PRS to SMC NA* N Y SSMCHG SSM changed from PRS to ST4 NA* N Y SSMCHG SSM changed from PRS to DUS NA* N Y SSMCHG SSM changed from No SSM to PRS NA* N Y SSMCHG SSM changed from ST2 to PRS NA* N Y SSMCHG SSM changed from ST2 to STU NA* N Y SSMCHG SSM changed from ST2 to TNC NA* N Y SSMCHG SSM changed from ST2 to ST3E NA* N Y SSMCHG SSM changed from ST2 to ST3 NA* N Y SSMCHG SSM changed from ST2 to SMC NA* N Y SSMCHG SSM changed from ST2 to ST4 NA* N Y SSMCHG SSM changed from ST2 to DUS NA* N Y SSMCHG SSM changed from No SSM to ST2 NA* N Y SSMCHG SSM changed from ST3E to PRS NA* N Y SSMCHG SSM changed from ST3E to STU NA* N Y SSMCHG SSM changed from ST3E to TNC NA* N Y SSMCHG SSM changed from ST3E to ST2 NA* N Y SSMCHG SSM changed from ST3E to ST3 NA* N Y SSMCHG SSM changed from ST3E to SMC NA* N Y SSMCHG SSM changed from ST3E to ST4 NA* N Y SSMCHG SSM changed from ST3E to DUS NA* N Y

SSMCHG SSM changed from No SSM to ST3E NA* N Y

SSMCHG SSM changed from ST3 to PRS NA* N Y SSMCHG SSM changed from ST3 to STU NA* N Y SSMCHG SSM changed from ST3 to TNC NA* N Y SSMCHG SSM changed from ST3 to ST2 NA* N Y SSMCHG SSM changed from ST3 to ST3E NA* N Y SSMCHG SSM changed from ST3 to SMC NA* N Y SSMCHG SSM changed from ST3 to ST4 NA* N Y SSMCHG SSM changed from ST3 to DUS NA* N Y SSMCHG SSM changed from No SSM to ST3 NA* N Y SSMCHG SSM changed from STU to PRS NA* N Y SSMCHG SSM changed from STU to ST2 NA* N Y

GILLAM-FEi


159

SSMCHG SSM changed from STU to TNC NA* N Y SSMCHG SSM changed from STU to ST3E NA* N Y SSMCHG SSM changed from STU to ST3 NA* N Y SSMCHG SSM changed from STU to SMC NA* N Y SSMCHG SSM changed from STU to ST4 NA* N Y SSMCHG SSM changed from STU to DUS NA* N Y SSMCHG SSM changed from No SSM to STU NA* N Y SSMCHG SSM changed from TNC to PRS NA* N Y SSMCHG SSM changed from TNC to ST2 NA* N Y SSMCHG SSM changed from TNC to STU NA* N Y SSMCHG SSM changed from TNC to ST3E NA* N Y SSMCHG SSM changed from TNC to ST3 NA* N Y SSMCHG SSM changed from TNC to SMC NA* N Y SSMCHG SSM changed from TNC to ST4 NA* N Y SSMCHG SSM changed from TNC to DUS NA* N Y SSMCHG SSM changed from No SSM to TNC NA* N Y SSMCHG SSM changed from SMC to PRS NA* N Y SSMCHG SSM changed from SMC to ST2 NA* N Y SSMCHG SSM changed from SMC to STU NA* N Y SSMCHG SSM changed from SMC to ST3E NA* N Y SSMCHG SSM changed from SMC to ST3 NA* N Y SSMCHG SSM changed from SMC to TNC NA* N Y SSMCHG SSM changed from SMC to ST4 NA* N Y SSMCHG SSM changed from SMC to DUS NA* N Y SSMCHG SSM changed from No SSM to SMC NA* N Y SSMCHG SSM changed from ST4 to PRS NA* N Y SSMCHG SSM changed from ST4 to ST2 NA* N Y SSMCHG SSM changed from ST4 to STU NA* N Y SSMCHG SSM changed from ST4 to ST3E NA* N Y SSMCHG SSM changed from ST4 to ST3 NA* N Y SSMCHG SSM changed from ST4 to SMC NA* N Y SSMCHG SSM changed from ST4 to TNC NA* N Y SSMCHG SSM changed from ST4 to DUS NA* N Y SSMCHG SSM changed from No SSM to ST4 NA* N Y SSMCHG SSM changed from DUS to PRS NA* N Y SSMCHG SSM changed from DUS to ST2 NA* N Y SSMCHG SSM changed from DUS to STU NA* N Y SSMCHG SSM changed from DUS to ST3E NA* N Y SSMCHG SSM changed from DUS to ST3 NA* N Y SSMCHG SSM changed from DUS to SMC NA* N Y SSMCHG SSM changed from DUS to ST4 NA* N Y SSMCHG SSM changed from DUS to TNC NA* N Y SSMCHG SSM changed from No SSM to DUS NA* N Y SSMCHG SSM changed from PRS to No SSM NA* N Y SSMCHG SSM changed from STU to No SSM NA* N Y SSMCHG SSM changed from ST2 to No SSM NA* N Y SSMCHG SSM changed from TNC to No SSM NA* N Y

SSMCHG SSM changed from ST3E to No SSM NA* N Y

SSMCHG SSM changed from ST3 to No SSM NA* N Y SSMCHG SSM changed from SMC to No SSM NA* N Y SSMCHG SSM changed from ST4 to No SSM NA* N Y

GILLAM-FEi


160

SSMCHG SSM changed from G811 to No SSM NA* N Y

SSMCHG SSM changed from G812T to No SSM NA* N Y

SSMCHG SSM changed from G812L to No SSM NA* N Y

SSMCHG SSM changed from G813 to No SSM NA* N Y

SSMCHG SSM changed from DNU to No SSM NA* N Y SSMCHG SSM changed from DUS to No SSM NA* N Y SSMCHG SSM changed from INVALID to PRS NA* N Y SSMCHG SSM changed from INVALID to STU NA* N Y SSMCHG SSM changed from INVALID to TNC NA* N Y SSMCHG SSM changed from INVALID to ST2 NA* N Y

SSMCHG SSM changed from INVALID to ST3E NA* N Y

SSMCHG SSM changed from INVALID to ST3 NA* N Y

SSMCHG SSM changed from INVALID to SMC NA* N Y

SSMCHG SSM changed from INVALID to ST4 NA* N Y SSMCHG SSM changed from INVALID to DUS NA* N Y

SSMCHG SSM changed from INVALID to No SSM NA* N Y

SSMCHG SSM changed from INVALID to G811 NA* N Y

SSMCHG SSM changed from INVALID to G812T NA* N Y

SSMCHG SSM changed from INVALID to G812L NA* N Y

SSMCHG SSM changed from INVALID to G813 NA* N Y

SSMCHG SSM changed from INVALID to DNU NA* N Y SSMCHG SSM changed from G811 to STU NA* N Y SSMCHG SSM changed from G811 to G812T NA* N Y SSMCHG SSM changed from G811 to G812L NA* N Y SSMCHG SSM changed from G811 to G813 NA* N Y SSMCHG SSM changed from G811 to DNU NA* N Y SSMCHG SSM changed from G812T to G811 NA* N Y SSMCHG SSM changed from G812T to STU NA* N Y SSMCHG SSM changed from G812T to G812L NA* N Y SSMCHG SSM changed from G812T to G813 NA* N Y SSMCHG SSM changed from G812T to DNU NA* N Y SSMCHG SSM changed from G812L to G811 NA* N Y SSMCHG SSM changed from G812L to STU NA* N Y SSMCHG SSM changed from G812L to G812T NA* N Y SSMCHG SSM changed from G812L to G813 NA* N Y SSMCHG SSM changed from G812L to DNU NA* N Y SSMCHG SSM changed from G813 to G811 NA* N Y SSMCHG SSM changed from G813 to G812T NA* N Y SSMCHG SSM changed from G813 to G812L NA* N Y SSMCHG SSM changed from G813 to STU NA* N Y SSMCHG SSM changed from G813 to DNU NA* N Y SSMCHG SSM changed from DNU to G811 NA* N Y

GILLAM-FEi


161

SSMCHG SSM changed from DNU to STU NA* N Y SSMCHG SSM changed from DNU to G812T NA* N Y SSMCHG SSM changed from DNU to G812L NA* N Y SSMCHG SSM changed from DNU to G813 NA* N Y SSMCHG SSM changed from PRS to INVALID NA* N Y SSMCHG SSM changed from ST2 to INVALID NA* N Y

SSMCHG SSM changed from ST3E to INVALID NA* N Y

SSMCHG SSM changed from ST3 to INVALID NA* N Y SSMCHG SSM changed from STU to INVALID NA* N Y SSMCHG SSM changed from TNC to INVALID NA* N Y

SSMCHG SSM changed from SMC to INVALID NA* N Y

SSMCHG SSM changed from ST4 to INVALID NA* N Y SSMCHG SSM changed from DUS to INVALID NA* N Y

SSMCHG SSM changed from No SSM to INVALID NA* N Y

SSMCHG SSM changed from G811 to INVALID NA* N Y

SSMCHG SSM changed from G812T to INVALID NA* N Y

SSMCHG SSM changed from G812L to INVALID NA* N Y

SSMCHG SSM changed from G813 to INVALID NA* N Y

SSMCHG SSM changed from DNU to INVALID NA* N Y SSMCHG SSM changed from RES to PRS NA* N Y SSMCHG SSM changed from RES to STU NA* N Y SSMCHG SSM changed from RES to TNC NA* N Y

SSMCHG SSM changed from RES to ST2 NA* N Y SSMCHG SSM changed from RES to ST3E NA* N Y SSMCHG SSM changed from RES to ST3 NA* N Y SSMCHG SSM changed from RES to SMC NA* N Y SSMCHG SSM changed from RES to ST4 NA* N Y SSMCHG SSM changed from RES to DUS NA* N Y SSMCHG SSM changed from RES to No SSM NA* N Y SSMCHG SSM changed from RES to INVALID NA* N Y SSMCHG SSM changed from ST1 to RES NA* N Y SSMCHG SSM changed from ST2 to RES NA* N Y SSMCHG SSM changed from ST3E to RES NA* N Y SSMCHG SSM changed from ST3 to RES NA* N Y SSMCHG SSM changed from STU to RES NA* N Y SSMCHG SSM changed from TNC to RES NA* N Y SSMCHG SSM changed from SMC to RES NA* N Y SSMCHG SSM changed from ST4 to RES NA* N Y SSMCHG SSM changed from DUS to RES NA* N Y SSMCHG SSM changed from No SSM to RES NA* N Y SSMCHG SSM changed from INVALID to RES NA* N Y INPVAL Input signal validation NA N Y LEDCHG Change of LED state NA* N N CFGERR TYPE incompat. with input module MJ Y Y

GILLAM-FEi


162

5.9.6. <condtype> affecting oscillator


HWERR Hardware failure MJ Y Y OSCINS Oscillator instability MN Y Y OSCEOR Oscillator at end of range MN Y Y OSCNEOR Oscillator at near end of range MN N Y CTLVLTG No frequency adjustment MN Y Y WMUPST Warm up oscillator state MN N Y ACQST Acquire oscillator state NA N Y FRNGAL1 Free running oscillator state MN Y Y FRNGAL2 Free-Run for excessive time MJ Y Y HLDOVRAL1 Holdover oscillator state MN Y Y HLDOVRAL2 Holdover for excessive time MJ Y Y LOCKEDST Locked oscillator state NA N Y CMDST Command oscillator state NA N Y CALIBST Calibration oscillator state NA N Y SIS Set In Service NR* N Y SOOS Set Out Of Service NR* N Y LEDCHG Change of LED state NA* N N

GILLAM-FEi


163

5.9.7. <condtype> affecting FBM input ports


SIS Set In Service NR* N Y SOOS Set Out Of Service NR* N Y OEENT Object Entity creation NR* N Y OEDLT Object Entity deletion NR* N Y MEA TYPE incompat. with output module MJ Y Y UEQ Unequipped with necessary card MJ Y Y GT10M8 Freq. error greater than 10exp-8 MJ Y Y GT10M9 Freq. error greater than 10exp-9 MJ Y Y GT10M10 Freq. error greater than 10exp-10 MN Y Y GT10M11 Freq. error greater than 10exp-11 MN Y Y CFGERR Configuration error MN Y Y LOS Loss of signal MN Y Y

GILLAM-FEi


164

5.10. <ctag> - Correlation Tag

<ctag> is the Correlation Tag (CTAG) used to correlate input and response messages.

• The value of <ctag> is an identifier or a decimal numeral, and is limited to a maximum of 6 ASCII characters.

• It is assigned by the OS and must be included in UNISYNC input and response messages where specified.

GILLAM-FEi


165

5.11. <errcde> - Error Codes

Valid Values for Error Codes <errcde> Description IBEX Input, Block Extra IBMS Input, Block MiSsing ICNV Entity can not be deleted ICNV Object entity can not be set Out Of Service ICNV Entity can not be created ICNV Entity can not be modified ICNV Input, Command Not Valid IDNV Data not valid IDNV Input, Data Not Valid IDRG Input, Data RanGe IEAE Entity to be created already exists IENE Object entity does not exist IIAC Invalid Access identifier IIAC Only one AID allowed IIAC Invalid AID (not a REF input) IIAC Invalid AID (a REF input) IIAC Input, Invalid Access identifier IICM Command not yet supported IICM Command not supported IICM Command not valid IICT Input, Invalid Correlation Tag IIFM Input, Invalid data ForMat IIPG Input, Invalid Parameter Grouping IISP Input, Invalid Syntax or Punctuation IITA Input, Invalid Target identifier IITA Invalid Target Identifier INUP Input, Non-null Unimplemented Parameter IPEX Input, Parameter Extra IPMS Parameter missing IPMS Input, Parameter MiSsing IPNC Too many parameters IPNV Parameter not valid IPNV INPSEL only valid in FRCD or MAN mode IPNV Parameters not allowed IPNV Cannot control OSC command IPNV Cannot control OSC calibration IPNV Cannot program OSC state IPNV Invalid STATE parameter IPNV FREQCMD when not in CMD state

GILLAM-FEi


166

IPNV Cannot modify TYPE parameter IPNV Invalid REF parameter IPNV Cannot modify REF parameter IPNV Only one parameter allowed IPNV Parameter value too long IPNV Invalid date IPNV Invalid <montype> parameter IPNV Invalid CONDTYPE IPNV CONDTYPE not modifiable for this OE IPNV CAUTION: Possible Service Affecting Condition IPNV Invalid REF input selected IPNV Not in AUTO SSM Mode IPNV RSTSSM can only be applied on a REF input IPNV Possible Service Affecting Condition. Please confirm IPNV Confirmation Time Expired, Re-start IPNV Reference Input In Alarm IPNV Revertive mode in use IPNV Reference Input Out Of Service IPNV Can not switch to a lower priority input IPNV Can not switch to a lower quality input IPNV Reference Input Not Validated IPNV Command Disallowed Time Interval Requirement 4 sec IPNV Site survey already in progress IPNV GPS Out Of Service (OOS-MA) IPNV No site survey active IPNV Bad LATITUDE parameter format IPNV Bad LONGITUDE parameter format IPNV Bad HEIGHT parameter format IPNV Input not provisioned IPNV TYPE incompatible with hardware IPNV No output module IPNV TYPE not supported IPNV Output module not supported IPNV Object entity not yet supported IPNV Cannot be set Out Of Service IPNV Cannot modify ALMDE parameter IPNV ALMDE incompatible with output type IPNV ALMDE incompatible with configured outputs IPNV Specify INPFRCD with FRCD SYNMDE IPNV Still in AUTO synchronization mode IPNV Still in FRCD synchronization mode IPNV Bad TZ parameter format IPNV GPS Not ready ISNE Supporting Entity does not exist

GILLAM-FEi


167

PICC Privilege, Invalid Command Code PIUC Privilege, Illegal User Code PIUI Privilege, Illegal User Identity PLNA Privilege, Login Not Active SADL Object entity already deleted SAIN Status, Already Inhibited SAIS Object entity already In Service SAMS Status, Already in Maintenance State SAOS Object entity already Out Of Service SDAT Date programming problem SDAT GPS In Service SDNR Status, Data Not Ready SHCM Hardware Compatibility Mismatch, cannot be downloaded SNVS Status, Not in Valid State SRCI Requested command inhibited SROF OSC calibration refused SROF Requested Operation Failed SSIS Object entity still In Service, cannot be deleted SSRD Status, Switch Request Denied SWFA Status, Working unit Failed SAIS Status, Already In Service SAAL Status, Already ALlowed SCSN Status, Invalid command sequence SDBE Internal Error

GILLAM-FEi


168

5.12. <inhn> - Inhibition

<inhn> indicates if an alarm inhibition condition is in effect or not.

Value Value usage INH Inhibition of alarm requested NINH No inhibition of alarm requested

GILLAM-FEi


169

5.13. <logctl> - Logging Control

<logctl> specifies if the event occurrence must be saved in the LOG or not.

Value Value usage LOG Logging of the event requested NLOG No logging of the event requested

GILLAM-FEi


170

5.14. <lognm> - Log Name

<lognm> allows the user to manually specify the name of a log which can be used for specific message categories. Valid values for <lognm> :

• EVT : events log • EVTAO : : Autonomous Output messages log • SECU : : security log • DBCHG : : DBCHG messages log.

GILLAM-FEi


171

5.15. <mondat> - Monitor Date

Is the beginning date of the PM period specified in <tmper>. The format for <mondat> is MOY-DOM, where MOY (month of year) ranges from 1 to 12 and DOM (day of month) ranges from 1 to 31. A null value for <mondat> defaults to the current date.

GILLAM-FEi


172

5.16. <montm> - Monitor Time

<montm> is the beginning time of day of the PM period specified in <tmper>. The format for <montm> is HOD-MOH, where HOD (hour of day) ranges from 0 to 23 and MOH (minute of hour) ranges from 0 to 59. A null value for <montm> defaults to the current HOD-MOH.

GILLAM-FEi


173

5.17. <montype> - Monitored Parameter Types

<montype> <monval> Description

DFF A/N Feedback Monitoring <monval> contained in a text string of no more than 50 characters enclosed within a pair of escaped quotes (\"). This <monval> is automatically reported every 4 seconds in REPT^PM messages after a SCHED-PMREPT command has been started on a Feedback Monitoring input. Reports the following items:

- frequency offset of the feedback monitoring input (in scientific notation format)

- phase measurement time expressed in days and seconds

- phase offset expressed in nsec. Format used: "5.3e-011,1000 sec,40 nsec", "5.3e-012,1 day 100 sec,40 nsec", "5.3e-012,3 days 37100 sec,-85 nsec".

FFOFF3S Decimal-1 Fractional Frequency Offset expressed in 10exp-12 for a measurement period of 3 seconds






FFOFF3000S Decimal-1 Fractional Frequency Offset expressed

GILLAM-FEi


174

in 10exp-12 for a measurement period of 3000 seconds




FREQCORR Decimal-1 Oscillator Command expressed in ∆f/f (10exp-12)

LMRTIE1S Decimal-1 Latest Maximum Relative Time Interval Error expressed in nsec for an observation time of 1 second

LMRTIE1M Decimal-1 Latest Maximum Relative Time Interval Error expressed in nsec for an observation time of 1 minute

LMRTIE15M Decimal-1 Latest Maximum Relative Time Interval Error expressed in nsec for an observation time of 15 minutes

LMRTIE30M Decimal-1 Latest Maximum Relative Time Interval Error expressed in nsec for an observation time of 30 minutes

LMRTIE1H Decimal-1 Latest Maximum Relative Time Interval Error expressed in nsec for an observation time of 1 hour

LMRTIE2H Decimal-1 Latest Maximum Relative Time Interval Error expressed in nsec for an observation time of 2 hours



MRTIE1S Decimal-1 Maximum Relative Time Interval Error expressed in nsec for an observation time of 1 second

MRTIE1M Decimal-1 Maximum Relative Time Interval Error expressed in nsec for an observation time of 1 minute

MRTIE15M Decimal-1 Maximum Relative Time Interval Error expressed in nsec for an observation

GILLAM-FEi


175

time of 15 minutes MRTIE30M Decimal-1 Maximum Relative Time Interval Error

expressed in nsec for an observation time of 30 minutes

MRTIE1H Decimal-1 Maximum Relative Time Interval Error expressed in nsec for an observation time of 1 hour

MRTIE2H Decimal-1 Maximum Relative Time Interval Error expressed in nsec for an observation time of 2 hours



TDEV1S Decimal-1 Time Deviation expressed in nsec at an integration time of 1 second

TDEV3S Decimal-1 Time Deviation expressed in nsec at an integration time of 3 seconds








TIE1S Decimal-1 Time Interval Error expressed in nsec for a measurement period of 1 second

Decimal-1 is a decimal numeral restricted to integer values and not greater than 10 digits. The constructs that allow for <montype>x to identify the maximum and minimum values are x-C and x-F respectively. Not all constructs necessarily apply to every <montype>. <monval> is the measured value of the monitored parameter. If <monval> is out of range, the parameter value should be one of the following: OOR Out-Of-Range

GILLAM-FEi


176

OORH Out-Of-Range High OORL Out-Of-Range Low.

GILLAM-FEi


177

5.18. <ntfcncde> - Notification Code

<ntfcncde> is the notification code associated with alarm conditions. Valid values for <ntfcncde> are as follows:

<ntfcncde> VALUE DESCRIPTION CR Critical Alarm MJ Major Alarm MN Minor Alarm NA Not Alarmed NR Not Reported (when the event occurs,

information is retained in the NE) CL Cleared Alarm

Values CR, MJ and MN are reported via the REPT^ALM message. NA is reported via the REPT^EVT message.

GILLAM-FEi


178

5.19. <ocrdat> - Occurrence Date

<ocrdat> is the date when the specific event or violation occurred. The format for <ocrdat> is MOY-DOM. MOY stands for month of year and has a range of 1 to 12. DOM stands for day of month and has a range of 1 to 31.

GILLAM-FEi


179

5.20. <ocrtm> - Occurrence Time of Day

<ocrtm> is the time of day when the specific event or violation occurred. The format for <ocrtm> is HOD-MOH-SOM. HOD stands for hour of day and has a range of 0 to 23. MOH stands for minute of hour and has a range of 0 to 59. SOM stands for second of minute and has a range of 0 to 59.

GILLAM-FEi


180

5.21. <srveff> - Service Effecting

<srveff> is the effect on service caused by the standing or alarm condition. Parameter grouping shall not be used with this parameter.

Value Value usage SA Service-effecting condition, immediate action required NSA Nonservice-effecting condition, action required

GILLAM-FEi


181

5.22. <state> - Entity State

<state> indicates the state information of an entity. It is represented by the following parameters :

• Primary State (PST) : This parameter indicates the current overall service condition of an entity.

− IS (In-Service) The entity is available for providing its provisional functions. That is, the entity is operationally capable and at the same time administratively allowed to provide its provisioned functions.

− OOS (Out-Of-Service) The entity is not available for providing any of its provisioned functions.

• Primary State Qualifier (PSTQ) This parameter qualifies PST.

The following values of PSTQ qualify the PST value IS :

− NR (Normal)

The entity is capable and allowed to provide all of its provisioned functions.

− ANR (Abnormal) The entity is allowed to perform all of its provisioned functions, but it is capable of performing only part of (but not none) these functions.

The following values of PSTQ qualify the PST value OOS :

− AU (Autonomous) The entity is incapable of performing any of its provisioned functions, and there is no external administrative restriction inhibiting the entity from performing these functions.

− MA (Management) The entity is intentionally suspended by the external management command from performing all of its provisioned functions.

GILLAM-FEi


182

5.23. <tid> - Target Identifier

<tid> is the Target Identifier (TID) that identifies the target UNISYNC to which a command is directed.

• The value of <tid> is comprised of a maximum of 20 ASCII characters limited to letters, digits, and hyphens.

• The value of <tid> may be null when the OS directly interfaces with the target UNISYNC.

GILLAM-FEi


183

5.24. TOD – Time Of Day on serial interface

5.24.1. TOD Physical interface

• Connector type: RJ-45 • Connector label: TOD • Electrical interface: RS485 • Serial port: 9600 bits/sec, 8 bits of data, no parity, 1 stop bit • Pin out of the TOD connector:

Pin Signal Notes 1 TODPPS (+) One Pulse Per Second (+) output 2 TODPPS (-) One Pulse Per Second (-) output 3 TOD12V 12 V Runs through a 100mA fuse 4 TODRXD (-) TOD Receive (-) 5 TODRXD (+) TOD Receive (+) 6 TODGND TOD Ground 7 TODTXD (+) TOD Transmit (+) See below for time format 8 TODTXD (-) TOD Transmit (-) See below for time format

5.24.2. TOD Frame format

The date/time UNISYNCe TOD is always given in UTC time (never expressed in local time with DST correction). In order for the TOD frame to be sent by the UNISYNCe, the GPS receiver must be active and a correct time stamp must have been received from the GPS. Format of the TOD message: <cr><lf>i<sp>yy<sp>ddd<sp>hh:mm:ss.fff<sp>ld<lf> where <cr>: carriage return ASCII (0Dh) <lf>: line feed ASCII (0Ah) <sp>: space ASCII (20h) on-time = <cr> i = synchronization flag (<sp> = in synch, '?' = out synch) yy = year (08, 09, 10, …) ddd = day of year (001, 002, …) hh:mm:ss.fff = hours, minutes, seconds, milliseconds

GILLAM-FEi


184

l = leap second indicator (<sp> = normal, 'L' = leap sec) d = day light saving indicator (always 'S' to indicate standard UTC time). The alarm condition is indicated by '?' at i, which occurs during initial synchronization. The l is normally <sp>. It will be 'L' to indicate leap second adjustment, due at the end of the current month. Leap seconds are occasionally inserted in UTC. That generally occurs on midnight UTC June 30 or midnight UTC December 31. The start bit of the 'on-time' (<cr>) is synchronized to the indicated time. The 'on-time' mark character latency is lower than 100 µsec. Example: <cr><lf><sp><sp>08<sp>218 <sp>12:48:44.000<sp><sp>S<lf>

GILLAM-FEi


185

6. REFERENCES

• GR-474-CORE: Network Maintenance: Alarm and Control for Network Elements, Issue 1, December 1997

• GR-472-CORE: Network Element Configuration Management, Issue 2, November 1996 with revision 2, February 1999

• GR-199-CORE : Memory Administration Messages, Issue 3, February 1999

• GR-833-CORE: NE and Transport Surveillance Messages, Issue 4, June 2000

• GR-1093-CORE: Generic State Requirements for Network Elements (NEs), Issue 2, June 2000

• GR-831-CORE: Language for Operations Application Messages, Issue 1, November 1996

• GR-815-CORE: Generic Requirements for Network Element/Network System (NE/NS) Security, Issue 1, November 1997

• TR-NWT-835: Network Element and Network System Security Administration Messages, Issue 3, January 1993

• GR-378-CORE: Generic Requirements for Timing Signal Generators, Issue 2, February 1999

• GR-1244-CORE : Clocks for the Synchronized Network : Common Generic Criteria, Issue 2, December 2000

• GR-2830-CORE: Primary Reference Sources: Generic Criteria, Issue 2, December 1995

4396 unisynce tl1 reference guide rev 1_12

Documents

unisynce software version

update of document

new dst

support of new parameters

o support of new time

new alarms

o elevation

o mexicost o mexicost2