Commands

The first DEFINE command defines a VSAM alternate index over the base cluster EXAMPL1.KSDS.

Parameter	Purpose
NAME	NAME is required and names the object being defined.
RELATE	RELATE is required and specifies the name of the base cluster on which the alternate index is defined.
MASTERPW and UPDATEPW	Specifies the master and update passwords, respectively, for the alternate index.
KEYS	Specifies the length of the alternate key and its offset in the base-cluster record.
RECORDSIZE	Specifies the length of the alternate-index record. The average and maximum record lengths are 40 and 50 bytes, respectively. Because the alternate index is being defined with the NONUNIQUEKEY attribute, the index must be large enough to contain the primary keys for all occurrences of any one alternate key.
VOLUMES	VOLUMES is required only for non-system-managed data sets and specifies the volume that contains the alternate index (EXAMPL1.AIX).
CYLINDERS	Specifies the amount of space allocated to the alternate index. A space parameter is required.
NONUNIQUEKEY	Specifies that the base cluster can contain multiple occurrences of any one alternate key.
UPGRADE	Specifies that the alternate index is to reflect all changes made to the base-cluster records, such as additions or deletions of records.
CATALOG	Because the master catalog is password protected, the CATALOG parameter is required. It specifies the name of the master catalog and its update or master password, which is required for defining in a protected catalog.

The second DEFINE command defines a path over the alternate index. After the alternate index is built, opening with the path name causes processing of the base cluster through the alternate index.

Parameter	Purpose
NAME	The NAME parameter is required and names the object being defined.
PATHENTRY	The PATHENTRY parameter is required and specifies the name of the alternate index over which the path is defined and its master password.
READPW	Specifies a read password for the path; it is propagated to the master-password level.
CATALOG	The CATALOG parameter is required, because the master catalog is password protected. It specifies the name of the master catalog and its update or master password that is required for defining in a protected catalog.

The BLDINDEX command builds an alternate index. Assume that enough virtual storage is available to perform an internal sort. However, DD statements with the default ddnames of IDCUT1 and IDCUT2 are provided for two external sort work data sets if the assumption is incorrect and an external sort must be performed.

Parameter	Purpose
INDATASET	The INDATASET parameter identifies the base cluster. Access method services dynamically allocates the base cluster. The base cluster's cluster entry is not password protected even though its data and index components are.
OUTDATASET	The OUTDATASET parameter identifies the alternate index. Access method services dynamically allocates the alternate index. The update- or higher-level password of the alternate index is required.
CATALOG	The CATALOG parameter specifies the name of the master catalog. If it is necessary for BLDINDEX to use external sort work data sets, they will be defined in and deleted from the master catalog. The master password permits these actions.

The PRINT command causes the base cluster to be printed using the alternate key, using the path defined to create this relationship. The INDATASET parameter identifies the path object. Access method services dynamically allocates the path. The read password of the path is required.