Creation of the IP Management file

Create the IP Management file used by HULFT (such as 'HULFT.HOSTS.LOCAL').

Note

When you use DNS or a TCP/IP host file, HULFT IP Management file will not be used, and therefore is not necessary to create.
Define the host name in 8 bytes or less for the hosts defined as remote hosts. In order to define host names that are 9 bytes or more, configure the settings explained in Setting of the hosts file for TCP/IP connections.
If you specify a host name in the Host Information that includes a period, such as 'UNIX.DOMAIN,' HULFT will not refer to the IP Management file (HULFT.HOSTS.LOCAL). Instead, it will refer to the host name that is managed by TCP/IP.

The attributes of the file that you create are shown below.

Attribute
Organization	Record Format	Record Length	Block Size
PS	FB	80	6160

For the 'HOSTS' member in HULFT parameter library, define the Host Name and the IP Address for the remote host that communicates with HULFT. Then, use IEBGENER to create the IP Management file (HULFT.HOSTS.LOCAL) with the attributes shown in the table above.

Example of JCL

JCL template for creation: HULFT.JCL (INSTALL5)

//INSTALL5 JOB  CLASS=A,MSGCLASS=B                                              
//*                                                                             
//HOSTS    EXEC PGM=IEBGENER                                                    
//SYSUT1   DD   DSN=HULFT.PARMLIB(HOSTS),DISP=SHR                               
//SYSUT2   DD   DSN=HULFT.HOSTS.LOCAL,                                          
//             UNIT=SYSDA,VOL=SER=HUL001,DISP=(NEW,CATLG,DELETE),               
//             DCB=(LRECL=80,BLKSIZE=6160,RECFM=FB,DSORG=PS),                   
//             SPACE=(TRK,(5,1),RLSE)                                           
//SYSPRINT DD   DUMMY                                                           
//SYSIN    DD   DUMMY                                                           
//*

DD Name	Value	Description
SYSUT1	HULFT.PARMLIB	HULFT parameter library (installation destination file)
SYSUT2	HULFT.HOSTS.LOCAL	IP Management File

Parameter Name	Value	Description
UNIT	SYSDA	UNIT
VOL=SER	HUL001	Volume Name

In the IP Management file (HULFT.HOSTS.LOCAL) you created, you must define the Host Name and the IP Address for the remote host that communicates with HULFT. Remote host refers to the receiving host during the Send processing and the host that issues requests.

Note

Define a local host name for the communication test explained later in this manual. For details about the communication test, refer to Communication test of HULFT.
It is not necessary to restart Communications Server.
In order to apply the modifications that you made to the IP Management file (HULFT.HOSTS.LOCAL), you must restart HULFT system.

Example of IP Management file

HOST#:#172.16.0.1#:#UNIX#:::: 
HOST#:#172.16.0.2#:#ZOS#::::

= Remarks =

Use colons (:) as delimiters between fields, with one colon between fields and four colons at the end of a line.
# indicates a space character. Be sure to enter a space character in each location where a # is defined.
Define 'HOST' in the first column.
To define a line as a comment, define a semicolon (;) as the first byte in that line.