The SSINFO file is read when a pubset is entered in the catalog. It can be used to control how many pubsets (i.e. how many GUARDS catalogs) are to be processed by their own GUARDS server task. By default, a GUARDS server task is created for each imported pubset in order to process the GUARDS catalog created on the pubset.
The SSINFO file contains the control parameters in the form of ISP commands. It can be processed with any normal editor. The file may also contain comments.
File and processing attributes
The SSINFO file is a SAM file containing variable-length records. Shared-update processing is not necessary since only read accesses are executed when the subsystem is started and during catalog entry.
File attributes:
the access method is SAM
the record format is variable-length
the block size is 2048 bytes
Processing attributes:
shared-update processing is not required
Structure of the SSINFO file
The first few records in the SSINFO file begin with an asterisk (*), which identifies them as comments, and contain a help text for specification of the control parameters.
In addition to comment lines, the SSINFO file may contain nothing but the following ISP command:
SET-TASK-DISTRIBUTION PUBSET = list-poss(16):<catid 1..4> / *HOME
This command is used to list the pubsets which are to be served by a GUARDS server task. *HOME is the home pubset. When *HOME is specified the SSINFO file does not need to be adapted when the home pubset changes.
One GUARDS server task can manage up to 16 pubsets. The maximum permitted length of the PUBSET operand is 255 characters.
Two or more single-feature pubsets (SF pubsets) can be combined to form a system-managed pubset (SM pubset). In this case, the former SF pubsets are addressed only by way of the catalog ID of the SM pubset.
CAUTION!
When an SM pubset is generated, system administration must ensure that the SET-TASK-DISTRIBUTION command in the SSINFO file is appropriately adapted.
Behavior in the case of invalid control parameters
If the SSINFO file contains invalid control parameters, the default setting applies to the affected pubsets: a GUARDS server task is generated for each pubset.
The contents of the SSINFO file are not changed and the invalid control parameters are not corrected. If the SSINFO file cannot be evaluated, a corresponding message is output on the console.