158
REGEN - Regenerate Customer Data from Data Base
Restrictions
Functions of the AMO
Error Messages and Advisories
Interrelationships
Parameter Description
The AMO REGEN is used for creating a MML batch (MML = Man-Machine-Language) to allow the transfer or backup of a complete or partial system database in a ’portable’ form (e.g. version upgrades). Reentry of the database via MML batch is then performed at a later date with the aid of AMO GENDB.
A REGEN takes the form of a sorted file of REGEN MML commands read sequentially whereby the REGENERATE action of the various AMOs is started via the USER-TASK. A REGEN control file exists for each HW module with the appropriate REGEN MML commands and the name:
:PDS:APSU/RS@@@<x><y>
resp.
:PDS:APSU/RSMP<a><x><b>
resp.
:PDS:APSU/RS@@X<x><c>
with :
<a>: X (80CMX, 600ECX) from version V3.5 on
@ (80CM)
<b>: D (ADS)
<c>: S (SWU, 80CMX, 600ECX) from version V3.5 on
<x>: D (German)
E (English)
<y>: D (ADS)
S (SWU)
The response messages of the various started AMOs are stored in the result files. If PROT=Y was declared, then error and execution files are also created. The result files and error and execution files have the following name syntax:
PAS:<xxxxxx>/<yyyyyyyyyyy>/<zz>/<aaa>
•
<xxxxxx>: first 6 digits of the system number (read from VEGAS file)
•
<yyyyyyyyyyy>: remaining 11 digits of system number
•
<zz>: RE (REGEN result file), RA (REGEN execution file)
•
<aaa>: ADS, SWU, ALL (If all HW modules are regenerated, only the result files are combined), NOU (If parameter NOUN was specified).
REGEN control files are included on hard disk with each new release. However, the user has the option of using his/her own files for the REGEN run. Filenames of private production files can be declared with the parameter MMLFILE.
Caution: The specified file must be a SAM file with variable record length and may contain only one NOUN per line.
The contents could look like this:
An example for the regeneration with a private MML-File
Let’s create the private MML-File
TESTMMLDAT in the directory :PAS:APSI/TEMP/ of the hard disk with the following content:
BCSM
LCSM
CODEW
ANSU
UCSU
BCSU
Use this commands to create the REGEN:
STA-REGEN:USERCODE=NOBODY,MMLFILE=":PAS:APSI/TEMP/TESTMMLDAT",
SYSNO=NICHT-EINGETRAGEN,CONT=N,PROT=Y;
H500: AMO REGEN STARTED
H01: REGENERATION STARTED
H17: HW-MODULE SWU IS REGENERATING
H27: HW MODULE SWU REGENERATION SUCCESSFUL
H17: HW-MODULE ADS IS REGENERATING
H27: HW MODULE ADS REGENERATION SUCCESSFUL
H90: REGENERATION FINISHED
AMO-REGEN-92 REGENERATE CUSTOMER DATA FROM THE DATABASE
START COMPLETED;
The following REGEN result file is obtained:
STA-LIST:":PAS:APSI/TEMP/TESTMMLD/E",,,T;
H500: AMO LIST STARTED
DEV NAME : PAS
FILE NAME: :PAS:APSI/TEMP/TESTMMLD/E
TYPE : SAM
ADDRESS : H'00000000'
0000 :A001
0000 :
0000 :
0001 :C001 *P30252B4300B00201P30252B4300B00201P30252B4300S00101
0002 :M2 1 ADD-CODEW:BH6X7KZP25CS5BJRX99UGMJ3YC8SVWRJ32W5U6LRMTKNA2X95
0002 :5SB8R443YGA79V1,7ZRY61B1468S3PNF93BEMXDNFEADHEZK2XM9UBEYTA6XR2KJ
0002 :Z8FRDKB49R;
0003 :M2 1 ADD-ANSU:SYSNO,"NO SWITCH NUMBER ","ZDBCCDSF";
0004 :M2 1 ADD-ANSU:SYSNO,"NO SWITCH NUMBER ","ZDBCCDS1";
0005 :M2 1 ADD-ANSU:SYSNO,"NO SWITCH NUMBER ","ZDBCCDS2";
0006 :M2 1 ADD-UCSU:LTG,1,"Q2261-X ";
0007 :M2 1 ADD-UCSU:LTU,1,1,"Q2261-X ",CC80F,LOCAL,"
0007 : ",,,,,,;
0008 :M2 1 ADD-UCSU:LTU,1,2,"Q2166-X ",L80XF,LOCAL,"
0008 : ",,,,,,;
0009 :M2 1 ADD-UCSU:LTU,1,3,"Q2166-X ",L80XF,LOCAL,"
0009 : ",,,,,,;
000A :M2 1 ADD-UCSU:LTU,1,4,"Q2166-X ",L80XF,LOCAL,"
000A : ",,,,,,;
000B :M2 1 ADD-UCSU:AP,1,75,"Q2302-X ",5,LTUW,APDL,100.100.103.10,10
000B :0.100.103.60,"MOS ",
000B :445,444,30;
000C :M2 1 ADD-BCSU:PER,1,1,55,"Q2205-X ",1,0,,,,,,A;
000D :M2 1 ADD-BCSU:PER,1,1,61,"Q2164-X ",1,0,,NO,300,700,300,A;
000E :M2 1 ADD-BCSU:PER,1,1,67,"Q2168-X ",1,0,,NO,300,700,300,A;
000F :M2 1 ADD-BCSU:PER,1,1,73,"Q2153-X100",0,0,,,,,,A;
0010 :M2 1 ADD-BCSU:PER,1,1,79,"Q2150-X ",0,0,,,,,,A;
0011 :M2 1 ADD-BCSU:PER,1,1,85,"Q2480-X ",0,0,,,,,,A;
0012 :M2 1 ADD-BCSU:PER,1,1,91,"Q2246-X ",0,0,,,,,,A;
0013 :M2 1 ADD-BCSU:PER,1,1,97,"Q2025-X300",0,0,,,,,,A;
0014 :M2 1 ADD-BCSU:PER,1,1,103,"Q2121-X ",0,0,,,,,,A;
0015 :M2 1 ADD-BCSU:PER,1,2,25,"Q2205-X ",1,0,,,,,,A;
0016 :M2 1 ADD-BCSU:PER,1,2,31,"Q2117-X ",0,0,,,,,,A;
0017 :M2 1 ADD-BCSU:PER,1,2,43,"Q6401-X ",3,0,,,,,,A;
0018 :M2 1 ADD-BCSU:PER,1,2,55,"Q2214-X ",0,0,,,,,,A;
0019 :M2 1 ADD-BCSU:DIU,1,2,61,"Q2195-X ",0,,,,,1,,,,,A;
001A :M2 1 ADD-BCSU:DIU,1,2,79,"Q2096-X200",0,,,,,0,,,,,A;
001B :M2 1 ADD-BCSU:DIU,1,2,85,"Q2096-X200",0,,,,,0,,,,,A;
001C :M2 1 ADD-BCSU:DIU,1,2,91,"Q2096-X200",0,,,,,0,,,,,A;
001D :M2 1 ADD-BCSU:DIU,1,2,97,"Q2096-X200",0,,,,,0,,,,,A;
001E :M2 1 ADD-BCSU:DIU,1,2,115,"Q2096-X200",0,,,,,0,,,,,A;
001F :M2 1 ADD-BCSU:PER,1,2,121,"Q2174-X ",0,0,,,,,,A;
0020 :M2 1 ADD-BCSU:PER,1,3,25,"Q2246-X ",0,0,,,,,,A;
0021 :M2 1 ADD-BCSU:PER,1,3,37,"Q2150-X ",0,0,,,,,,A;
0022 :M2 1 ADD-BCSU:PER,1,3,85,"Q2153-X ",0,0,,,,,,A;
0023 :M2 1 ADD-BCSU:PER,1,3,115,"Q2168-X ",1,0,,NO,300,700,300,A;
0024 :M2 1 ADD-BCSU:PER,1,4,43,"Q2153-X ",0,0,,,,,,A;
0025 :M2 1 ADD-BCSU:PER,1,4,49,"Q2168-X ",1,0,,NO,300,700,300,A;
0026 :M2 1 ADD-BCSU:PER,1,4,91,"Q2246-X ",0,0,,,,,,A;
0027 :M2 1 ADD-BCSU:PER,1,4,121,"Q2150-X ",0,0,,,,,,A;
0028 :M2 1 ADD-BCSU:RG,1,75,19,"Q2258-X ",UN25H65V,0;
0029 :M2 1 ADD-BCSU:PER,1,75,25,"Q2157-X ",0,0,,,,,,A;
002A :M2 1 ADD-BCSU:PER,1,75,37,"Q2150-X ",0,0,,,,,,A;
002B :M2 1 ADD-BCSU:PER,1,75,49,"Q2150-X ",0,0,,,,,,A;
002C :M2 1 ADD-BCSU:PER,1,75,55,"Q2205-X ",1,0,,,,,,A;
002D :M2 1 ADD-BCSU:PER,1,75,61,"Q2144-X ",0,0,,NO,300,700,300,A;
002E :M2 1 ADD-BCSU:PER,1,75,67,"Q2121-X ",0,0,,,,,,A;
002F :M2 1 ADD-BCSU:PER,1,75,79,"Q2158-X ",1,0,,NO,300,700,300,A;
0030 :M2 1 ADD-BCSU:PER,1,75,85,"Q2158-X ",1,0,,NO,300,700,300,A;
0031 :M2 1 ADD-BCSU:PER,1,75,91,"Q2025-X300",0,0,,,,,,A;
0032 :M2 1 ADD-BCSU:PER,1,75,97,"Q2025-X300",0,0,,,,,,A;
0033 :M2 1 ADD-BCSU:DIU,1,75,103,"Q2096-X200",0,,,,,0,,,,,A;
0034 :M2 1 ADD-BCSU:PER,1,75,109,"Q2157-X ",0,0,,,,,,A;
0035 :M2 1 ADD-BCSU:PER,1,75,115,"Q2214-X ",0,0,,,,,,A;
CONTINUE ?
ANS =
C
0036 :M2 1 ADD-BCSU:PER,1,75,121,"Q2214-X ",0,0,,,,,,A;
0037 :B001 *P30252B4300A00201P30252B4300A00201P30252B4300D00101
0038 :M1 1 ADD-BCSM:A1,BC,STYPE,"B5301-X ",WITHOUT;
0039 :M1 1 ADD-BCSM:A1,EC,STYPE,"B5318-X ";
003A :M1 1 ADD-LCSM:A1,ASYNC,2,4800,7,SL1,INT,INT;
LIST FINISHED
STATUS = H'0000
AMO-LIST -92 LISTING OF FILES
START COMPLETED;
If any other type of file is used, then a successful completion of the REGEN run cannot be guaranteed.
If a private control file is used, the entire system is checked to see if all modules are available. The advisory H13 is displayed for each not available module. The REGEN-run is started for available modules. If the control file does not contain a noun for an available module only the advisories H17 and H27 are displayed.
If a filename was declared with the parameter MMLFILE, then only a result file is created. This file will have the same name as the MMLFILE except that the last two characters of the filename are replaced with "/E". The filename for the execution file (if PROT=Y was declared) is also taken from the MMLFILE name. However, in this case the last two characters are replaced by "/A".
If the last-but-third character of the MMLFILE name is "/", the AMO REGEN is terminated abnormally. If an MMLFILE name is specified beginning with :AMD:, then the AMO REGEN assumes that a REGEN job has been started by remote administration and maintenance (RMA). In this case, a result file is created for each NOUN in the MMLFILE with the following name syntax:
:AMD:FBT/FAMUP/NOUNN/<x>/<yyyyy>
<x> : A (ADS) / S (SWU)
<yyyyy>: Regenerated NOUN
When a REGEN run is started, the AMO attempts to enter the appropriate status information on each HW module in the VEGAS administration file.
If the AMO is unable to enter the necessary information (reservation codes) in the VEGAS file (e.g. if an entry already exists for another system) then the regenerating run is refused for the entire system.
For REGENERATION with DATYPE=ALL the SWU must be marked "FREE" in the VEGAS-file, because several SWU-Amos will be started.
If a value other than NONE is specified for the DATYPE parameter, then the SWU database must contain the same system number as the ADS. The status of the SWU must be ’FREE’.
Parameter DATYPE at present not evaluated.
${DocTitle}
, ID:
${DocID}
©
02/2025
Mitel Networks Corporation. - All rights reserved.
Mitel and the Mitel logo are trademarks of Mitel Networks Corporation. Unify and associated marks are trademarks of Unify Software and Solutions GmbH&Co. KG.
All other trademarks herein are the property of their respective owners.