APESU - Configuration of AP Emergency Data

AMO APESU is used to configure the main data for AP Emergency concerning CC-AP specific IP data (in the following called -CC-AP data-, data for emergency groups (-EG data-) and feature specific data for AP shelves (-AP data-)). All those data can be added, changed, deleted, displayed and regenerated. Additional the status data of connections from the corresponding AP shelves to the HHS are displayed. The different actions have to consider the processor (HHS or CC-AP) where the AMO is currently running - configurations are only possible on HHS side. Display and regenerate is possible on all processors but on CC-AP the functionality is restricted to the actual CC-AP controlled data.

On CC-AP allowed is only to activate/deactivate AP Emergency manually.

AMO-APESU configures the AP Emergency data in following steps :

  1. Configuration of CC-AP data
    2. The configuration of an CC-AP depends on the available DIMSU memory AND on the amount of licensed CC-APs. Furthermore the given IP address for CC-AP must fit to the configured LAN segment of the given AP shelf number - dependend also on the connection type (network or direct connected AP shelf)
  2. Configuration of AP Emergency Group data
    3. The configuration of an AP Emergency Group depends on the available DIMSU memory. Furthermore the controlling CC-AP must exist.
  3. Configuration of AP assignment to Emergency groups
    4. The assignment of an AP to an AP Emergency Group can be done if the AP and the AP Emergency Group exist. Furthermore the connection type (network or direct connected AP shelf) of the AP must fit to the connection type of CC-AP.
  4. Get configuration into service
    5. After the AP Emergency configuration is finished, it can be brought into service (in HHS) via following commands:
    Via AMO-APESU AP Emergency can also be switched manually. Manual switching is done via a new command EXEC-APESU.

    The display branch of AMO-APESU can also run on CC-AP but only the data scope of the actual CC-AP is displayed.

Destination Processor: BP (Switching Unit)

Functions

ADD password class 2
CHANGE password class 2
EXECUTE password class 2
DELETE password class 2
DISPLAY password class 0
REGENERATE password class 0

Procedure Overview

ADD-APESU

ADD-APESU
DATA=CCAP,CCAPNO=<number>, IPADDR=<number>;
DATA=APEGRP,[EGRPNO=<number>], CCAPNO=<number>, [THRSHLD=<number>], [SBMODE=<string>], [NAME=<string>], [STABLE=<number>], [SBBEGIN=<number>], [SBEND=<number>], [SBOFFSET=<number>];
DATA=AP,APNO=<number>, EGRPNO=<number>, [WEIGHT=<number>], [SWMODE=<string>];

CHANGE-APESU

CHANGE-APESU
DATA=CCAP,CCAPNO=<number>, IPADDR=<number>;
DATA=APEGRP,EGRPNO=<number>, {(min 1) THRSHLD=<number>, SBMODE=<string>, NAME=<string>, STABLE=<number>, SBBEGIN=<number>, SBEND=<number>, SBOFFSET=<number>};
DATA=AP,APNO=<number>, {(min 1) EGRPNO=<number>, WEIGHT=<number>, SWMODE=<string>};

EXECUTE-APESU

EXECUTE-APESU SYSMODE=<string>, LEVEL=<string>, [NO=<number>];

DELETE-APESU

DELETE-APESU {(max 1) CCAPNO=<number>, EGRPNO=<number>, APNO=<number>}, [DELTYP=<param>];

The user may specify the data to be deleted by entering one of the three parameters CCAP, EGRPNO, APNO:

DISPLAY-APESU

DISPLAY-APESU {(max 1) CCAPNO=<number>, EGRPNO=<number>, APNO=<number>};

REGENERATE-APESU

REGENERATE-APESU {(max 1) CCAPNO=<number>, EGRPNO=<number>, APNO=<number>};

Parameter description

APNO The parameter refers to the number of AP shelf which should be assigned to the AP Emergency group.
Type of Input: single value, 3. parameter of a max-1-group (DELETE / DISPLAY / REGENERATE)
single value, mandatory (ADD,DATA=AP-AP Shel / CHANGE,DATA=AP-AP Shel)
Possible Values: numeric, 17-99
CCAPNO The parameter refers to the number of AP shelf where the CC-AP is located.
Type of Input: single value, 1. parameter of a max-1-group (DELETE / DISPLAY / REGENERATE)
single value, mandatory (ADD,DATA=APEGRP-AP Emergency Group / ADD,DATA=CCAP-cc-ap / CHANGE,DATA=CCAP-cc-ap)
Possible Values: numeric, 17-99
DATA Desired system option
Type of Input: single value, mandatory
Possible Values: AP Configuration of AP shelf specific data
APEGRP Configuration of AP Emergency group specific data
CCAP Configuration of CC-AP specific data
DELTYP Deletion type
Type of Input: single value, optional
Possible Values: CONFIRM Confirmed deletion TRUE
FORCED Forced Deletion FALSE
EGRPNO The parameter defines the number of AP Emergency group. This number can be freely choosen and should allow a well designed overview of APE configuration.
Type of Input: single value, 1. parameter of a min-1-group (CHANGE,DATA=AP-AP Shel)
single value, 2. parameter of a max-1-group (DELETE / DISPLAY / REGENERATE)
single value, mandatory (ADD,DATA=AP-AP Shel / CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: numeric, 1-99
IPADDR The parameter refers to the IP address of CC-AP in the same LAN segment as the used NCUIx board.
Type of Input: 4 single values, concatenated with ., mandatory
Possible Values: numeric, 0-255
LEVEL The parameter defines the desired unit for switching.
Type of Input: single value, mandatory
Possible Values: AP Switch AP shelf DB_APE_SW_LEVEL_AP
APEGRP Switch AP Emergency group DB_APE_SW_LEVEL_EM_GRP
CCAP Switch CC-AP DB_APE_SW_LEVEL_CC_AP
SYST Switch system DB_APE_SW_LEVEL_SYSTEM
NAME Name of AP Emergency group.
Type of Input: single value, 3. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: text, up to 22 characters
NO The parameter refers to the number of AP shelf, the AP Emergency group or CC-AP.
Type of Input: single value, optional
Possible Values: numeric, 1-99
SBBEGIN The automatic switchback to normal mode can be limited to the daily time period SBBEGIN:OFFSET bis SBEND:OFFSET. If SBBEGIN and SBEND are equal, the automatic switchback is possible any time.
Type of Input: single value, 5. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: numeric, 0-23
SBEND See SBBEGIN
Type of Input: single value, 6. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: numeric, 0-23
SBMODE This parameter defines if the AP Emergency group will be switched back to normal mode automatically or switchback can only be done manually.
Type of Input: single value, 2. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: AUTO Automatic Switchback DB_APE_GRP_SB_AUTO
MAN Manual Switchback DB_APE_GRP_SB_MANUAL
SBOFFSET See SBBEGIN.
Type of Input: single value, 7. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: numeric, 0-59
STABLE This parameter defines the time period for automatic switchback. The system must run stable for this period before it can be switched back to normal mode.
Type of Input: single value, 4. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: numeric, 0-255
SWMODE This parameter defines if the AP shelf can be switched over to AP Emergency only together with the entire Emergency group or if also an independendly switchover is possible.
Type of Input: single value, 3. parameter of a min-1-group (CHANGE,DATA=AP-AP Shel)
single value, optional (ADD,DATA=AP-AP Shel)
Possible Values: GROUP Group Switchover DB_APE_AP_SW_GROUP
SINGLE Single Switchover DB_APE_AP_SW_SINGLE
SYSMODE The parameter defines if the specified unit should be switched to emergency or normal mode.
Type of Input: single value, mandatory
Possible Values: EMERG Switch to emergency mode DB_APE_CU_CC_AP
NORMAL Switch to normal mode DB_APE_CU_HOST_CC
THRSHLD This parameter defines the threshold value for automatic switching of the whole AP Emergency group to AP Emergency mode. This value should not exceed the summary of all AP shelf weights of the group.
Type of Input: single value, 1. parameter of a min-1-group (CHANGE,DATA=APEGRP-AP Emergency Group)
single value, optional (ADD,DATA=APEGRP-AP Emergency Group)
Possible Values: numeric, 0-1000
WEIGHT This parameter defines the importance of the shelf concering calculating the criterias for automatic switching of the whole AP Emergency group to AP Emergency mode.
Type of Input: single value, 2. parameter of a min-1-group (CHANGE,DATA=AP-AP Shel)
single value, optional (ADD,DATA=AP-AP Shel)
Possible Values: numeric, 0-1000

Error Messages

F01
F01: This AMO action may be executed on the host system only.
F02
F02: The specified AP number is not configured.
F03
F03: The IP address is not valid because it is equal to one
     of the IP addresses of CC-A, CC-B, the default router or the NCUI itself.
F04
F04: The IP address is not within the valid range
     of net @@@.@@@.@@@.@@@ / netmask @@@.@@@.@@@.@@@
F05
F05: The IP address is not valid because it is equal either to the
     IP address of NCUI, TAP or the broadcast IP address.
F06
F06: Insufficient memory for configuring CC-AP data.
     Please increase memory by means of AMO-DIMSU, parameter CCAP.
F07
F07: The specified CC-AP number @@ has already been configured,
     only CHANGE-APESU possible.
F08
F08: Insufficient memory for configuring the AP Emergency group.
     Please increase memory by means of AMO-DIMSU, parameter APEGRP.
F09
F09: The specified AP Emergency group @@ has already been configured.
     Only CHANGE-APESU possible.
F10
F10: The specified AP Emergency group number is not configured.
F11
F11: No AP shelf with connection type APDL can be assigned to a CC-AP
     with connection type APNW.
     (See AMO-UCSU)
F12
F12: The specified CC-AP number is not configured.
F13
F13: This AMO action is not allowed to run as long as parts of the concerned
     AP shelves are not under control of host system.
F14
F14: As long as AP shelves with connection type APDL are assigned
     to the AP Emergency group, the group cannot be assigned to a CC-AP
     with connection type APNW.
F15
F15: This AMO action is not allowed to run as long as some of those
     AP Emergency groups, which are assigned to the actual CC-AP, are not
     under control of host system.
F16
F16: Emergency Group @@ is not deleted as long as parts of the concerned
     AP shelves are not under control of host system.
F17
F17: For LEVEL=@@@@@@ the parameter NO must be specified.
F18
F18: TIMER EXPIRED WHILE WAITING FOR THE ACKNOWLEDGEMENT MESSAGE FROM FA
     (@@@@@@ SEC).
F19
F19: The specified AP number is not assigned to an AP Emergency group.
F20
F20: This switch order is rejected because there is still an
     order in progress or the system is not ready yet
F21
F21: This AMO action is not allowed to run as long as some of those 
     AP shelves, which are assigned to the actual CC-AP, are not under
     control of host system.
F22
F22: THE TIME WINDOW FOR AUTOMATIC SWITCH BACK IS ZERO.
     THE VALUE FOR SBBEGIN AND SBEND ARE NOT ALLOWED TO BE EQUAL.
F23
F23: THE CC-AP CANNOT BE ADDED. THE CONTRACTED NUMBER OF @@@ IS 
     REACHED.PLEASE USE DISP-CODEW FOR DISPLAY OF THE CONTRACTED FEATURE
     PACKAGES.
     PLEASE CONTACT YOUR SERVICE CENTER IF YOU WISH TO USE ONE OF  
     THESE FEATURES.
F24
F24: THE SPECIFIED @@@@@@ NUMBER IS NOT IN THE ADMINISTRABLE RANGE 17-99.
F25
F25: COMMAND CANNOT BE PROCESSED BECAUSE THERE IS NO AP CONFIGURED 
     FOR THE SELECTED @@@@@@.
F26
F26:  COMMAND CANNOT BE PROCESSED BECAUSE SELECTED AP IS NOT CONFIGURED.
F27
F27: COMMAND CANNOT BE PROCESSED BECAUSE THERE IS NO AP CONFIGURED WITHIN THE 
     SYSTEM.
F28
F28: TO ADD A COUPLED SOFTGATE TO AN APE GROUP, YOU NEED TO DELETE
     THE REDUNDANCY PAIR RELATION FIRST, ADD BOTH SOFTGATES TO THE APE GROUP
     AND THEN CREATE THE REDUNDANCY PAIR RELATION AGAIN.
F29
F29: Parameters egrpno and swmode of a coupled SoftGate can not be changed
     unless the pair relation is deleted by means of AMO-BPOOL.
F30
F30: TO DELETE A COUPLED SOFTGATE FROM AN APE GROUP, YOU NEED TO DELETE
     THE REDUNDANCY PAIR RELATION FIRST, DELETE BOTH SOFTGATES FROM THE 
     APE GROUP AND THEN CREATE THE REDUNDANCY PAIR RELATION AGAIN.
F31
F31: IN XEGW ONLY BEARER CAN BE CONFIGURED AS APE.

Advisory Messages

H01
H01: The specified CC-AP number is not configured.
H02
H02: On CC-AP the display can only be performed for data related 
     to the actual CC-AP.
H03
H03: The specified AP number is not assigned to an AP Emergency group.
H04
H04: The specified AP Emergency group is not configured.
H05
H05: The desired display is not able to be performed because the AP
     Emergency group is assigned to another CC-AP.
H06
H06: The specified AP number is not configured.
H07
H07: The sum of weights of all AP shelves which are assigned to this
     AP Emergency group (@@@@@) is lower than the switch over threshold
     of the group (@@@@).
     Therefore automatic switch over is disabled.
H08
H08: This function does not need parameter NO - it will be ignored.
H09
H09: The switch order has been processed successfully.
H10
H10: The switch order has been processed partially.
H11
H11: The switch order could not be processed.
H12
H12: AP Emergency group @@ is assigned to CC-AP @@.
H13
H13: Changed APE data existing - all concerned NCUI boards have to be loaded
     by means of EXEC-USSU:UPDATAP,<ltu>;
H14
H14: The desired display is not able to be performed because the AP shelf
     is assigned to an other CC-AP.
H15
H15: THIS FUNCTION DELETES THE ENTIRE AP EMERGENCY CONFIGURATION !
     ARE YOU REALLY SURE TO PROCESS THIS ACTION ? {YES/NO}
H16
H16: LEVEL:@@@@@@, AP @@ CAN NOT BE SWITCHED OVER
     SINCE THERE EXISTS NO PASSIVE CONNECTION
H17
H17: THE SWITCH ORDER IS NOT NECESSARY TO BE PROCESSED BECAUSE THE
     SYSTEM IS ALREADY SWITCHED TO THE DESIRED OPERATION MODE.
H18
H18: THIS FUNCTION DELETES THE CCAP EMERGENCY CONFIGURATION !
     ARE YOU REALLY SURE TO PROCESS THIS ACTION ? {YES/NO}
H19
H19: THIS FUNCTION DELETES THE AP GROUP !
     ARE YOU REALLY SURE TO PROCESS THIS ACTION ? {YES/NO}
H20
H20: LEVEL:@@@@@@, AP @@ CAN NOT BE SWITCHED OVER
     THE CONNECTION TO HOST WAS DISCONNECTED WITH DELAP.
H21
H21: The switch order is still running and can take up to 90 seconds.
H22
H22: FOR THIS ACTION THE PARAMETER DELTYPE WILL BE IGNORED.
H23
H23: CONFIGURATION AFFECTS ALSO XEGW TRAILER AP @@.