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

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

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 procedure 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)
//