Alias selection input parameter list

The alias selection input parameter list for LU-LU sessions contains information necessary for translation and is a fixed length. Its storage is obtained during begin function processing. If storage cannot be obtained for the alias parameter list during the begin function, message IST793E is issued indicating the error and the alias selection function is not invoked. Depending on which information needs translation, different fields are set.

The format of the alias selection input parameter list is described in Table 1. The input constants in the parameter list are described in Table 2.

Table 1. Alias selection input parameter list
Dec (Hex) Offset	Size (Bytes)		Description
0 (0)	1		Flags for NetView® alias application program:
		B'1... ....'	NetView alias application program is currently active.
		B'0... ....'	NetView alias application program is not active.
		B'.1.. ....'	NetView alias application program used to be active.
		B'.0.. ....'	NetView alias application program was never active. This bit is meaningful only if the previous bit is off.
		..xx xxxx	Reserved
1 (1)	7		Reserved
Start of NAME1 information
8 (8)	1		Indicates the role of the LU in the session (see Table 2)
9 (9)	1		Indicates the primary and secondary roles of the OLU and DLU (see Table 2)
		xxxx ....	Indicates whether the LU is the OLU, DLU, or unknown
		.... xxxx	Indicates whether the LU is the PLU, SLU, or unknown
10 (A)	1		Information pertaining to the LU name relevant for translation
		x... ....	1 = NAME1 is the real name. 0 = NAME1 is the alias name.
		.xxx xxxx	Reserved
11 (B)	5		Reserved
16 (10)	8	NAME1	LU name to be translated
24 (18)	8	NETFROM1	Network in which NAME1 is known
32 (20)	8	NETTO1	Network to which NAME1 is to be translated. Blank or zero if exit needs to determine the network.
Start of NAME2 information
40 (28)	1		Indicates the role of the LU in the session (see Table 2)
41 (29)	1		Indicates the primary and secondary roles of the OLU and DLU (see Table 2)
		xxxx ....	Indicates whether the LU is the OLU, DLU, or unknown
		.... xxxx	Indicates whether the LU is the PLU, SLU, or unknown
42 (2A)	1		Information pertaining to the LU name relevant for translation
		x... ....	1 = NAME2 is the real name 0 = NAME2 is the alias name
		.xxx xxxx	Reserved
43 (2B)	5		Reserved
48 (30)	8	NAME2	LU name to be translated
56 (38)	8	NETFROM2	Network in which NAME2 is known
64 (40)	8	NETTO2	Network to which NAME2 is to be translated. Blank or zero if exit needs to determine the network.
Start of CoS/LOG information
72 (48)	8	CoSNAME	CoS name
80 (50)	8	LOGNAME	Logon mode name
88 (58)	8	NETFROM	Network ID in which the name or names are known
96 (60)	8	NETTO	Network ID to which the name or names are to be translated
Start of NAME3 information
104 (68)	1		Indicates the role of the LU in the session (see Table 2)
105 (69)	1		Indicates the primary and secondary roles of the OLU and DLU (see Table 2)
		xxxx ....	Indicates whether the LU is the OLU, DLU, or unknown
		.... xxxx	Indicates whether the LU is the PLU, SLU, or unknown
106 (6A)	1		Information pertaining to the LU name relevant for translation
		x... ....	1 = NAME3 is the real name 0 = NAME3 is the alias name
		.xxx xxxx	Reserved
107 (6B)	5		Reserved
112 (70)	8	NAME3	LU name to be translated
120 (78)	8	NETFROM3	Network in which NAME3 is known
128 (80)	8	NETTO3	Network to which NAME3 is to be translated. Blank or zero if exit needs to determine the network.
Start of NAME4 information
136 (88)	1		Indicates the role of the LU in the session (see Table 2)
137 (89)	1		Indicates the primary and secondary roles of the OLU and DLU (see Table 2)
		xxxx ....	Indicates whether the LU is the OLU, DLU, or unknown
		.... xxxx	Indicates whether the LU is the PLU, SLU, or unknown
138 (8A)	1		Information pertaining to the LU name relevant for translation
		x... ....	1 = NAME4 is the real name 0 = NAME4 is the alias name
		.xxx xxxx	Reserved
139 (8B)	5		Reserved
144 (90)	8	NAME4	LU name to be translated
152 (98)	8	NETFROM4	Network in which NAME4 is known
160 (A0)	8	NETTO4	Network to which NAME4 is to be translated. Blank or zero if exit needs to determine the network.

The input constants in Table 2 are used in the alias selection input parameter list. These constants indicate:

Whether the name to be translated is a real name or an alias name
Whether the LU is the OLU or DLU
Whether the LU is the PLU or SLU
The role of the LU

Table 2. Constants for the alias selection input parameter list
Type	Value	Description
Settings for real name or alias name
Bit	0	The name sent for translation is the alias name. The real name needs to be determined.
Bit	1	The name sent for translation is the real name. The alias name needs to be determined.
Settings for OLU or DLU
Bit	0000	It cannot be determined whether the LU is the OLU or DLU.
Bit	0001	The LU is the origin logical unit for this session.
Bit	0010	The LU is the destination logical unit for this session.
Settings for PLU or SLU
Bit	0000	It cannot be determined whether the LU is the PLU or SLU.
Bit	0001	The LU is the primary logical unit for this session.
Bit	0010	The LU is the secondary logical unit for this session.
Settings for LU role
Hex	00	The LU is a session partner.
Hex	01	The LU is the primary printer.
Hex	02	The LU is the alternate printer.

The flags explained at offset 0 (see Table 1) contain information that is not included in the translate inquiry. The first flag indicates whether the NetView alias application program is currently active. The second flag indicates whether the NetView alias application program was ever active. Use these bits to maintain system integrity.