Model9 CDS Activation

PROGxx Updates

Create a new PROGxx member for the Model9 Cloud Data Set (CDS) installation (an example can be found in the SAMPLIB - PROGM9). The new member should include the following commands:

LPA ADD DSN(SYS2.MODEL9.V282.LOADLIB) MOD(ZM9019CW)
LPA ADD DSN(SYS2.MODEL9.V282.LOADLIB) MOD(ZM9019CC)
LPA ADD DSN(SYS2.MODEL9.V282.LOADLIB) MOD(ZM9OCEX4)
EXIT ADD EXITNAME(OCE_FILESTART)    MOD(ZM9OCEX4) ABENDNUM(100,CONSEC)
EXIT ADD EXITNAME(OCE_FILEEND)      MOD(ZM9OCEX4) ABENDNUM(100,CONSEC)
EXIT ADD EXITNAME(OCE_FILEVALIDATE) MOD(ZM9OCEX4) ABENDNUM(100,CONSEC)
EXIT ADD EXITNAME(OCE_LABELANOMALY) MOD(ZM9OCEX4) ABENDNUM(100,CONSEC)
EXIT ADD EXITNAME(OCE_VOLUMEMOUNT)  MOD(ZM9OCEX4) ABENDNUM(100,CONSEC)

Once the member was created in the appropriate PARMLIB directory activate the changes using the following command:

SET PROG=M9

In order for the new member to be loaded after each IPL, add the 'SET PROG=xx' command to the site standard COMMNDxx member.

Important: Do not use the IEASYSxx PROG=M9 statement, that would result in ADD EXIT action failures. The reason for the failures is that the LPA ADD statements take effect only after the IPL completes, not while it is proceeding

Installing Cloud Data Sets started tasks

There are a few started tasks (STCs) related to the CDS installation. For one of the STCs you will be required to specify the tape drives range previously defined in the IODF during the Model9 CDS Prerequisites.

The installation STCs should be added to the IPL procedure to avoid manual intervention.

For a SYSPLEX environment, use different device ranges for each SYSTEM. For example, if the IODF contains the range 1100-110F, use the range 1100-1107 on SYSA STCs and 1108-110F on SYSB STCs.

Initialize CDS STC

Customize the M9INSCDS member provided in the Model9 SAMPLIB directory:

  • BUFSIZE sets the amount of memory to allocate for each virtual device.

  • Increase the agent's heap size set in the model9-stdenv.sh configuration file by x MB using the AGENT_MEMORY setting:

    • Where x = 3 x NUMBER-OF-DEVICES x BUFSIZE For example: When using default BUFSIZE with 16 tape drives: x = 3x16x5 = 240MB

    • Agent's minimum heap size should be set to 2GB

  • For each virtual device, repeat the DEFINE step with the appropriate unit address. For example, to define 3 devices of range 1100-1102 use

//INSTALL  EXEC PGM=ZM9IAMM,PARM='INSTALL,BUFSIZE=0005'    
//STEPLIB  DD  DISP=SHR,DSN=SYS2.MODEL9.V282.LOADLIB       
//*                                                        
//D1100  EXEC PGM=ZM9IAMM,PARM='DEFINE=1100,XCF=M9ARCH' 
//STEPLIB  DD  DISP=SHR,DSN=SYS2.MODEL9.V282.LOADLIB        
//D1101  EXEC PGM=ZM9IAMM,PARM='DEFINE=1101,XCF=M9ARCH' 
//STEPLIB  DD  DISP=SHR,DSN=SYS2.MODEL9.V282.LOADLIB        
//D1102  EXEC PGM=ZM9IAMM,PARM='DEFINE=1102,XCF=M9ARCH' 
//STEPLIB  DD  DISP=SHR,DSN=SYS2.MODEL9.V282.LOADLIB 

Once ready copy the member to your site PROCLIB and start the STC using the START operator command:

S M9INSCDS

Verify the STC ended on return code zero.

Uninstaller STC

Copy the M9UNICDS member to your site PROCLIB. This STC can be used to uninstall Model9 Cloud Data Set from the current environment.

Virtual Devices Hook Installer STC

Customize the M9VDEV member provided in the Model9 SAMPLIB directory:

  • Update the device range to be controlled by the Cloud Data Set feature

  • Update the VOLSER prefix according to the defined tapes from step "Define pseudo tape volumes" in the Prerequisites

  • Update the Storage Group Name selected for Model9 Cloud processing

  • Add the TIME=1440 parameter to the M9VDEV EXEC statement

CHPID and SCHNO parameters shouldn't be changed without technical advice from Model9.

Once ready copy the member to your site PROCLIB and start the STC using the START operator command:

S M9VDEV

The STC is expected to remain running. You can expect the following output:

IEF403I M9VDEV - STARTED - TIME=13.14.45                                        
ZM9IC100I ZM9ICOM0 V2.8.2 (C) MODEL9 SOFTWARE LTD. BUILT ON 2023-07-03 07:36:45.261366
ZM9IC026I Z/OS(SP7.2.4 ),MODEL(8562)                                                  
ZM9IC003I HOOK(ZM9SIOTP),VDEV(0570-057F)                                               
ZM9IC005I COMM=0x1D3A2000, TRAMPOLINE=0x1EF62000                                      
ZM9IC008I MODEL9 VDEV STARTED        

Vary Tape Library Online

Issue the following command to vary online the manual tape library:

VARY SMS,LIB(M9MTL),ONLINE

You should see the following message in the syslog and OAM address space:

CBR3004I Library M9MTL now online.

Vary Model9 Tape Drives Online

Once M9VDEV is up and M9INSCDS successfully installed. You can go ahead and vary the Model9 tape drives online:

VARY 1100-110F,ONLINE

In a SYSPLEX environment, make sure each device is online only at one system

Display MTL Status

To display the status of the MTL issue the following command:

DISPLAY SMS,LIB(M9MTL),DETAIL

You should see an output similar to this:

CBR1110I OAM library status: 749                                      
TAPE      LIB  DEVICE    TOT  ONL  AVL   TOTAL   EMPTY  SCRTCH  ON OP 
LIBRARY   TYP  TYPE      DRV  DRV  DRV   SLOTS   SLOTS    VOLS        
M9MTL     ML   MANUAL     16   16   16       0       0       0  Y  Y  
----------------------------------------------------------------------
MEDIA         SCRATCH       SCRATCH       SCRATCH                     
TYPE            COUNT     THRESHOLD      CATEGORY                     
----------------------------------------------------------------------
LIBRARY ID: 99999                                                     

Notice that ONL DRV and AVL DRV should contain the amount of devices you varied online.

Last updated