Version dependencies and system integration
When creating pubsets, there are two types of version dependency: target version dependency and execution version dependency.
SIR V21.0 can be used to create a home pubset for BS2000 from the execution versions BS2000 OSD/BC V10.0, V11.0 and BS2000 V21.0 and make it bootstrappable.
You should bear in mind that only device types belonging to the device spectrum of BS2000 (both in the execution version and in BS2000 V21.0) are supported.
A SIR version is generally coupled with a particular version of BS2000. Therefore, the following must always apply: Execution version <= target version.
This means that downgrading is not possible (e.g. setting up a pubset with version-specific features of BS2000 OSD/BC V11.0, which is then to be executed on BS2000 V21.0 with SIR V21.0).
It is recommended to keep a suitable home pubset or IPL disk, in case you might need to return to an earlier version in the future.
Upgrading from BS2000 OSD/BC V10.0 and V11.0
In the legacy versions BS2000 OSD/BC V10.0 and V11.0, SIR V21.0 can only be installed and temporarily activated using BS2GA.MIGRATE V21.0. A comprehensive description of the upgrade can be found in the “System installation” manual [7].
Privileges in SIR
Using the SIR functions leads to structural changes in disk contents and is therefore reserved for users with the appropriate authorization (TSOS privilege and STD-PROCESSING privilege). In addition, the operations to be performed on the disks are only possible in conjunction with privileged system functions. For this reason, on completion of parameter input, the SIR function executes as a DSSM subsystem after an SVC. Attempts by parallel tasks to use the same pubset ID at the same time will be rejected.
Calling SIR
The SIR utility routine can be called in either interactive or batch mode using the command /START-SIR or /SIR.
The statements are read from the system file SYSDTA. Input errors can be corrected at once in interactive mode as long as SYSDTA has not been reassigned. Otherwise input is aborted as soon as an invalid statement is encountered.
Messages are routed to SYSOUT.
Example of a SIR run
A pubset is extended by a disk which is made bootstrappable.
/start-sir
% SIRLOAD PROGRAM SIR, VERSION <version> OF <date> LOADED FROM FILE
:CAM1:$TSOS.SYSLNK.SIR.<version>
% SIR0000 PROGRAM SIR (VERSION <version>) READY FOR INPUT
declare-pubset pubset-type=*single-feature(pubset=9701,action=*extend)
create-volume disk-number=2(overwrite-disk=c0002r,unit=A901)
create-ipl-volume disk-number=2
list-statements
*******************************************************************
* *
* OPTION AND TASK ORDERS GENERATED : *
* *
* STATEMENTS GENERATED : *
* NUMBER STATEMENT *
* 1 //DECLARE-PUBSET PUBSET-TYPE=*SINGLE-FEATURE(PUBS- *
* ET=9701,ACTION=*EXTEND,SYS-ID=*CAT-ID) *
* 2 //CREATE-VOLUME DISK-NUMBER=2(OVERWRITE-DISK=C000- *
* 2R,UNIT=A901(SUBUNIT=*NO)),DEVICE-TYPE=*BY-UNIT,F- *
* ORMAT=*NO *
* 3 //CREATE-IPL-VOLUME DISK-NUMBER=2,HSI-TYPE=*BY-OWN *
* -HSI *
* *
*******************************************************************
% SIR7054 ENTER LIST SUBFUNCTION OR 'END'. REPLY ('+'=SCROLL FORWARD;
'-'=SCROLL BACK; END=TERMINATE LST FUNCTION)
end
create-paging-file disk-number=2,file-size=150
start-execution
*******************************************************************
* PUBSET-TYPE: SINGLE-FEATURE *
* LARGE-DISKS-ALLOWED: NO *
* LARGE-FILES-ALLOWED: NO *
* *
* P U B S E T - D I S K T A B L E (ACTION: *EXTEND) *
* *
* PVS-ID SYS-ID FORMAT PHYSICAL- ALLOCATION- AVAILABILITY *
* BLOCK-SIZE UNIT *
* *
* 9701 65 K 2K 6 NORMAL *
* *
* VSN DEVICE- VOLIN- MAIN- SUB- CHECK- CAT- PAG- SNAP- IPL-*
* TYPE ACTION UNIT UNIT VSN SIZE SIZE SIZE VOL *
* 9701.2 D3435 I A901 C0002R 150 Y *
* *
*******************************************************************
*******************************************************************
* C R E A T E - I P L - V O L U M E T A B L E *
* *
* PUBLIC DISKS *
* *
* VSN:9701.2 DEVICE:D3435 *
* HSI:390 *
* *
*******************************************************************
% SIR0040 DO YOU WANT TO CORRECT INPUT? REPLY (Y=YES; N=NO)?
n
% SIR0300 'CREATE-VOLUME' FUNCTION STARTED
% NVL0000 VOLIN VERSION <version> READY
% NVL0031 INITIALIZATION STARTED FOR VOLUME '9701.2' ON UNIT 'A901' IN
FORMAT 'K(A-U=6)'
% NVL0017 INITIALIZATION OF VOLUME '9701.2' ON UNIT 'A901' COMPLETED.
VOLUME FORMAT: 'K(A-U=6)'
% SIR0301 'CREATE-VOLUME' FUNCTION TERMINATED NORMALLY
% SIR0169 IMCAT TASK STARTED
% SIR0400 CREATION OF PAGING FILES STARTED
% SIR0401 CREATION OF PAGING FILES TERMINATED NORMALLY
% SIR0523 //CREATE-IPL-VOLUME: FILE CHECK STARTED
% SIR0524 //CREATE-IPL-VOLUME: CHECK OF FILES TERMINATED
% SIR0500 //CREATE-IPL-VOLUME: PROCESSING STARTED
% SIR0501 //CREATE-IPL-VOLUME: PROCESSING TERMINATED NORMALLY
*******************************************************************
* PUBSET-TYPE: SINGLE-FEATURE *
* LARGE-DISKS-ALLOWED: NO *
* LARGE-FILES-ALLOWED: NO *
* *
* P U B S E T - D I S K T A B L E (ACTION: *EXTEND) *
* *
* PVS-ID SYS-ID FORMAT PHYSICAL- ALLOCATION- AVAILABILITY *
* BLOCK-SIZE UNIT *
* *
* 9701 65 K 2K 6 NORMAL *
* *
* VSN DEVICE- VOLIN- MAIN- SUB- CHECK- CAT- PAG- SNAP- IPL-*
* TYPE ACTION UNIT UNIT VSN SIZE SIZE SIZE VOL *
* 9701.2 D3435 I A901 C0002R 150 Y *
* *
*******************************************************************
*******************************************************************
* C R E A T E - I P L - V O L U M E T A B L E *
* *
* PUBLIC DISKS *
* *
* VSN:9701.2 DEVICE:D3435 *
* HSI:390 *
* *
*******************************************************************
end
% SIR1010 'SIR' TERMINATED