Welcome to the z/OS Communications Server IP Services customization panels for TCP/IP port refresh.
Getting Started
Navigate through the panels to modify or add new port reservations. Once you complete your customization tasks, select OK from the main TCP/IP customization panel to save the data into the LDAP server. You can also select the CANCEL button, which will discard any data you entered.
To begin, select a category and click the Customize button (or double click on the category). msys for Setup displays panels specific to that category. Throughout the customization phase, use the OK buttons to indicate that you have completed configuration data for a panel or set of panels, or use the CANCEL button to discard data.
Scope of the TCP/IP configuration
Information is collected allowing for the creation and management of all TCP/IP port reservations.
Port reservations can originate in several ways.
If you successfully executed the Refresh step, the ports shown originated from your existing port reservations MVS data set.
If you did not execute the Refresh step, the ports shown originated from the initial default set of port reservations.
New ports can be added using the TCP/IP customization panels.
msys for Setup services other than TCP/IP may reserve ports. These port reservations are configured on the customization panels of other services and added to the port reservations in the MVS configuration data set after an Update is executed. These reservations will be shown on the TCP/IP ports customization panels after a Commit is executed.
The customization panels support all options for the TCP/IP customization statements:
PORT
PORTRANGE
The output
msys for Setup marks each TCP/IP configuration as either 'Not customized', 'Customized', or 'Incomplete'. Initially a configuration will be 'Not customized' until you select the OK button on the main TCP/IP customization panel. At that time, msys for Setup saves the data in the LDAP server database and marks the service as 'Customized'.
When a configuration is 'Customized' you may include it for update processing. Update is the msys for Setup phase when the customized data is retrieved from the LDAP database and the TCP/IP configuration file is created. The configuration file is placed in the MVS DASD location you specified during the prerefresh dialog.
After an Update is performed, msys for Setup creates a data set containing a PORTS member. This data set is named:
high level qualifier from prerefresh dialog + ".MSYS." + name of sysplex + "." + image short name 2 characters + "I" + instance ID 2 characters + ".TEMP"
The PORTS member contains all the PORT and PORTRANGE definitions.
After a Commit is performed, the data set created during the Update process is copied into a data set with the same name as above. However, rather than the data set name ending with "TEMP", it ends with "TCPIP". Also, during the commit processing, your PROFILE.TCPIP is updated to point to this new PORTS member using the INCLUDE statement.