To create a generation data group (GDG), first create its catalog by using the gdgmgr command with the -c flag. (A GDG catalog is a binary file in the AIX native file system; a GDG catalog name is of the form gdgBaseName.catalogue.)
You then populate the GDG with generation files typically by running COBOL programs that create the files.
In the AIX native file system:
To create a GDG catalog in the NAT (native), RSD, SdU, or STL file system, use the gdgmgr command with the -c flag. For example, to create catalog ./myGroups/transactionGroup.catalogue, you can issue this command:
gdgmgr -c ./myGroups/transactionGroup
The catalog is created by default in the current working directory (./). You can optionally precede the catalog name in the gdgmgr command with a path name, as shown above. The catalog and the generation files must be created in the same directory.
In the SFS file system:
To create a GDG catalog in the SFS file system, use the gdgmgr command with the -c flag. You can specify the SFS file name in either a fully qualified form or an abbreviated form. For example, the following command creates a GDG catalog using a fully qualified SFS name:
gdgmgr -c /.:/cics/sfs/sfsServer/baseName
You can instead specify an abbreviated form of the SFS file name by first setting environment variable CICS_TK_SFS_SERVER, and then issuing the gdgmgr command using also the -F flag to specify the SFS file system. For example:
export CICS_TK_SFS_SERVER=/.:/cics/sfs/sfsServer gdgmgr -F SFS -c baseName
To override the default GDG home directory (~/gdg) for SFS groups, set environment variable gdg_home. For example, the following commands create a GDG catalog ~/groups/forSFS/sfs/sfsServer/myGroup.catalogue:
export gdg_home=~/groups/forSFS gdgmgr -c /.:/cics/sfs/sfsServer/myGroup
All SFS generation files in a given group must be on the same SFS server.
In the DB2 file system:
For example, the following commands create catalog ~/gdg/db2/db2inst1/database/cics.dbGroup.catalogue:
. /home/db2inst1/sqllib/db2profile export DB2DBDFT=database gdgmgr -F DB2 -c cics.dbGroup
The home directory for a GDG catalog for DB2 files is taken from environment variable $gdg_home or else defaults to ~/gdg.
All generation files in a generation data group must be in one database under one schema.
related concepts
File systems
Generation data groups
related references
Limit processing of generation data groups