LU Automatic Allocation
This chapter describes how to set the BEGINVTAM macro to use the LU automatic allocation function of OpenFrame GW.
1. Overview
The function assigns an LU name to a terminal with the information stored in the data set based on tfhe IP of the connecting terminal, or determines the access permission by checking the consistency when the LU name of the terminal is already specified. To use this function, users need to configure IP-LU mapping information using the BEGINVTAM macro syntax.
The following is an example of VTAM auto-allocation setting.
BEGINVTAM PORT 15400 DEFAULTLUS DFLT0000..DFLT9999..FFFFNNNN ENDDEFAULTLUS LUGROUP LUGRP1 UGSS0000..UGSS9999..FFFFNNNN ENDLUGROUP IPGROUP IPGRP2 1.1.1.1..255.255.255.255 ENDIPGROUP LUMAP LUGRP1 IPGRP2 ENDVTAM
2. BEGINVTAM Macro
Automatically assigns LU names to terminals by mapping IP groups to LU groups and enables to use the auto-logon to default region by properly combining several statements in the syntax.
|
Currently, only OSC supports the auto-logon to default region. |
Default Region means the region that automatically logs on in connecting to a terminal when users do not designate it. When users specify an LU name in connecting to a terminal, it also provides a consistency check function.
To write a macro with BEGINVTAM macro setting rules is as follows:
2.1. LU Naming Rules
When specifying the LU name as an option of several commands in BEGINVTAM macro syntax, refer to the following rules.
-
The first character of the specified LU name must be A-Z, @, #, or $. For the remaining digits, '0-9' can be used in addition to the preceding character. Avoid using non-printable characters.
-
The LU name setting can also be specified by the range setting.
The range setting is as follows:
LowerRange..UpperRange[..rangerule]
-
Space characters cannot be entered.
-
The length (number of strings) of LowerRange, UpperRange, and rangerule must be the same and cannot exceed 8 characters.
-
UpperRange must be greater than LowerRange. (Compare to ASCII values of characters.)
-
rangerule has the following wildcard rules.
Item Description F
It is fixed and does not change.
A
Only uppercase English letters are allowed.
N
Only numbers are allowed.
B
Only uppercase letters and numbers are allowed.
X
Only hexadecimal related numbers and uppercase letters are allowed. (0~F)
?
Only numbers and uppercase letters including @, #, and $ are allowed.
Following is the example of the rule.
According to the third rule, TCP is a character fixed to FFF.
N can be a number (0~9).
X can be a hexadecimal number (0~F).
? can be 0-9, AZ,@ ,#,$
A can be A-Z.
B can be 0-9 or A-Z.
TCP000A0..TCP9F$ZZ..FFFNX?AB
The following is an example of specifying AB100~AB999(900), BB000~BB999(1000), and CB000~CB299(300) (total of 2200 LU names).
AB100..CB299..AFNNN
-
2.2. IP Setting Rules
The following is how to indicate an address. For IP addresses, only IPv4 addresses are valid.
XXX.XXX.XXX.XXX
The following is an example of setting a total of 255 IP addresses.
1.1.1.1..1.1.1.255
2.3. BEGINVTAM Macro Setting Rules
Use the BEGINVTAM macro syntax rules as follows:
-
If you want to designate more than one port in the BEGINVTAM statement (~ENDVTAM), place them in the first command position of the BEGINVTAM statement.
-
Register the LU name specified in LUGROUP or the LU names within the LU range in the region to be accessed for automatic login.
-
When specifying a group name, exclude the following characters.
ASCII Value HEXA Value Description .
2E
Period
*
2A
Asterisk
;
3B
Semicolon
,
2C
Comma
=
3D
Equal
-
Define the LU group name and IP group name used for LUMAP in advance.
-
Map LUGROUP with IPGROUP to be used.
-
If the first column begins with a semicolon ( ; ), it is treated as a comment.
-
In order for the gateway to obtain the relevant information (BEGINVTAM syntax) during startup, save the information in the data set set in DSNAME of the [VTAM] section in vtam.conf in advance using the vtamgen tool. For more information about vtamgen tool, refer to OpenFrame Tool Reference Guide.
-
For the overlapping IPs that are defined in different IP groups, the one defined earlier is applied and a warning message pops up.
For example, in the following setting, 2.2.2.2 defined in the second IP group XYZ is ignored.
IPGROUP ABC 1.1.1.1 2.2.2.2 ENDIPGROUP IPGROUP XYZ 2.2.2.2 3.3.3.3 ENDIPGROUP
3. BEGINVTAM Macro Commands
The following describes the commands used in the BEGINVTAM macro syntax.
| Command | Description |
|---|---|
Tries to connect to the configured region at the time when the terminal and gateway are connected. |
|
Default LU group used when LU group is not set. |
|
Default printer LU group used when the printer LU group is not set. |
|
Sets an IP group. |
|
Sets a LU group. |
|
Sets a printer LU group. |
|
Maps IP groups with LU groups. |
|
Maps IP groups with LU in the printer PRTGROUP. |
|
Sets a port number of gateway. |
|
Other commands including ALLOWAPPL, DEFAULTLUSSPEC, DEFAULTPRTSPEC, DESTIPGROUP, DESTIPGROUP, HNGROUP, INTERTCP, LINEMODEAPPL, LINKGROUP, MONITORGROUP, MONITORMAP, PARMSGROUP, PARMSMAP, PRTDEFAULTAPPL, RESTRICTAPPL, USERGROUP, and USSTCP are not supported. |
3.1. DEFAULTAPPL
Default region name used when the region is not set to connect to DEFAPPL in LUMAP.
|
Only OSC supports this function. |
-
Usage
DEFAULTAPPL application_name
Item Description application_name
Specifies the region name to set.
3.2. DEFAULTLUS
Default LU group used when LU group is not set.
-
Usage
DEFAULTLUS luname|luname1..luname2[..range_rule] ENDDEFAULTLUS
Item Description luname
LU name to set.
luname1..luname2
Specified range of LU name.
range_rule
Rule of LU name.
3.3. DEFAULTPRT
Default printer LU group used when the printer LU group is not set.
-
Usage
DEFAULTPRT prt_name|prt_name1..prt_name2[..range_rule] ENDDEFAULTPRT
Item Description prt_name
Printer name to set.
prt_name1..prt_name2
Specified range of printer name.
range_rule
Rule of printer name.
3.4. IPGROUP
Sets an IP group.
-
Usage
IPGROUP ip_group_name ip_addr|ip_range1..ip_range2 ENDIPGROUP
Item Description ip_group_name
IP group name to be used in LUMAP.
ip_addr
IPv4 address.
ip_range1..ip_range2
IPv4 address range.
3.5. LUGROUP
Sets a LU group.
-
Usage
LUGROUP lu_group_name lu_name|lu_name1..lu_name2[..range_rule] ENDLUGROUP
Item Description lu_group_name
LU group name to be used in LUMAP.
lu_name
LU name.
lu_name1..lu_name2
Specified range of LU name.
range_rule
Rule of LU name.
3.6. PRTGROUP
Sets a printer LU group.
-
Usage
PRTGROUP lu_group_name lu_name|lu_name1..lu_name2[..range_rule] ENDPRTGROUP
Item Description lu_group_name
LU group name to be used in PRTMAP.
lu_name
LU name.
lu_name1..lu_name2
Specified range of LU name.
range_rule
Rule of LU name.
3.7. LUMAP
Maps IP groups with LU groups.
-
Usage
LUMAP luname|lu_group_name ip_addr|ip_group_name [DEFAPPL application_name] [GENERIC | SPECIFIC]
Item Description luname
LU name.
lu_group_name
LU group name.
ip_addr
IPv4 address.
ip_group_name
IP group name.
application_name
Region name. (Only for OSC.)
GENERIC
Allocates LU to terminals. (Default value)
SPECIFIC
Searches in the LUMAP when the terminal designates an LU name.
3.8. PRTMAP
Maps IP group with LU group of PRTGROUP.
-
Usage
PRTMAP luname|lu_group_name ip_addr|ip_group_name [DEFAPPL application_name] [GENERIC|SPECIFIC]
Item Description luname
LU name.
lu_group_name
LU group name.
ip_addr
IPv4 address.
ip_group_name
IP group name.
application_name
Region name. (Only for OSC.)
GENERIC
Allocates LU to terminals. (Default value)
SPECIFIC
Searches in the LUMAP when the terminal designates an LU name.