Use this command to define a unique data store (DS) or to define the
attributes of a new data definition (DD) for a specific data store.
Requirements and Restrictions
- You must initialize TPF collection support (TPFCS) before you
enter this command.
- A data store definition is systemwide. Data stores are
not subsystem unique. Therefore, the data store name
must be unique across the TPF system complex if you specify the DS
parameter.
- If you specify the DD parameter, the target data store must be
defined.
- The TPF system must have get file storage (GFS) pools enabled
before you can use this message. Pools are not enabled until the system
is cycled to CRAS state or above.
Format
- DS
- defines a data store.
- dsname
- is the 1- to 8-character name of the data store.
- DD
- defines a data definition.
- ddname
- is the 1- to 32-character name of the data definition.
- INVENTORY
- specifies that a collection inventory will be maintained for this data
store. TPFCS will add the persistent identifier (PID) of every
collection created for this data store to this inventory when the collection
is created.
- NOINVENTORY
- specifies that no collection inventory will be maintained for this data
store.
- DELETE
- determines the disposition of deleted collections, where:
- DELAY
- specifies that a deleted collection will be added to a data store
collection and will not be deleted from the system for 48 hours. The
collection can be reclaimed during the 48-hour interval.
- IMMED
- specifies that a deleted collection will be immediately returned to the
system. The collection cannot be reclaimed.
- NOSHADOW
- specifies that shadowing will not be used for this collection.
- SHADOW
- specifies the use of shadowing for this collection.
- TEMP
- defines a temporary collection. Any record IDs specified must be
for a short-term pool file.
- DATARID
- defines the record ID for the data records.
- Note:
- The ID must be defined in the record ID attribute table
(RIAT).
- recordid
- is a 4-character hexadecimal record ID.
- DIRECTRID
- defines the record ID for the internal directory record.
- Note:
- The ID must be defined in the RIAT.
- INDEXRID
- defines the record ID for the internal index record.
- Note:
- The ID must be defined in the RIAT.
- FORCE
- forces TPF collection support to start building the collection using an
extended structure rather than the normal compact structure.
- NOFORCE
- builds the collection with the normal compact structure.
Additional Information
None.
Examples
The BANK1_DS data store (DS) is defined in the following example to have an
inventory and delayed deletes.
+--------------------------------------------------------------------------------+
|User: ZOODB DEF DS BANK1_DS |
| |
|System: OODB0012I 11.55.40 DATA STORE BANK1_DS DEFINED |
| OODB0011I 11.55.40 REQUEST COMPLETED FOR DS BANK1_DS |
+--------------------------------------------------------------------------------+
The BATCHWRK data store is defined in the following example to have no
inventory and delayed deletes.
+--------------------------------------------------------------------------------+
|User: ZOODB DEF DS BATCHWRK NOINVENTORY DELETE-IMMED |
| |
|System: OODB0012I 11.55.40 DATA STORE BATCHWRK DEFINED |
| OODB0011I 11.55.40 REQUEST COMPLETED FOR DS BATCHWRK |
+--------------------------------------------------------------------------------+
The CUSTOMER_INDEX data definition is defined in the following
example.
+--------------------------------------------------------------------------------+
|User: ZOODB DEF DD CUSTOMER_INDEX DS-BANK1_DS DATARID-FC00 DIRECTRID-FC01 |
| |
|System: OODB0007I 08.25.23 DD CUSTOMER_INDEX DEFINED |
| OODB0006I 08.25.23 REQUEST COMPLETED FOR DD CUSTOMER_INDEX |
+--------------------------------------------------------------------------------+
Related Information