149.2.4 ACTIVATE-PATCH

Activation of single patches (TYPE=PATCH)
The specified patches are activated. If no patch numbers are specified, all patches found in :PDS:PATCHINPUT/ will be added and activated.
The parameter DEST specifies where the patch is activated:
•
in the main memory only (DEST = RAM)
•
in the main memory and on HD for resident subsystems (DEST = HD&RAM)
•
on HD for resident subsystems only (DEST = HD).
If the parameter DEST is not specified, patch broadcasting is automatic. If a patch is only to be (de)activated in a specific system unit (processor), DEST must be specified.
The parameter TEST enables a "hard" activation without consistency check.
Activation on HD is carried out secured by means of a patch sequence (similar to ROLL_OUT) using PBO calls. Patching is always in the non-current version of the subsystem. Following this, the current and non-current versions are exchanged by means of changing the TAB. When the patch sequence is closed, the TAB is written back and the patch is thus active. For subsystems without reserve versions (ABS_ONLY), a "RES version" is automatically set up. When the patch sequence is closed, in this case the subsystem version which is no longer current is deleted. As a result, the TAB also has the status RES_ONLY. If an error occurs during patch activation, the patch sequence is automatically deleted (TAB is not switched over). The consistency of the PGLIB is also retained in the event of an error in patch activation.
The parameter GRPID only takes effect when adding a patch.
Activation of all patches of a group (TYPE=GRP)
All patches with the specified group identifier are activated. The patches must be added with that group identifier previously. It’s possible to activate patches by 16 different group IDs.
Note
The activation status of a patch is not significant. The activation is performed once more, if the patch is still active.
Activate patches with MegaPatch
The patches can be activated as single or all together (MegaPatch). The manner of activation depends on the activation sign ACTSG. The default value is MEGA. Activation by MegaPatch will be used for many patches. The activation will be much faster, if their are only patches from one subsystem (or only some few subsystems). All the patches recording to the same subsystem will be picked up and activated all at once by using the MegaPatch option (subsystem is copied only once). After activating all patches of one subsystem the patches of the next subsystem will be activated. Therefore the process is much faster for activating many patches.
The single-patch-process activates one patch after the other.
Activation of optional Patches
•
Optional Patches are located in the directory ":PDS:OPT/". It isn’t possible to use the command "ADD-PATCH" for optional Patches.
•
The activation flag in the DB is set during the activation of optional patches. (Formerly done by AMO PSA resp. AMO PSS)
•
Optional Patches are always activated on Harddisc and on all available target processors.
•
The group ID’s can’t be chosen for free. The group ID is generated from the value of the field ACTIVATION in the patch header. (e.g.: group ID D0017 for the value 17 in the header field ACTIVATION of a ADP patch.)
•
The parameter TEST isn’t possible for optional patches. They are always activated secure and with all checks.
Procedure Overview


Example:
Command Code
Parameter
ACTIVATE-PATCH
TYPE=PATCH,[PATNO=<string>],[DEST=<param>]
,[TEST=<param>],[GRPID=<string>],[ACTSG=<param>];
 
|TYPE=GRP,GRPID=<string>,[DEST=<param>]
,[TEST=<param>],[ACTSG=<param>];
 
|TYPE=OPT,APSSIGN=<param>,ACTFLAG=<number>;
Input:
ACTIVATE-PATCH:PATCH,,,,TS15KV07;
Note
All patches found in :PDS:PATCHINPUT/ will be added to the catalog. The catalog entry will be supplied with the group name "TS15KV07". Patch broadcasting applies to this example (HD and all target processors valid for subsystem).
Input:
ACTIVATE-PATCH:PATCH,DERPATCH,A1,N;
The patch will be activated in processor A1 without consistency-check.
Input:
ACTIVATE-PATCH:PATCH,PS30001,HD&BPA;
Patch on HD and processor BPA applies to this example.
Input:
ACTIVATE-PATCH:PATCH,D60001,RAM;
Patch at all target processors valid for subsystem (not on HD).
Input:
ACTIVATE-PATCH:GRP,KV15TS07;
All patches with group identifier KV15TS07 will be activated.
ACTIVATE-PATCH:GRP,KV15TS06&KV15TS07;
All patches with group identifier KV15TS06 and KV15TS07 will be activated.
ACTIVATE-PATCH:PATCH,D60001&D60002&D60003,,,SINGLE;
Patch activated with Single Patch.
Input:
ACTIVATE-PATCH:OPT,D,12;
Activate all optional patches for ADP with activation flag 12.
ACTIVATE-PATCH:OPT,S,27&33&34;
Activate all optional patches for SWU with activation flags 27, 33, 34.
${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.