INSTALL STAMPS

The INSTALL STAMPS utility stores synchronization stamps in an area of an SQL-defined database that was reformatted by file.
idmscu19
The INSTALL STAMPS utility stores synchronization stamps in an area of an SQL-defined database that was reformatted by file.
This article describes the following information:
2
2
Authorization 
To install stamps for an area, you need DBAWRITE access on the area. 
Syntax
  ►►─── INSTALL STAMPS INTO ┬─ AREA ── segment-name.area-name ┬─────────────────►                           └─ SEGMENT segment-name ──────────┘  ►───┬─────────────┬──────────────────────────────────────────────────────────►◄      ├─ INITIAL ◄──┤      └─ REPLACE ───┘  
Parameters
  • AREA
    Directs the INSTALL STAMPS utility to install synchronization stamps in an area.
  • segment-name
    Specifies the name of the segment containing the area.
  • area-name
    Specifies the name of the area.
  • SEGMENT
    Specifies the segment whose areas will have their stamps installed.
  • segment-name
    Specifies the name of a segment included in the DMCL module.
  • INITIAL
    Specifies that the area(s) contain no synchronization stamps because they were formatted using the file or segment option of the FORMAT utility statement executing in local mode. INITIAL is the default.
  • REPLACE
    Specifies that the area(s) contain synchronization stamps that should be replaced with those from the catalog.
Usage
How to submit the INSTALL STAMPS statement
You submit the INSTALL STAMPS statement using either the batch command facility or the online command facility.
When to use INSTALL STAMPS
Use the INSTALL STAMPS utility only if the area was reformatted using the file option of the FORMAT utility statement.
When not to use INSTALL STAMPS
If you have used the area or segment option of the FORMAT utility to initialize the area, do not run the INSTALL STAMPS utility. The synchronization stamps have already been installed.
Do not use the INSTALL STAMPS utility on areas of non-SQL-defined databases.
Use caution when replacing stamps
By replacing stamps in an area, you are asserting that the catalog's definition accurately describes data in the area. You should be sure that this is true or that the area contains no data before replacing stamp values. No data validation is performed by the utility.
JCL Considerations
When you submit an INSTALL STAMPS statement through the batch command facility in local mode, the JCL to execute the facility must include statements to define the following:
  • File(s) that map to the area to be processed
  • Dictionary that defines the table(s) in the area
  • Journal file(s) if backups are not taken
To run under central version, a SYSCTL statement is needed.
Examples
The following example directs the INSTALL STAMPS utility to store synchronization stamps in the EMPLDEMO.EMPLAREA area.
install stamps into area empldemo.emplarea;
Sample Output
After successfully storing synchronization stamps in the EMPLDEMO.EMPLAREA area, the following listing is generated.
IDMSBCF                                              IDMS Batch Command Facility                            mm/dd/yy   PAGE 1 CONNECT TO SQLDEMO; Status = 0 FORMAT FILE EMPLDEMO.EMPF1; File EMPLDEMO.EMPF1                blocks 1 to 50. Area EMPLDEMO.EMPLAREA             pages 5,001 to 5,050. Page size in file 4,096. Status = 0 INSTALL STAMPS INTO AREA EMPLDEMO.EMPLAREA ; Status = 0 AutoCommit will COMMIT transaction Command Facility ended with no errors or warnings