Distribute subsystems to holder tasks
Function
This statement is used to control the distribution of subsystems to holder tasks. The subsystems listed in the statement can use the holder task as a work task, or will be set up together in a holder task. If this statement is omitted when creating a catalog, SSCM will make a standard assignment of the subsystems in order to limit the number of holder tasks.
This statement is mandatory for subsystems which use the holder task as a work task.
In order to become a work task, the entry points of the subsystem must be defined with one of the following combinations:
CLOSE-CTRL | STOPCOM | DEINIT |
*DYNAMIC | *DYNAMIC | *DYNAMIC |
*DYNAMIC | *NO | *DYNAMIC |
*NO | *DYNAMIC | *DYNAMIC * |
*NO | *NO | *DYNAMIC * |
*For compatibility reasons it is not obligatory to define a DEINIT
routine for a subsystem without a CLOSE-CTRL routine. It
should be noted, however, that no guarantee can be given for
correct execution of the subsystem in such a case.
The statement may only be used once for an SSD object. If there are two consecutive statements for the same subsystem and there is a conflict (i.e. contradictory declarations), the definition which requires the holder task to be used as a work task will take precedence.A declaration referring to a shared holder task applies to every version of the subsystem, except for any versions which use the holder task as a work task.
ASSIGN-HOLDER-TASK is rejected if none of the following statements has been executed beforehand:
START-SSD-CREATION
START-CATALOG-CREATION
START-CATALOG-MODIFICATION
Format
ASSIGN-HOLDER-TASK | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
Operands
TYPE =
Specifies whether the holder task is to be used as a work task or the subsystem is to be created in a shared holder task.
TYPE = *WORK-TASK(...)
Default value: the holder task is to be used as a work task.
SUBSYSTEM-NAME = <structured-name 1..8>
Name of the subsystem which is to use the holder task as a work task.
SUBSYSTEM-VERSION = <c-string 3..8> / <text 3..8>
Version of the subsystem which is to use the holder task as a work task.
This version must have been declared previously.
TSN =
Specifies the task sequence number (TSN) to be given to the subsystem’s work task.
TSN = *BY-DSSM
Default value: the TSN will be issued by DSSM when the work task is loaded.
TSN = <alphanum-name 1..4>
The TSN to be given to the work task when it is started.
The specified TSN must be uniquely defined and usable when the subsystem is loaded.
TYPE = *SHARED-HOLDER(...)
The subsystem is to be created in a shared holder task.
BY-SUBSYSTEMS = list-poss(15): <structured-name 1..8>
Names of up to 15 subsystems which are to be created in the same holder task.The first of the subsystems in the list must have been declared previously.
TSN =
Specifies the task sequence number (TSN) to be given to the shared holder task.
TSN = *BY-DSSM
Default value: the TSN will be issued by DSSM when the work task is loaded.
TSN = <alphanum-name 1..4>
Task sequence number to be given to the shared holder task when it is started.
The specified TSN must be uniquely defined and usable when the subsystem is loaded.