18.3.1 TEST-APS

Tests whether the status of the supplied PS match the status on the HD.
However, this test does not change the :PDS: area in any way.
The test can be carried out as often as desired, unless a COPY-APS has not successfully been completed beforehand.
Depending on input, there are various test options:
•
If a DIR file is not specified (parameter DIRNAME), the NORMAL test is run.
The test ascertains which PS have been supplied and which are already present. In the event that the version number and corrected version number of the supplied PS are greater than those of the PS already present, the supplied PS are copied. This means that only those SUSY are copied whose version or corrected version in the supplied PS has been altered in comparison to the PS already present.
If the DIR file corresponds to the DIR file specified on the data carrier (e.g. "DIRDC0.20.001"), the specified PS in the PGLIB is copied.
If the DIR file corresponds to the DIR file specified in the PGLIB (e.g. "D0-EF0DC"), the specified PS is deleted from the PGLIB.
Duplicate entries will be detected and rejected by the AMO APS.
The specified PS are copied without testing of their version or corrected version, even if they were not yet present in the PGLIB. If a complete delivery is being made, all SUSY of the specified PS are copied.
If a partial delivery is being made, all SUSY are copied which have been altered with respect to the PGLIB status. If PS are found which have been altered but were not specified, the NORMAL test is then run for these PS.
If an additional DIR file exists on the data carrier, it is tested regardless of input.
Only those PS are copied for which the DIR files have been specified. For each SUSY a query is made as to whether it is to be copied, and, if it is not to be copied, whether the present status is to be deleted.
•
If two or more DIR files of the same type are on a data carrier, the user is queried as to whether the DIR file is to be copied.
DIR files of the same type are, for example, DIRD11.20.001 (Server texts in German) and DIRD22.20.001 (Server texts in English).
All system programs of PGLIB and data carrier will be tested normal.
If DIRNAME is declared as a DIR file of data carrier, the system program will be tested forced. The other one will be be tested normal.
If DIRNAME is declared as a DIR file of PGLIB, the system program will be deleted on PGLIB.
The kind of assumption can be directed by the parameter MODE.
•
If MODE is declared as (NALL/FALL/NGEN/FGEN), the declaration of DIRNAME and SELE will be rejected. If MODE is declared as DELETE and system programs have been declared, the system programs have to be declared as system programs of PGLIB. (e.g.: data carrier DIRDC0.20.001 in PGLIB D0-EF0DC).
•
If in addition to the parameter value NORMAL the name of a DIR-file is specified, this program system will be tested regardless of a predecessor.
By declaration of SELE you will get an assortment of selections. Without the parameter SELE you will get either selections depending on parameter MODE or no selections.
•
Repeated testing means that a tested status of a system program will be tested any more.
The sense of using repeated testing is that additional selections can be added or deleted without a run of COPY-APS between two runs of TEST-APS.
Repeated testing is only possible by the MODES of NORMAL, FORCE, DBNORM, DBONLY and DELETE.
Procedure Overview
 
Command Code
Parameter
TEST-APS
[FILENAME=<string>],[DIRNAME=<string>],[MODE=<param>]
 
,[SELE=<string>],[DESTDEV=<string>]
 
,[LANAME=<string>],[ANS=<param>];
Examples
1.
DIR file DIRSC0.20.001 will be tested forced. Other DIR files on the source device will be tested normal.
Input:
TEST-APS:,"DIRSC0.20.001",;
2.
DIR file DIRSC0.20.001 will be tested forced. A cartridge is used as source device and has been reserved by the AMO RTAPE with the logical name "C". Other DIR files on the source device will be tested normal.
Input:
TEST-APS:":C:","DIRSC0.20.001",;
3.
All program system of data carrier will be tested. The subsystems of all present selections will be tested whether the subsystem has changed.
Input:
TEST-APS:":C:";
4.
All program systems of PGLIB will be tested. The subsystems of all present selections will be tested whether the subsystem has changed.
All subsystems of DIR files DIRBC0 and DIRB22 will be assumed forced.
Input:
TEST-APS:":C:","DIRBC0.20.001"&"DIRB22.20.001";
5.
All program systems of specified data carrier will be tested with all selections and all subsystems of these selections (Generation system).
Input:
TEST-APS:":C:",,FALL;
6.
All changed subsystems of all system programs and selections will be tested.
Input:
TEST-APS:":C:",,NALL;
7.
The specified program systems and their actuell selections will be tested. The changed subsystems will be assumed by COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",NORMAL;
8.
The specified program systems and their actuell selections will be tested. The changed subsystems and DB subsystems will be assumed by COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",DBNORM;
(*1) Valid for SP300-V3.1
9.
The specified program systems and their actuell selections will be tested. The changed subsystems will be assumed by COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",FORCE;
10.
The specified program systems will be tested, their actuell selections have to be deleted by the following run of COPY-APS. All subsystems will be deleted by the following run of COPY-APS. The name of program systems have to be the name in PGLIB.
Input:
TEST-APS:,"S0-EF0DC"&"B0-EF0BC",DELETE;
11.
The specified program systems and their actuell selections will be tested. Only DB subsystems will be assumed by the following run of COPY-APS. The program systems have to be specified with their actuell correct version on PGLIB.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",DBONLY;
12.
The specified program systems of data carrier and PGLIB will be tested. All changed subsystems will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:",,NORMAL,SELEK001&SELEK002&&SELEK003;
13.
The specified program systems of data carrier and PGLIB will be tested. All subsystems will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:",,FORCE,SELEK001&SELEK002&SELEK003;
14.
The specified selections, which have to be deleted, of all program systems in PGLIB will be tested. All subsystems which are not contained in any selection and the subsystems of the specified selections will be tested. All subsystems, which will not be used any more, will be deleted by the following run of COPY-APS.
Input:
TEST-APS:":C:",,DELETE,SELEK001&SELEK002&SELEK003;
15.
The specified selections of the specified program systems will be tested. The subsystems with changed status will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001",NORMAL,SELEK001&SELEK002&SELEK003;
16.
The specified selections of the specified program systems will be tested. All subsystems will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001",FORCE,SELEK001&SELEK002&SELEK003;
17.
All actuell active and all specified selections of the specified program systems will be tested. The changed subsystems will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",NORMAL,
SELEK001&SELEK002&SELEK003;
18.
All actuell active and all specified selections of the specified program systems will be tested. The changed subsystems and the DB subsystems will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",DBNORM,
SELEK001&SELEK002&SELEK003;
19.
The specified selections of specified program systems will be tested. Only the DB subsystems will be assumed by the following run of COPY-APS.
Input:
TEST-APS:":C:","DIRDC0.20.001"&"DIRSC0.20.001",DBONLY,
SELEK001&SELEK002&SELEK003;
20.
In the specified program systems all selections, which have been specified as to delete, will be tested. All subsystems which are not contained in any selection and all subsystems of the spe3cified selections will be tested. The subsystems which are not required any more will be deleted by the following run of COPY-APS. The program systems have to be specified with their name of PGLIB.
Input:
TEST-APS:":C:","D0-EF0DC",DELETE,SELEK001&SELEK002&SELEK003;
21.
The added selection SIMPLEX has to be deleted from PGLIB, the not added selection DUPLEX has to be added.
Input:
TEST-APS:,"S0-EF0SC",DELETE,SIMPLEX;
TEST-APS:,"DIRSC0.20.030",FORCE,DUPLEX;
22.
Testin of a program system. The program system will be copied by a following COPY-APS into the area :PDS2":. The area with the name :PDS: must be changed with CHANGE-TINIT:A1,A1H2E,":PDS:" to ":PDS2:"
Input:
T-APS:":C:","DIRDC0.20.001",,,":PDS2:";
${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.