NOTIFY: Notify CICS VR when a VSAM sphere backup is created

This command notifies CICS® VR when a backup for a VSAM sphere is created by an IBM® or non-IBM product.

Format

Read syntax diagramSkip visual syntax diagram
>>-NOTIFY--DSNAME(dsname)--BACKUPNAME(backupname)--------------->

>--PRODUCT(product)--+-------------------------+---------------->
                     '-PREALLOC--(--+-NO--+--)-'   
                                    '-YES-'        

>--+-----------------------------------------------+-----------><
   '-BACKUPTIME--(--date and time--,--+-GMT---+--)-'   
                                      '-LOCAL-'        

This command is used when any backup of a VSAM sphere is created by an IBM or non-IBM product. CICS VR registers information about the backup in the CICS VR RCDS. The information about the backup can then the seen through the CICS VR panel interface.

Keywords

DSNAME(dsname)
Specifies the fully qualified base cluster name of the VSAM data set that the backup was created for. DSNAME is a required keyword. Only one DSNAME keyword can be specified in a NOTIFY command.
dsname
Specifies the name of the VSAM data set using EBCDIC character data. The name is from 1 to 44 characters in length.
BACKUPNAME(backupname)
Specifies the fully qualified name of the VSAM data set backup. BACKUPNAME is a required keyword. Only one BACKUPNAME keyword can be specified in a NOTIFY command.
backupname
Specifies the name of the VSAM data set backup using EBCDIC character data. The name is from 1 to 44 characters in length.
PRODUCT(product)
Identifies the product that created the VSAM data set backup. PRODUCT is a required keyword. Only one PRODUCT keyword can be specified in a NOTIFY command.
product
Identifies the product with a five character "product identifier". CICS VR uses this as a reference for working with the backup. The name identifier is five characters in length, and cannot contain blanks.
BACKUPTIME(date and time,LOCAL|GMT)
Identifies the date and time of backup. BACKUPTIME is an optional parameter.
date and time
This must be in the format yyyy/ddd/hh/mm/ss, where:
yyyy
A four digit year number, for example 2006.
ddd
The day of the year, in the range 001 to 366.
hh
The hour of the day, in the range 00 to 23.
mm
The number of minutes, in the range 00 to 59.
ss
The number of seconds, in the range 00 to 59.
The values can be separated with a slash (/), period (.), or colon (:) character. You can omit the separator character. An example is: BACKUPTIME(2001.159/01:23:00)
LOCAL
Specifies that the date and time are in local format.
GMT
Specifies that the date and time are given in Greenwich Mean Time (GMT) format. GMT is the default value.
PREALLOC(YES|NO
Specifies if the product that created the backup preallocated the target data set at the time of the restore. PREALLOC is an optional parameter.
YES
The product that created the backup does not preallocate the target data set at the time of the restore. CICS VR extracts information from the ICF catalog about the allocation attributes of the data set, and register this information in the RCDS. At restore time, CICS VR uses the registered information to create a restore job which includes a step to preallocate the target data set.
NO
The product that created the backup preallocates the target data set at the time of the restore. At restore time, CICS VR creates a restore job which does not include a step to preallocate the target data set.

Synonyms

The "Synonyms for NOTIFY commands or keywords" table shows the acceptable synonyms that can be used in place of the NOTIFY commands or keywords:
Table 1. Synonyms for NOTIFY commands or keywords
Keyword Synonyms
BACKUPNAME BACKUP, BN
BACKUPTIME BTIME, TIME
DSNAME NAME, DSN
PREALLOC ALLOC
PRODUCT PROD

Usage notes

  1. DFSMShsm and DFSMSdss can automatically notify CICS VR when a logical backup has been created. There is no need to use the NOTIFY command for logical backups created by either DFSMShsm or DFSMSdss.
  2. The DWWNT program can be added to the backup job as a job step that is run when the backup completes successfully. You must set the data set disposition to OLD in such a backup job, to avoid any data set updates.
  3. For an explanation of the return and reason codes returned from the DWWNT program, refer to Return and reason codes.

Example 1

//TESTNTFY  JOB  ,CICSVR,MSGLEVEL=(1,1),MSGCLASS=H,REGION=6144K
//*-------------------------------------------------------------------*/
//* CREATE BACKUP USING REPRO                            */
//*-------------------------------------------------------------------*/
//STEP1     EXEC PGM=IDCAMS
//IN            DD DSN=AAAAAAAA.BBBBBBBB.CCCCCCCC,DISP=OLD
//OUT        DD DSN=AAAAAAAA.BBBBBBBB.CCCCCCCC.BACKUP,DISP=OLD
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
     REPRO INFILE(IN)
           OUTFILE(OUT)
/*
//*------ -----------------------------------------------------------------*/
//* RUN NOTIFY UTILITY                                                     */
//*------------------------------------------------------------------------*/
//STEP2      EXEC PGM=DWWNT
//DWWMSG   DD SYSOUT=*
//DWWPRINT DD SYSOUT=*
//DWWIN    DD *
     NOTIFY  DSNAME(AAAAAAAA.BBBBBBBB.CCCCCCCC)  -
                     BACKUPNAME(AAAAAAAA.BBBBBBBB.CCCCCCCC.BACKUP)  -
                     PRODUCT(REPRO)
//

Example 2

You can specify any keyword as the input parameter. In this example, the DSNAME keyword is specified in the EXEC statement as an input parameter.

//TESTNTFY  JOB  ,CICSVR,MSGLEVEL=(1,1),MSGCLASS=H,REGION=6144K
//*-------------------------------------------------------------------*/
//* CREATE BACKUP USING REPRO                            */
//*-------------------------------------------------------------------*/
//STEP1     EXEC PGM=IDCAMS
//IN            DD DSN=AAAAAAAA.BBBBBBBB.CCCCCCCC,DISP=OLD
//OUT        DD DSN=AAAAAAAA.BBBBBBBB.CCCCCCCC.BACKUP,DISP=OLD
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
     REPRO INFILE(IN)
           OUTFILE(OUT)
/*
//*------ -----------------------------------------------------------------*/
//* RUN NOTIFY UTILITY                                                     */
//*------------------------------------------------------------------------*/
//STEP1      EXEC PGM=DWWNT,PARM='DSNAME(AAAAAAAA. BBBBBBBB.CCCCCCCC)'
//DWWMSG   DD SYSOUT=*
//DWWPRINT DD SYSOUT=*
//DWWIN    DD *
     NOTIFY  BACKUPNAME(AAAAAAAA.BBBBBBBB.CCCCCCCC.BACKUP)  -
                     PRODUCT(REPRO)
//