Defining an IAM path
The process of defining a PATH to an IAM Alternate Index or base cluster is essentially the same as with VSAM. IAM will automatically determine if the PATHENTRY is an IAM data set, so use of the OWNER($IAM) parameter is optional. AnIAM path is a one-track data set. The allocation request will be made for the same volume on which the path entry data set resides. If the path entry data set is DFSMS managed, the path data set will be allocated with the same SMS classes as the path entry data set. IAM uses the one track data set to store information about the relationship of the path to its Alternate Index or base cluster, rather than using a catalog entry. The IAM path data set does not have to be on the same volume with the related data set, although IAM attempts to place it there.
IDCAMS define path
IDCAMS can be used to define a path. On the DEFINE PATH command, the PATHENTRY keyword indicates the related data set. To access a base cluster through an Alternate Index, the PATHENTRY will be the name of the Alternate Index. The attribute UPDATE (or NOUPDATE) indicates whether the upgrade set of the Alternate Indexes will also be opened. The upgrade set includes all Alternate Indexes defined with the UPGRADE attribute.
If only the base cluster is being opened for update, any upgradeable Alternate Index data sets will also be opened. To prevent Alternate Index upgrades, define a PATH for the base cluster with the NOUPDATE attribute.
An example of defining an IAM PATH with IDCAMS is shown below.
Example of using IDCAMS to define a path (EX1063A)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE PATH -
(NAME(example.iam.path) -
PATHENTRY(example.iam.aix) -
UPDATE )
/*
IAM ISPF define path
If you have the IAM ISPF panels installed, they also provide a Define Path function. Starting at the IAM Primary Options menu, as shown below, select option I to define an IAM data set then enter the name of the path that you want to define, and indicate a P for data set type, indicating a path. An example of the completed panel is shown below.
IAM ISPF define of a path
OPTION ===> i
I - Allocate (DEFINE) a new IAM Dataset Ver 11.0.00
V - Allocate (DEFINE) a new VSAM Cluster
D - Delete a Dataset, Cluster, Path, or Alternate Index
C - Copy an IAM Dataset, VSAM KSDS, or VSAM ESDS
M - Move an IAM Dataset, VSAM KSDS, or VSAM ESDS
R - Rename a Dataset, Cluster, Path, or Alternate Index
U - Invoke an IAM Utility program
blank - Display IAM Dataset or VSAM Cluster Information
Enter dataset name (required for all options except U)
Dataset Name ===> 'CPPRAC.ENCRYPT3.PATH3
Dataset Type ===> P C=Cluster X=AIX P=Path (options I, V Only)
Enter Model or New dsname (optional for options I and V, required for option R)
Model|Newname ===>
Delete Confirmation ===> YES Yes|No
View IDCAMS statements ===> NO Yes|No|Only
After pressing ENTER, IAM will display the IAM Define Path panel as shown below. On this panel, enter the fully qualified name of the path entry data set, which is either an Alternate Index or a base cluster. Also enter whether or not the upgrade set is to be opened if the path is opened for update. While a specification of NO will eliminate the overhead of updating all of the Alternate Indexes in the upgrade set, the Alternate Indexes will not properly reflect the contents of the base cluster.
IAM ISPF define an IAM path panel
COMMAND ===>
Path Name ===> CPPRAC.ENCRYPT3.PATH3
Path Entry ===> CPPRAC.ENCRYPT3.CLUSTER3
Update ===> YES Yes = Open all UPGRADE sets when PATH opens
No = Open only BASE CLUSTER when PATH opens
Recatalog ===> NO
RETENTION
Days ===> 0-9999
Expiration Date ===> YYYY.DDD
After pressing ENTER, IAM will return to the IAM Primary Options panel, with a message in the upper right hand corner indicating that the path was successfully allocated. To display the attributes of the Path, press ENTER again, with the Path name in the data set name field.
IAM path display
The IAM Path Characteristics panel displays basic information about the actual data record that would be retrieved from the base cluster through this path. Because the IAM Path data set is an actual one track data set, volser and device type information is displayed. At the bottom are the associations indicating the data sets related to this path.
IAM path characteristics panel
COMMAND ===>
Dataset Name: CPPRAC.ENCRYPT3.CLUSTER3.PATH
More: +
Definition Allocation
Record Length: 100 Volume: DCS101
Record Format: VARIABLE Device Type: 3390
Key Length/Offset: 5 / 5 Tracks in use: 0
Spanned Recs: NO Block Size: 13682
Dataset Type: KSDS Blocking Factor: 300
Share Option: 2 Alloc Type: TRACKS
Release: YES Primary Alloc: 1
Storage Class: SMSPOOL Secondary Alloc: 1
Data Class: Compressed Keys: NO
Mgmt Class: MIG14 Compressed Data: NO
IAM File Format LARGE IAM Format: ENHANCED
Keylabel:
Statistics Extended Area
Creation: 2023.032 Overflow Records: 0
Expiration: 0000.000 Blocks Allocated: 0
Last Reference: 2023.019 Blocks Used: 0
Records: 0 Overflow Blocks: 0
Deletes: 0 PE Blocks: 0
Inserts: 0 Blocks Available: 0
Updates: 0 Variable Overflow: YES
Minimum Buffers:
Maximum Buffers: Other Information
Defined RLSID:
EATTR: OPT
Associations
CLUSTER-CPPRAC.ENCRYPT3.CLUSTER3
PATH-CPPRAC.ENCRYPT3.CLUSTER3.PATH