Primary address space startup procedure

Figure 1 is a sample DFSMShsm primary address space startup procedure.

Figure 1. Sample Startup Procedure for the DFSMShsm Primary Address Space

//**********************************************************************/
//* SAMPLE DFSMSHSM STARTUP PROCEDURE THAT STARTS THE DFSMSHSM PRIMARY */
//* ADDRESS SPACE.                                                     */
//**********************************************************************/
//*
//DFSMSHSM  PROC CMD=00,        USE PARMLIB MEMBER ARCCMD00 
//            EMERG=NO,           ALLOW ALL DFSMSHSM FUNCTIONS
//            LOGSW=YES,          SWITCH LOGS AT STARTUP
//            STARTUP=YES,        STARTUP INFO PRINTED AT STARTUP
//            UID=HSM,            DFSMSHSM-AUTHORIZED USER ID
//            SIZE=0M,            REGION SIZE FOR DFSMSHSM
//            DDD=50,             MAX DYNAMICALLY ALLOCATED DATA SETS
//            HOST=?HOST,         PROC.UNIT ID AND LEVEL FUNCTIONS
//            PRIMARY=?PRIMARY,    LEVEL FUNCTIONS
//            PDA=YES,            BEGIN PDA TRACING AT STARTUP
//            CDSR=YES            RESERVE CONTROL DATA SET VOLUMES
//DFSMSHSM  EXEC PGM=ARCCTL,DYNAMNBR=&DDD,REGION=&SIZE,TIME=1440,
//          PARM=('EMERG=&EMERG','LOGSW=&LOGSW','CMD=&CMD','UID=&UID',
//          'STARTUP=&STARTUP','HOST=&HOST','PRIMARY=&PRIMARY',
            'PDA=&PDA','CDSR=&CDSR')
//*****************************************************************/
//*   HSMPARM DD must be deleted from the JCL or made into a      */
//*       a comment to use Concatenated Parmlib Support           */
//*****************************************************************/
//HSMPARM  DD DSN=SYS1.PARMLIB,DISP=SHR
//MSYSOUT  DD SYSOUT=A
//MSYSIN   DD DUMMY
//SYSPRINT DD SYSOUT=A,FREE=CLOSE
//SYSUDUMP DD SYSOUT=A
//*
//*****************************************************************/
//* THIS PROCEDURE ASSUMES A SINGLE CLUSTER MCDS.  IF MORE THAN   */
//* ONE VOLUME IS DESIRED, FOLLOW THE RULES FOR A MULTICLUSTER    */
//* CDS.                                                          */
//*****************************************************************/
//*
//MIGCAT   DD DSN=HSM.MCDS,DISP=SHR
//JOURNAL  DD DSN=HSM.JRNL,DISP=SHR
//ARCLOGX  DD DSN=HSM.HSMLOGX1,DISP=OLD
//ARCLOGY  DD DSN=HSM.HSMLOGY1,DISP=OLD
//ARCPDOX  DD DSN=HSM.HSMPDOX,DISP=OLD
//ARCPDOY  DD DSN=HSM.HSMPDOY,DISP=OLD
//*

Figure 2 is a sample startup procedure using STR.

Figure 2. Sample of STR Usage

Example of a startup procedure:                                                 
//DFSMSHSM  PROC  CMD=00,          USE PARMLIB MEMBER ARCCMD00                  
//                STR=00,          STARTUP PARMS IN ARCSTR00                    
//                HOST=?HOST,      PROC UNIT AND LEVEL FUNCTIONS                
//                PRIMARY=?PRIMARY,LEVEL FUNCTIONS                              
//                DDD=50,          MAX DYNAMICALLY ALLOCATED DS                 
//                SIZE=0M          REGION SIZE FOR DFSMSHSM                     
//DFSMSHSM EXEC PGM=ARCCTL,DYNAMNBR=&DDD,REGION=&SIZE,TIME=1440,    
//         PARM=('STR=&STR','CMD=&CMD','HOST=&HOST',          
                 'PRIMARY=&PRIMARY')                                      
//HSMPARM  DD DSN=SYS1.PARMLIB,DISP=SHR                                         
//MSYSOUT  DD SYSOUT=A                                                          
//MSYSIN   DD DUMMY                                                             
//SYSPRINT DD SYSOUT=A,FREE=CLOSE                                               
             . . .                                                              
PARMLIB Member ARCSTR00 contains 4 records:                                     
 1st record: EMERG=NO,CDSQ=YES,STARTUP=YES                                      
 2nd record:  /* This is a comment.                                             
 3rd record:  /* This is another comment.  */                                   
 4nd record: PDA=YES,LOGSW=YES

For an explanation of the keywords, see Startup procedure keywords.

The CMD=00 keyword refers to the ARCCMD00 member of PARMLIBs discussed in Parameter libraries (PARMLIB). You can have as many ARCCMDxx and ARCSTRxx members as you need in the PARMLIBs. DFSMShsm does not require the values of CMD= and STR= to be the same, but you may want to use the same values to indicate a given configuration. In this publication, the ARCCMD member is referred to generically as ARCCMDxx because each different ARCCMDxx member can be identified by a different number.

Much of the rest of this discussion pertains to what to put into the ARCCMDxx member.

For information about the ARCCMDxx member in a multiple DFSMShsm-host environment, see Defining all DFSMShsm hosts in a multiple-host environment. To minimize administration, we suggest that you use a single ARCCMDxx and a single ARCSTRxx member for all DFSMShsm hosts sharing a common set of control data sets in an HSMplex.