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

>>-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 keywordsKeyword |
Synonyms |
BACKUPNAME |
BACKUP, BN |
BACKUPTIME |
BTIME, TIME |
DSNAME |
NAME, DSN |
PREALLOC |
ALLOC |
PRODUCT |
PROD |
Usage notes
- 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.
- 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.
- 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)
//