28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #1
DOCUMENT SKELETONUPROGRAM;
! DI 1/1013-FCK 114 22 Uen !
!
*PAGE;
CONTENTS: PAGE
1 G E N E R A L 3
2 D E C L A R E 4
2.1 GLOBAL SYMBOLS 4
2.2 LOCAL SYMBOLS 5
2.3 RECORDS AND FILESIZES 6
2.4 COMMON STORED VARIABLES 7
2.5 TEMPORARY VARIABLES 8
2.6 STRUCTURES 9
2.7 STATES AND SYMBOLS 10
3 P R O G R A M 11
3.1 MULTI-FUNCTION SIGNAL ENTRIES 11
3.2 STANDARD SUBPROGRAMS IN PLEX 12
3.2.1 START/RESTART 12
3.2.2 SIZE ALTERATION 12
3.2.3 DATA BACK UP 12
3.2.4 CM MAINTENANCE 12
3.2.5 TIME SUPERVISION MODULE 12
3.3 APPLICATION SUBPROGRAMS IN PLEX 13
3.3.1 I/O INTERFACE 13
3.3.1.1 COMMAND XXXXI 13
3.3.1.2 COMMAND XXXXE 14
3.3.1.3 COMMAND XXXXP 15
3.3.1.4 COMMAND TERMINATION 16
3.3.1.5 ALARM PRINTOUTS 16
3.3.2 TRAFFIC HANDLING 17
3.3.2.1 STATE STATE-A 17
3.3.2.2 STATE STATE-B 17
3.3.2.3 STATE STATE-X 17
3.3.3 EM/RP INTERFACES 18
3.3.4 OPERATION AND MAINTENANCE 18
3.3.4.1 ADMINISTRATION 18
3.3.4.2 SUPERVISION 18
3.3.4.3 STATISTICS 18
3.4 APPLICATION SUBPROGRAMS IN ASA 19
3.6.1 SUBPROGRAM1 19
3.5 SUBROUTINES IN PLEX 20
3.5.1 SUBROUTINE1 20
3.6 SUBROUTINES IN ASA 21
3.6.1 ASASUB1 21
4 D A T A 22
4.1 SIZES 22
4.2 INITIAL DATA 22
4.3 ALLOCATIONS 23
5 L O C A L S I G N A L S 24
5.1 LOCALSIGNALNAME 24
!
*PAGE;
!
1 G E N E R A L
===============
THE MAIN FUNCTION IN CP-PROGRAM XXXXU ARE ...
USED ABBREVIATIONS:
ADDR ADDRESS
CALC CALCULATE
. .
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #2
. .
. .
!
*PAGE;
!
2 D E C L A R E
===============
!
DECLARE;
!
2.1 GLOBAL SYMBOLS
------------------
!
GLOBAL NSYMB BLOCAT (3); ! BLOCK CATEGORY !
GLOBAL NSYMB BTXXXX (#FFFF); ! BLOCK TYPE ON APT LEVEL !
GLOBAL NSYMB BTEXTXXXX (#FFFF); ! BLOCK TYPE ON APZ LEVEL !
GLOBAL NSYMB COCAXXXX (#FFFF); ! COMMAND CATEGORY NUMBER / CCCCC !
GLOBAL NSYMB PRCAXXX (#FF); ! PRINTOUT CATEGORY NUMBER / ............. !
GLOBAL NSYMB FLINFO (#FFFF); ! FORLOPP INFORMATION !
GLOBAL STRING GXXXXX1 (1); ! . !
GLOBAL STRING GXXXXX2 (3); ! . !
*PAGE;
!
2.2 LOCAL SYMBOLS
-----------------
!
NSYMB SPH1XXXX = 77; ! START PHASE !
NSYMB ZXXXX = 1; ! . !
*PAGE;
!
2.3 RECORDS AND FILESIZES
-------------------------
!
RECORD RECORD1;
SYMBOL VARIABLE RSTATE = (IDLE,
BUSY,
BLOC) DS; ! . !
VARIABLE RXXXXSTR 16 DS; ! . !
VARIABLE RDUMMY 16 DS CLEAR ; ! DUMMY VARIABLE !
VARIABLE FLCONNFID 32 DS;
END RECORD;
POINTER RECORD1PTR(RECORD1);
*PAGE;
!
2.4 COMMON STORED VARIABLES
---------------------------
!
SYMBOL VARIABLE CSTATE = (IDLE,
BUSY,
BLOC) DS; ! . !
STRING VARIABLE CXXXXSTR 7 DS; ! . !
VARIABLE CXXXX1 16 DS; ! . !
VARIABLE CDUMMY 16 DS; ! DUMMY VARIABLE !
*PAGE;
!
2.5 TEMPORARY VARIABLES
-----------------------
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #3
!
VARIABLE TPHASE; ! START PHASE !
VARIABLE TSIGNALKEY; ! SIGNAL KEY !
*PAGE;
!
2.6 STRUCTURES
--------------
!
STRUCTURE CXXXX1 = ! . !
1 CXX 4, ! B0 - 3 : .... !
1 CXY 4, ! B4 - 7 : .... !
1 CXZ 8, ! B8 - 15 : .... !
2 CXX1 4, ! B8 - 11 : .... !
2 CXX2 2, ! B12 - 13 : .... !
2 + 2; ! B14 - 15 : SPARE !
*PAGE;
!
2.7 STATES AND SYMBOLS
----------------------
SYMBOL VARIABLE CSTATE
----------------------
BLOC BLOCKED FOR . . .
BUSY BUSY . . .
IDLE IDLE . . .
SYMBOL VARIABLE RSTATE
----------------------
BLOC BLOCKED FOR . . .
BUSY BUSY . . .
IDLE IDLE . . .
!
END DECLARE;
*PAGE;
!
3 P R O G R A M
===============
!
PROGRAM;
PLEX;
!
3.1 MULTI-FUNCTION SIGNAL ENTRIES
---------------------------------
UNDER THIS HEADING ARE THE ENTRIES FOR THOSE SIGNALS WHICH REQUIRE A BRANCHING, BEFORE
APPROPRIATE ACTIONS CAN BE PERFORMED. DIRECTLY AFTER THE RECEPTION STATEMENT, A JUMP OCCURS
TO THE CONCERNED SUBPROGRAM DEPENDING ON THE STATE.
!
!
>>>>>>>>>>>>>>>>>>>
SIGNAL1 >
>>>>>>>>>>>>>>>>>>>
!
ENTER SIGNAL1 WITH
TXX, ! SIGNAL DATA 1 DESCRIPTION !
TYY, ! SIGNAL DATA 2 DESCRIPTION !
TZZ; ! SIGNAL DATA 3 DESCRIPTION !
CASE CSTATE IS
WHEN IDLE DO
;
WHEN BUSY DO
;
OTHERWISE DO
FLERROR FLCONNFID;
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #4
GOTO UNEXPECTEDEXIT;
ESAC;
*PAGE;
!
3.2 STANDARD SUBPROGRAMS IN PLEX
--------------------------------
3.2.1 START/RESTART
-------------------
!
!
3.2.2 SIZE ALTERATION
---------------------
!
!
3.2.3 DATA BACK UP
------------------
!
!
3.2.4 CM MAINTENANCE
--------------------
!
!
3.2.5 TIME SUPERVISION MODULE
-----------------------------
!
*PAGE;
!
3.3 APPLICATION SUBPROGRAMS IN PLEX
-----------------------------------
3.3.1 I/O INTERFACE
-------------------
3.3.1.1 COMMAND XXXXI
---------------------
!
!
COMMAND RECEPTION
-----------------
!
!
COMMAND ANALYSIS
----------------
!
!
COMMAND OPERATIONS
------------------
!
*PAGE;
!
3.3.1.2 COMMAND XXXXE
---------------------
!
!
COMMAND RECEPTION
-----------------
!
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #5
!
COMMAND ANALYSIS
----------------
!
!
COMMAND OPERATIONS
------------------
!
*PAGE;
!
3.3.1.3 COMMAND XXXXP
---------------------
!
!
COMMAND RECEPTION
-----------------
!
!
COMMAND ANALYSIS
----------------
!
!
COMMAND OPERATIONS
------------------
!
*PAGE;
!
3.3.1.4 COMMAND TERMINATION
---------------------------
!
FORMATERR)
ILLEGALVAL)
FAULTCODE)
END)
EXECUTED)
PRINT)
RELEASE)
!
3.3.1.5 ALARM PRINTOUTS
-----------------------
!
*PAGE;
!
3.3.2 TRAFFIC HANDLING
----------------------
!
!
3.3.2.1 STATE STATE-A
!
LABEL0010)
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #6
!
3.3.2.2 STATE STATE-B
!
!
3.3.2.3 STATE STATE-X
!
*PAGE;
!
3.3.3 EM/RP INTERFACES
----------------------
!
!
3.3.4 OPERATION AND MAINTENANCE
--------------------------------
!
!
3.3.4.1 ADMINISTRATION
-----------------------
!
!
3.3.4.2 SUPERVISION
--------------------
!
!
3.3.4.3 STATISTICS
------------------
!
*PAGE;
!
3.4 APPLICATION SUBPROGRAMS IN ASA
----------------------
!
PROGRAM ASSPROGRAM;
ASA210C;
!
3.6.1 SUBPROGRAM1
-----------------
THIS SUBPROGRAM...
!
!
>>>>>>>>>>>>>>>>>>>
SIGNAL >
>>>>>>>>>>>>>>>>>>>
!
RECEIVE SIGNAL; ! PR0=... !
! DR0=... !
END PROGRAM;
*PAGE;
!
3.5 SUBROUTINES IN PLEX
-----------------------
3.5.1 SUBROUTINE1
-----------------
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #7
SUBROUTINE DESCRIPTION :
INPUT DATA : . . .
OUTPUT DATA : . . .
LOCAL DATA : . . .
USERS POINTER : . . .
!
BEGIN SUBROUTINE1;
END SUBROUTINE1;
END PROGRAM;
*PAGE;
!
3.6 SUBROUTINES IN ASA
----------------------
3.6.1 ASASUB1
------------
SUBROUTINE DESCRIPTION :
INPUT DATA :
OUTPUT DATA :
LOCAL DATA :
USERS POINTER :
VALUES OF TEMPORARY VARIABLES ARE UNAFFECTED
!
PROGRAM ASASUB1;
ASA210C;
END PROGRAM;
*PAGE;
!
4 D A T A
=========
!
DATA;
!
4.1 SIZES
---------
!
SIZE OF RECORD1 = 16;
!
4.2 INITIAL DATA
----------------
!
CXXXX1 = 0;
SET RXXXXSTR = GSTRINGA FOR XXXPTR = ZXXXX;
*PAGE;
!
4.3 ALLOCATIONS
28/02/2005 http://garbowww.ericsson.se:80/tomax/mdocs/101-01013-022_B/mdoc.html #8
---------------
!
ALLOCATE CXXXXSTR AT BASE ADDRESS #01;
END DATA;
*PAGE;
!
5 L O C A L S I G N A L S
==========================
5.1 LOCALSIGNALNAME
-------------------
!
SIGNAL LOCALSIGNALNAME;
! FUNCTION: ... !
TYPE 1 CP-CP,LOCAL; ! SINGLE SIGNAL !
! COMMUNICATION: SENDER: SUBPROGRAM1
RECEIVER: SUBPROGRAM2 !
LEVEL NO BUFFER;
DATA D1 16; ! ... POINTER !
END SIGNAL;
*END;
ID SKELETONUPROGRAM TYPE DOCUMENT;
CLA 101/1013; ! REPLACE WITH 190 55 FOR A REAL SPI !
NUM FCK 114 22 Uen; ! REPLACE WITH PRODUCT NUMBER FOR UNIT !
REV B;
DAT 1997-06-18;
DES UABSAAR
RES UAB/K/SD;
APP UAB/K/SDC;
END ID;