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.
The REXX procedure DWWBKNT is shipped in SDWWCNTL as
an example of how to perform multiple calls of the NOTIFY utility
for IDCAMS REPRO backups. See, DWWBKNT REXX for
more information.
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)
//