A1 - Alias record type 1

An Alias Record Type 1 (A1) is created for each symbolic link associated with a hierarchical file system element and for each symbolic link associated with a load module within a UNIX file system that is processed during APPLY or RESTORE processing. For hierarchical file system elements, the symbolic link names are placed in the records. For load modules, values from the ALIAS (SYMLINK,symlink) control statements are placed in the records.

Multiple A1 records may be produced for the same hierarchical file system element or load module, because more than one symbolic link can exist for the same hierarchical file system element or load module.

The purpose of the A1 record is to identify the symbolic links associated with the changed hierarchical file system elements and the symbolic links associated with load modules processed with this execution of the APPLY or RESTORE command.

The format and contents of this record type are shown in Table 1.

Table 1. Alias record type 1
Field name	Position (decimal)	Length (decimal)	Description
Record type	1	2	The characters 'A1'.
Name	3	8	The name of an SMP/E hierarchical file system element or load module processed during APPLY or RESTORE processing. The data is left-justified and padded with blanks.
Type	11	12	The type of SMP/E hierarchical file system element or LMOD processed during APPLY or RESTORE processing. The valid values are: a hierarchical file system element type JAR LMOD The data is left-justified and padded with blanks.
Action	23	8	The type of action SMP/E took against this symbolic link during APPLY or RESTORE processing. Valid values are ADDREP and DELETE. The data is left-justified and padded with blanks.
DD name	31	8	The ddname associated with the target library for the named hierarchical file system element or load module in this A1 record. The data is left-justified and padded with blanks. For action type DELETE, this field indicates the target library ddname from which the symbolic link has been deleted. For action type ADDREP, this field indicates the target library ddname into which the symbolic link has been added or replaced. An A1 record is created for all libraries modified within a UNIX file system by having a hierarchical file system element replaced or deleted or by having a load module replaced or deleted. This field contains the ddname of the associated target library regardless of whether the allocation was done by a DD statement or DDDEF.
Symbolic link	39	1023	This is a symbolic link associated with this SMP/E hierarchical file system element or LMOD. The data is mixed-case characters and is left-justified and padded with binary zeros.

For example, suppose that load module LMODA, which has two symbolic links, LMA and LMDA, is added to the BPXUSER library. Figure 1 shows the A1 records created for LMODA:

Figure 1. Example of alias record type 1

         1         2         3         4         5         6         7         8
----+----0----+----0----+----0----+----0----+----0----+----0----+----0----+----0
A1LMODA   LMOD        ADDREP  BPXUSER LMA
A1LMODA   LMOD        ADDREP  BPXUSER LMDA