Customizing the started task JCL

Before you can use any of the Advanced Archive for DFSMShsm features, you must copy the started task member AXQTINIT from the SAXQSAMP library to a system procedure library and then customize the JCL appropriately for your environment.

Procedure

  1. Copy member AXQTINIT from the SAXQSAMP runtime library to a system procedure library, such as SYS1.PROCLIB.
  2. Open member AXQTINIT for editing. 
    //AXQTINIT  PROC SMODE=ACTDYN        
//*                                                                    
//*-------------------------------------------------------------------*
//*                                                                   *
//*      © ROCKET SOFTWARE, INC. OR ITS AFFILIATES 2014-2018.         *
//*      ALL RIGHTS RESERVED.                                         *
//*                                                                   *
//*                                                                   *
//*      ARCHIVE MANAGER STARTED TASK INITIALIZATION                  *
//*                                                                   *
//*                                                                   *
//*      THIS JOB IS USED TO INITIALIZE THE ARCHIVE MANAGER STARTED   *
//*      TASK AND SHOULD BE STARTED BEFORE ANY TASKS THAT MIGHT       *
//*      ACCESS ARCHIVED FILES RUN, AFTER AN IPL.                     *
//*                                                                   *
//*      BEFORE YOU RUN THIS JOB, DO THE FOLLOWING:                   *
//*         1) ENSURE THAT THE JOBCARD IS VALID FOR YOUR              *
//*            ENVIRONMENT                                            *
//*         2) SUBSTITUTE YOUR DATA SET PREFIX FOR @HLQ               *
//*                                                                   *
//*      THE FOLLOWING VALUES FOR SMODE MAY BE SPECIFIED:             *
//*         PARM=ACTDYN - START WITH SYSTEM HOOKS AND DYNAMIC RESTORE *
//*                       FUNCTIONALITY ACTIVE                        *
//*         PARM=ACT    - START WITH SYSTEM HOOKS IN WARNING MODE FOR *
//*                       ARCHIVED DATA SETS                          *
//*         PARM=DEACT  - START WITH SYSTEM HOOKS INACTIVE            *
//*                                                                   *
//*-------------------------------------------------------------------*
//*                                                                    
//MXQTINIT EXEC PGM=AXQTINIT,REGION=8M,TIME=1400,PARM='&SMODE'                                
//STEPLIB  DD DISP=SHR,DSN=@HLQ.SAXQLOAD                               
//AXQPRLIB DD DISP=SHR,DSN=@HLQ.SAXQPARM                               
//                                                                 
    //AXQTINIT  PROC SMODE=ACTDYN        
//*                                                                    
//*-------------------------------------------------------------------*
//*                                                                   *
//*      5698-AAD                                                     *
//*      © ROCKET SOFTWARE, INC. OR ITS AFFILIATES 2014-2018.         *
//*      ALL RIGHTS RESERVED.                                         *
//*                                                                   *
//*                                                                   *
//*      ADVANCED ARCHIVE STARTED TASK INITIALIZATION                 *
//*                                                                   *
//*                                                                   *
//*      THIS JOB IS USED TO INITIALIZE THE ADVANCED ARCHIVE STARTED  *
//*      TASK AND SHOULD BE STARTED BEFORE ANY TASKS THAT MIGHT       *
//*      ACCESS ARCHIVED FILES RUN, AFTER AN IPL.                     *
//*                                                                   *
//*      BEFORE YOU RUN THIS JOB, DO THE FOLLOWING:                   *
//*         1) ENSURE THAT THE JOBCARD IS VALID FOR YOUR              *
//*            ENVIRONMENT                                            *
//*         2) SUBSTITUTE YOUR DATA SET PREFIX FOR @HLQ               *
//*                                                                   *
//*      THE FOLLOWING VALUES FOR SMODE MAY BE SPECIFIED:             *
//*         PARM=ACTDYN - START WITH SYSTEM HOOKS AND DYNAMIC RESTORE *
//*                       FUNCTIONALITY ACTIVE                        *
//*         PARM=ACT    - START WITH SYSTEM HOOKS IN WARNING MODE FOR *
//*                       ARCHIVED DATA SETS                          *
//*         PARM=DEACT  - START WITH SYSTEM HOOKS INACTIVE            *
//*                                                                   *
//*-------------------------------------------------------------------*
//*                                                                    
//AXQTINIT EXEC PGM=AXQTINIT,REGION=8M,TIME=1400,PARM='&SMODE'                                 
//STEPLIB  DD DISP=SHR,DSN=@HLQ.SAXQLOAD                               
//AXQPRLIB DD DISP=SHR,DSN=@HLQ.SAXQPARM                               
//
  3. Replace all occurrences of @HLQ with your data set prefix.
  4. On the EXEC PGM= statement, specify REGION= and TIME= values that are appropriate for your environment.
    Specifying appropriate values for these parameters minimizes the likelihood of an abend occurring.
    • For the REGION= parameter, you may specify whatever value your environment requires; however, be aware that specifying a value that is less than 8M could cause storage-related abends when L0 disk data sets are being restored.
    • By specifying a value for the TIME= parameter, you ensure that the AXQTINIT step does not terminate because it had to wait for an excessive period of time. The default value is 1440 minutes. See the z/OS MVS JCL Reference for more information about this parameter.
  5. Modify the SMODE value to control the default EXEC PARM that will be supplied at execution.
    • Specify ACTDYN if you want to restore archived data sets automatically. When a data set is referenced by the LOCATE SVC and is found to be archived, a request is made from the referencing address space to the started task to perform an automatic Restore. The data set is restored, using the values that are currently specified in the product parameter library. When the data set has been restored to ML2, the LOCATE operation continues and regular HSM processing occurs. In addition to the normal activity logging that is performed by the batch Restore (see Modifying and executing the Restore job JCL), the automatic Restore process writes a line of summary information in the SUMMLOG DD data set that was allocated dynamically by the started task.
    • Specify ACT if you do not want archived data sets to be restored automatically. In this mode, every time an archived data set is referenced by the LOCATE SVC, a warning message is issued to the referencing task, indicating that the data set is archived. The LOCATE operation fails with a return code that simulates a not found condition to the caller of the SVC.
    • Specify DEACT if you do not want the LOCATE request to be interpreted. Running the started task in this mode can cause a program that references an archived data set to request a tape mount for the volume serial number RCHIVE (or whatever name was specified in the product parameter library).
      Note: Generally, you would not run the product in DEACT mode unless you have made other provisions for responding to the potential tape mount messages or for handling LOCATE requests for data sets that are cataloged to the RCHIVE volume serial number.
  6. Start the AXQTINIT PROC after an IPL on each system where Advanced Archive for DFSMShsm processing will be executed and on any system where jobs might attempt to access files that have been archived.

What to do next

Go on to Defining system security access for Advanced Archive for DFSMShsm.