Spooler Utilities Reference Manual

Migration Considerations for Pre-D41 Spooler
Versions
Spooler Utilities Reference Manual—522295-003
H-2
New Control File
New Control File
A new format SPL3 file is introduced in the D46 and later D41 (ADI, ADM, and later)
product versions of Spooler. The current Spooler product versions no longer use the
SPL4 control file. In the SPL3 file, all information for jobs, batches, names, and
attributes of other Spooler objects are integrated and retained in data structures. Thus,
a warmstart from older Spooler versions requires both the SPL3 and SPL4 files and
converts these files into the new SPL3 file.
Many developers and support analysts use the word “control version” to correspond
with the numbering of Spooler control files. The current Spooler control version,
Version 5 (D41/D46/D48 Spooler), corresponds to the current control file format, SPL3.
Before installing the D- or G-series operating system that introduces the new format
SPL3 file, back up the Spooler control file in case you have to fall back. As mentioned
earlier, and in Section 1, Spooler Quick Start, when you warm start the Spooler, the
control files are automatically converted to the new control file format.
Migrating Files From a Pre-D41 Product Version of Spooler
From a pre-D41 product version of Spooler, perform the following procedures to
migrate to a spooler product version that is either T9101D41, D46, or D48:
1. Review the T9101D41 SOFTDOC that describes a workaround in case an old job
is deleted after the new spooler product version is installed. See also Section 3,
Peruse "SPOOLCOM" new options for JOB command
2. Use DSM/SCM to install the spooler software from the Site Update Tape (SUT).
3. Create new collector data file[s] that will be used by collectors after warm starting.
Refer to Section 4, Spoolcom under JOB command for information about
characteristics of collectors and their data files. See also COLLECT Subcommand
on page H-9.
4. Back up the Spooler control and data files in case you have to fall back to your
previous version of Spooler. For backup procedures, see Step 3: Back up the
Spooler Control and Data Files on page 1-10. For migration information, see Older-
Version Collector Files Required to Access Older-Version Jobs on page H-6l
Control and Data Files.
5. Warm start the spooler. See Section 1, Spooler Quick Start, Warm Starting a
Spooler on page 1-4.
6. Change the DATA attribute of the existing collector[s] to point to the data file[s]
created in step 3.
)COLLECT $S,DATA $SYSTEM.SPOOLER.NEWDATA
Note. Do not use the SPOOLCOM;SPOOLER,START command at this time.