Procédure DBC

La procédure DBC est une procédure d'exécution en ligne permettant d'initialiser l'environnement DBCTL.

Définition de ressource dynamique (DRD) pour les ressources dans le système IMS IMS.MODBLKS est activé et vous n'utilisez plus les fichiers MODBLKS. Cette procédure ne nécessite plus les instructions DD pour les fichiers MODBLKS, MODBLKSA et MODBLKSB.

JCL

La procédure illustrée dans l'exemple suivant exécute une région de contrôle DBCTL IMS .
//       PROC RGN=64M,SOUT=A,DPTY='(14,15)',
//            SYS=,SYS2=,
//            LOGT=2400,SYS1=,
//            RGSUF=DBC,PARM1=,PARM2=
//IEFPROC EXEC PGM=DFSMVRC0,DPRTY=&DPTY,REGION=&RGN,
//            PARM='DBC,&RGSUF,&PARM1,&PARM2'
//*
//*
//* THE MEANING AND MAXIMUM SIZE OF EACH PARAMETER
//* IS AS FOLLOWS:
//****************************************************
//*   RGSUF  XXX   EXEC PARM DEFAULT BLOCK SUFFIX FOR
//*                MEMBER DFSPBXXX.
//****************************************************
//*
//*  PARM1 , PARM2 PARAMETERS BOTH ARE USED TO SPECIFY
//*  CHARACTER STRINGS THAT CONTAIN IMS KEYWORD
//*  PARAMETERS. I.E. PARM1='AUTO=Y,PST=222,RES=Y'
//*
//*  ALL OF THE VALID DBCTL KEYWORD PARAMETERS
//*  ARE DESCRIBED BELOW
//****************************************************
//*
//******** CONTROL REGION SPECIFICATIONS ********
//*   RES    X     BLOCK RESIDENT (N = NO, Y = YES)
//*   PST    XXX   NUMBER OF PST'S PERMANENTLY ALLOC
//*   MAXPST XXX   MAXIMUM NUMBER OF PST'S
//*   SRCH   X     MODULE SEARCH INDICATOR FOR DIRECTED LOAD
//*                0 = STANDARD SEARCH
//*                1 = SEARCH JPA AND LPA BEFORE PDS
//*   FMTO         T = ONLINE FORMATTED DUMP WITH
//*                    STORAGE IMAGE DELETIONS.
//*                    TERM=NO SDUMPS ALLOWED.
//*                P = FULL ONLINE FORMATTED DUMP.
//*                    TERM=NO SDUMPS ALLOWED.
//*                F = FULL ONLINE FORMATTED DUMP.
//*                    TERM=NO SDUMPS NOT ALLOWED.
//*                N = NO FORMATTED DUMP, NO OFFLINE
//*                    DUMP. TERM=NO SDUMPS ALLOWED.
//*                Z = NO FORMATTED DUMP, NO OFFLINE
//*                    DUMP. TERM=NO SDUMPS NOT
//*                    ALLOWED.
//*  (DEFAULT)     D = OFFLINE DUMP, OR ONLINE FORMAT-
//*                    TED DUMP WITH STORAGE IMAGE
//*                    DELETIONS IF OFFLINE DUMPING
//*                    FAILS. TERM=NO SDUMPS ALLOWED.
//*                X = OFFLINE DUMP, OR ONLINE FORMAT-
//*                    TED DUMP WITH STORAGE IMAGE
//*                    DELETIONS IF OFFLINE DUMPING
//*                    FAILS. TERM=NO SDUMPS NOT
//*                    ALLOWED.
//*                M = OFFLINE DUMP, ONLINE IMS DUMP
//*                    FORMATTING NOT PERMITTED
//*                    TERM=NO SDUMPS ALLOWED.
//*                R = OFFLINE DUMP, ONLINE IMS DUMP
//*                    FORMATTING NOT PERMITTED
//*                    TERM=NO SDUMPS NOT ALLOWED.
//*   AUTO   X     Y = AUTOMATIC RESTART DESIRED
//*                N = NO AUTOMATIC RESTART
//*   IMSID  XXXX  IMS SUBSYSTEM IDENTIFIER
//*   ISIS   X     N = NO RESOURCE ACCESS SECURITY
//*                R = RACF RESOURCE ACCESS SECURITY
//*                C = RACF RESOURCE ACCESS SECURITY
//*                A = RACF RESOURCE ACCESS SECURITY
//*   ARMRST X     Y = ALLOW MVS ARM TO RESTART
//*                N = ARM NOT RESTART IMS
//*   RRS     X    Y = ENABLE PROT CONV SUPPORT
//*                N = DISABLE PROT CONV SUPPORT
//*   IRLM   X     Y = YES, N = NO
//*   IRLMNM XXXX  IRLM SUBSYSTEM NAME
//*   SSM    XXXX  EXT SUBSYSTEM PROCLIB MEMBER ID

//*   UHASH  XXXXXXXX USER HASH MODULE NAME
//*   DBRCNM XXXXXXXX DBRC PROCLIB MEMBER NAME
//*   DLINM  XXXXXXXX DL/I PROCLIB MEMBER NAME
//*   PRDR   XXXXXXXX IMSRDR PROCLIB MEMBER NAME
//*   DBRSE  XXXXXXXX 8 CHAR DBCTL RSENAME
//*   CRC    X     COMMAND RECOGNITION CHARACTER
//*   CMDMCS X     COMMAND SECURITY OPTION
//*                R=RACF COMMAND SECURITY
//*                C=DFSCCMD0 COMMAND SECURITY
//*                B=RACF AND DFSCCMD0 CMD SEC
//*   PREMSG X     PREFIX MESSAGE OPTION
//*                N=NO DFS000I PREFIX
//*                Y=DEFAULT, DFS000I PREFIX
//*   PIMAX  XXXXXX ENQ/DEQ POOL MAXIMUM BYTES
//*   PIINCR XXXXXX ENQ/DEQ POOL INCREMENT
//*   AOIS    X     ICMD SECURITY OPTION
//*   PSWDC   X     PASSWORD CASE
//*                 U=UPPER CASE
//*                 M=MIXED CASE
//*                 R=USES RACF SETTING (DEFAULT)
//*   YEAR4   X     N = 2-DIGIT DATE (DEFAULT)
//*                 Y = 4-DIGIT DATE
//*   CPLOG   XXXXXK CHECKPOINT LOG INTERVAL
//*           OR
//*   CPLOG   XXM    CHECKPOINT LOG INTERVAL
//*   IMSGROUP XXXX  4 CHAR USER SPEC NAME
//*   DESC    XX    MSG DESC CODE
//*   MCS     (XX,XX) MSG ROUTE CODES
//*   SVC2    XXX   TYPE 2 SVC NUMBER
//*   CCTCVCAN X    Y = CCTL CANCEL WILL BE CONVERTED
//*                     TO ABEND SYSTEM 08E
//*                 N = CCTL CANCEL IS NOT CONVERTED
//*
//******** FDR PARAMETER *****************************
//*
//*   FDRMBR  XX    SUFFIX FOR FDR MEMBER IN
//*                 IMS.PROCLIB
//*
//******** FAST PATH PARAMETERS ********
//*
//*   BSIZ   XXX   DATA BASE BUFFER SIZE
//*   OTHR   XXX   NUMBER OF OUTPUT THREADS
//*   DBFX   XXX   SYSTEM ALLOCATION OF DATA BASE BUFFERS TO BE
//*                FIXED AT START OF 1ST FAST PATH DEP REGION
//*   DBBF   XXX   NUMBER OF DATABASE BUFFERS
//*   DBFP   XXXX  PAGE FIX/FREE ADJUST TIMER
//*                0: FIX/FREE AT SCHED/TERM
//*                1: ALLOW PAGEFIX ONLY
//*                2-3600: SEC PAGEFREE FREQ
//*   LGNR   XX    NUMBER OF LOG ENTRIES IN DEDB BUFFERHEADER
//*   SVSODR XXXX  SVSO DISASTER RECOVERY OPTIONS
//*                NONE: DEFAULT. NO CHANGE TO ERE.
//*                AUTO: AREA MARKED RECOV NEEDED IF
//*
//*                DRRS: AREA MARKED RECOV NEEDED AT
//*
//*                WTOR: USER OPTION TO MARK AREAS
//*
//*   DMHVF  XX    MEGS TO FIX PAGEFIX FOR VSO ERE DATASPACE
//*   FPOPN   X    PREOPEN/REOPEN OPTIONS FOR DEDBS
//*                N: DEFAULT. PREOPEN OF DEDB AREAS
//*                   DONE BEFORE IMS RESTART
//*                   COMPLETES
//*                R: REOPEN AREAS OPENED WHEN IMS
//*                   ABNORMALLY TERMINATED.  BEHAVE
//*                   LIKE OPTION P FOR NON /ERE
//*                P: PREOPEN OF DEDB AREA
//*                   INITIATED AT THE END OF
//*                   RESTART
//*                A: OPTION R AND P COMBINED
//*   FPRLM   X    DEDB OPTIONS FOR IRLM RECONNECT
//*                N: DEFAULT. NO ACTION TAKEN
//*                S: RESTART ALL DEDB AREAS WHICH
//*                   WERE STARTED WHEN IRLM
//*                   DISCONNECTED
//*                R: RESTART AND REOPEN ALL DEDB
//*                   AREAS WHICH WERE STARTED WHEN
//*                   IRLM DISCONNECTED
//*                P: PREOPEN OF DEDB AREA
//*                   INITIATED AT THE END OF
//*                   IRLM RECONNECT
//*                A: COMBINE OPTIONS R AND P
//*   FP      X    INCLUDE FASTPATH IN THIS IMS
//*                N: THE DEFAULT.  THIS IMS DOES
//*                   NOT INCLUDE FASTPATH
//*                Y: THIS IMS INCLUDES FASTPATH

//******** STORAGE POOL VALUES IN K, M OR G ******
//*   DMB    XXXXXX DMB POOL SIZE
//*   CIOP   XXXXXX CIOP POOL UPPER LIMIT
//*   WKAP   XXXXXX WORKING STORAGE BUFFER POOL SIZE
//*   PSBW   XXXXXX PSB WORK POOL SIZE
//*   DBWP   XXXXXX DATABASE WORK POOL SIZE
//*   CSAPSB XXXXXX DLISAS: CSA PSB POOL SIZE
//*   DLIPSB XXXXXX DLISAS: DLI PSB POOL SIZE
//*   EPCB   XXXXXX EPCB POOL SIZE
//*   FPWP   XXXXXX FP WORK POOL UPPER LIMIT
//*   AOIP   XXXXXX AOI POOL UPPER LIMIT
//*   CMDP   XXXXXX CMDP POOL UPPER LIMIT
//*
//******** MEMBER SUFFIXES **********************
//*
//*   SUF    X     LAST CHARACTER OF CTL PROGRAM LOAD
//*                MODULE MEMBER NAME
//*   FIX    XX    2 CHARACTER FIX PROCEDURE MODULE SUFFIX
//*   PRLD   XX    2 CHARACTER PROCLIB MEMBER SUFFIX FOR PRELOAD
//*   VSPEC  XX    2 CHARACTER BUFFER POOL SPEC MODULE SUFFIX
//*   SPM    XX    STORAGE POOL OPTIONS (DFSSPMXX)
//*   CSLG   XXX   CSL GLOBAL MEMBER (DFSCGXXX)
//*   DFSDF  XXX   DRD, CSL, AND SQ MEMBER (DFSDFXXX)
//***********************************************
//*
//STEPLIB  DD DSN=IMS.&SYS2.SDFSRESL,DISP=SHR
//PROCLIB  DD DSN=IMS.&SYS2.PROCLIB,DISP=SHR
//*
//***************************************************
//* IN ORDER TO START A DEPENDENT REGION, MODIFIED
//* START-UP JCL IS WRITTEN FROM INTERNAL STORAGE TO
//* THE INTERNAL READER.
//*
//IMSIRD   DD SYSOUT=(A,INTRDR)

//*********** IMSMON  DD  CARDS  *****************
//*
//* THE IMSMON DD STATEMENT MUST BE REMOVED IF
//* THIS DATA SET IS TO BE DYNAMICALLY ALLOCATED.
//* THE IMSACBA AND IMSACBB DD STATEMENTS MUST BE
//* REMOVED IF YOU WISH TO DYNAMICALLY ALLOCATE THE
//* ACBLIB DATA SETS THROUGH THE DFSMDA MEMBER.
//*
//IMSMON   DD DSN=IMS.&SYS1.IMSMON,DISP=(,KEEP),
//         VOL=(,,,99),UNIT=(&LOGT,,DEFER)
//*
//IMSACBA  DD DSN=IMS.&SYS2.ACBLIBA,DISP=SHR
//IMSACBB  DD DSN=IMS.&SYS2.ACBLIBB,DISP=SHR
//MODBLKSA DD DSN=IMS.&SYS2.MODBLKSA,DISP=SHR
//MODBLKSB DD DSN=IMS.&SYS2.MODBLKSB,DISP=SHR
//MODSTAT  DD DSN=IMS.&SYS.MODSTAT,DISP=SHR
//******** SYSTEM REQUIRED DD CARDS **************
//*
//SYSUDUMP DD SYSOUT=&SOUT,
//         DCB=(LRECL=125,RECFM=FBA,BLKSIZE=3129),
//         SPACE=(6050,300,,,ROUND)
//IMSRDS   DD DSN=IMS.&SYS.RDS,DISP=SHR
//PRINTDD  DD SYSOUT=&SOUT
//*
//****** EXTERNAL SUBSYSTEM DD CARDS  ***********
//*
//* USER MAY OPTIONALLY ADD THE DFSESL DD CARD
//* FOR EXTERNAL SUBSYSTEM CONNECTION.
//*
//************ DATA BASE DD CARDS ***************
//*
//* USER MAY OPTIONALLY SUPPLY THE DD STATEMENTS
//* FOR THE ON-LINE DATA BASES TO BE
//* INSERTED HERE PRIOR TO ATTEMPTING
//* AN ON-LINE SYSTEM EXECUTION USING
//* THIS PROCEDURE.
//* IF NO DD STATEMENTS ARE SUPPLIED FOR
//* A DATA BASE, IMS ASSUMES THAT THIS
//* DATA BASE HAS BEEN DESCRIBED THROUGH
//* THE DFSMDA MACRO.
//* IF THE USER WILL BE EXECUTING WITH THE DL/I
//* SAS OPTION, THESE DD STATEMENTS SHOULD BE ADDED
//* TO THE DLISAS PROCLIB MEMBER OR DESCRIBED
//* THROUGH THE DFSMDA MACRO.

Usage

Si des bases de données DL/I sont utilisées, un membre DFSVSMxx est généré dans le fichier IMS PROCLIB. Voir IMS.

Les zones de la base de données DEDB doivent être allouées dans la région de contrôle DBCTL. L'une des situations suivantes doit se produire:

  • Les instructions de définition de données doivent se trouver dans le JCL de la région de contrôle.
  • Les membres d'allocation dynamique doivent se trouver dans une bibliothèque, comme indiqué par JOBLIB et STEPLIB.

Si vous définissez vos ressources de manière dynamique, les instructions de définition de données pour les fichiers MODBLKS ne sont plus nécessaires.

Les paramètres d'exécution DBCTL peuvent être spécifiés dans l'instruction DBC EXECUTE, dans la procédure DBC ou dans le membre par défaut DFSPBDBC, ou les valeurs par défaut de paramètre spécifiées lors de la définition du système peuvent être utilisées.

Paramètres

Les paramètres suivants sont des paramètres de substitution JCL et peuvent être utilisés dans la procédure de démarrage de la région de contrôle IMS :
  • DPRTY=
  • RGN=
  • RGSUF =
  • SOUT=
  • SYS1=
  • SYS2=
  • SYS=

Les paramètres suivants sont valables pour la procédure DBC et pour le membre DFSPBxxx de l'ensemble de données IMS PROCLIB.

AOIP= à FDRMBR= FIX= à PREMSG= PRLD= vers YEAR4
  • AOIP=
  • AOIS=
  • RRMRST =
  • AUTO=
  • BSIZ=
  • CCTCVCAN=
  • COP=
  • CMDMCS=
  • CRC=
  • CSAPSB=
  • GCS=
  • DBBF=
  • FPBD =
  • DBFX =
  • DBRCNM=
  • DBRSE =
  • DBWP =
  • DESC=
  • DFSDF=
  • DLINM=
  • DLIPSB=
  • DMB=
  • DMHVF =
  • EPCB =
  • FDRMBR=
  • FIX=
  • FMTO=
  • FP=
  • FPOPN=
  • FPRLM =
  • FPWP =
  • IMSGROUP=
  • IMSID=
  • IOVF =
  • IRLM=
  • IRLMNM=
  • ISIS=
  • LNR=
  • MAXPST =
  • MCS =
  • NODE1=
  • NODE2=
  • ODBASE=
  • ORSMBR=
  • OTHR =
  • PIINCR=
  • PIMAX=
  • PRDR =
  • PREMSG=
  • LDPR =
  • PSBB =
  • PST =
  • PSWDC=
  • RCLASS=
  • RDS=
  • RES=
  • RRS=
  • SPM =
  • RCRS =
  • SSM=
  • FSN =
  • SVC2=
  • SVSODR=
  • TSR=
  • HACHAGE =
  • VSPEC=
  • WKAP=
  • YEAR4=

Voir les descriptions des paramètres pour les procédures IMS pour les descriptions.

instructions de définition de données

Les instructions de définition de données suivantes sont valides pour la procédure DBC.

En plus des instructions de définition de données suivantes, ajoutez des instructions pour les fichiers représentant les bases de données IMS qui ne doivent pas être allouées de manière dynamique.

Voir les déclarations DD pour les procédures IMS pour la description des déclarations DD.

  • DFSESL DD (facultatif)
  • DFSOLPnn DD
  • DFSOLSNnn DD
  • DD DFSWADSn
  • Définition de données IMSACBA
  • Définition de données IMSACBB
  • IMSDALIB DD (facultatif)
  • Définition de données IMSIRD
  • Définition de données IMSMON
  • Définition de données IMSRDS
  • MODBLKSA DD
  • MODBLKSB DD
  • DD MODSTAT
  • DD PRINTDD
  • PROCLIB DD
  • RECON1 DD (facultatif)
  • RECON2 DD (facultatif)
  • RECON3 DD (facultatif)
  • DD STEPLIB
  • SYSUDUMP DD
Important :
  • Si vous définissez vos ressources de manière dynamique, les instructions de définition de données pour les fichiers MODBLKS (MODBLKSA DD et MODBLKSB DD) ne sont plus requises.
  • IMSACBA DD et IMSACBB DD doivent être supprimés si vous souhaitez allouer dynamiquement les fichiers ACBLIB via le membre DFSMDA.
  • Dans l'exemple de procédure DBC construit pendant le traitement de SMP/E et placé dans les ensembles de données des bibliothèques ADFSPROC et SDFSPROC, l'instruction IMSMON DD est incluse en tant que commentaire. Pour utiliser l'instruction de définition de données IMSMON, supprimez les astérisques (*).

Restrictions

La procédure DBC est utilisée en l'état pour les deux régions dans une configuration de secours DBCTL.