Generate SSD object for adding subsystem definitions
Function
The START-SSD-CREATION statement initiates the generation of an SSD object for adding subsystem definitions. The user must specify the name of the SSD object, the name of the file in which it is to be stored, and the names of the files required or referenced by the subsystem.
START-SSD-CREATION is rejected and an error message issued if the file to be specified for SSD-FILE-NAME already exists.
The SAVE-CATALOG statement for saving all declared attributes can be entered only after successfully executing the SET-SUBSYSTEM-ATTRIBUTES statement.
Format
START-SSD-CREATION |
SSD-NAME = <name 1..8> ,VERSION = <integer 1..999> ,DOMAIN = <structured-name 1..13> ,CORRECTION = *NONE / list-poss(20): <alphanum-name 8..8> ,SSD-FILE-NAME = <filename 1..51 without-userid without-gen-vers> ,BLOCK-CONTROL-INFO = *STD / *WITHIN-DATA-BLOCK |
Operands
SSD-NAME = <name 1..8>
Name of the SSD object.
The name must comply with the following convention: the first three letters correspond to the product’s message class, and the last three letters are “SSC”.
VERSION = <integer 1.999>
Version of the SSD object.
DOMAIN = <structured-name 1..13>
Identifier of the MONSYS domain for the SSD object. The name of this domain is used internally by the system to implement the unique, consistent assignment of all components to the subsystem.
CORRECTION =
Indication of whether PULS problem messages are incorporated in the SSD object for the subsystems.
CORRECTION = *NONE
Default value: no PULS problem messages are incorporated in the SSD object.
CORRECTION = list-poss(20) <alphanum-name 8..8>
List of a maximum of 20 problem messages which are corrected in the SSD object.
SSD-FILE-NAME = <filename 1..51 without-userid without-gen-vers>
Name of the new ISAM file which is to be created and in which the SSD object is to be saved. If the file name already exists, the statement will be rejected.
BLOCK-CONTROL-INFO =
Specifies the file format in which the file for the SSD object is to be created.
BLOCK-CONTROL-INFO = *STD
Default setting: SSCM first attempts to create the SSD object as a K file (block format PAMKEY) with block length 1 (BUFFER-LENGTH=*STD(SIZE=1)).
In the event of an error an attempt is made to create the SSD object with block length 2.
If this attempt is also unsuccessful, the SSD object is created as an NK file with block format DATA and block length 2.
BLOCK-CONTROL-INFO = *WITHIN-DATA-BLOCK
SSCM creates the SSD object as an NK file in the DATA block format and with block length 2.
Notes
Successful processing of the START-SSD-CREATION statement can be followed only by the statements listed below. The ones marked with an asterisk can be used more than once in order to define different subsystems (but not different versions of the same subsystem):
ADD-SUBSYSTEM-ENTRIES (*)
ASSIGN-HOLDER-TASK (*)
SEPARATE-ADDRESS-SPACE (*)
SET-SUBSYSTEM-ATTRIBUTES (*)
SHOW-SSD