Service name
Communications Server IP Port Reservations


For z/OS Releases
V1R4 and above


Description
The Communications Server IP Port Reservations service assists the user in configuring the port definitions for the z/OS system. This service offers also read-only access to the current port definitions for other services as well as the capability to make their own port definitions via update requests.


Policies Supplied
None


Refresh Actions
 
System resources accessed during Refresh Authorization Required
TCP/IP configuration profile data set PROFILE.TCPIP ALTER authority for PROFILE.TCPIP
User supplied TCP/IP configuration ports data set READ authority for user supplied ports data set

The Communications Server IP Port Reservations service supplies a refresh dialog that is displayed before the first refresh of the service or on explicit user request (by selecting the 'Edit refresh data' choice for the service). The refresh dialog requires that you enter a high level qualifier (HLQ). The HLQ is used to specify the location for the files that are created by the service. This dialog prompts for the location of the configuration profile and ports data sets.
Note: To utilize refresh support your port and port range configuration statements must reside in a separate file. No other TCP/IP configuration statements can be in this file.


Update Actions Performed by this Service
 
Update action System resources Updated Authorization Required Resource owner
Create or update the Ports configuration files. The Communications Server IP Port Reservations service creates three data sets for the port reservations:
  • the active data set hlq.MSYS.YourSysplex.xxxx.TCPIP
  • the temporary data set hlq.MSYS.YourSysplex.xxxx.TEMP
  • the backup data set hlq.MSYS.YourSysplex.xxxx.BKUP
where:
hlq is defined by the user in the refresh dialog.
xxxx is the Communications Server IP Port Reservations instance id.
Note: If the sysplex you are using begins with a number that number is changed to the letter M and the number is appended to MSYS.
ALTER authority for the created Ports configuration files Communications Server IP Port Reservations
Update the TCP/IP configuration data set PROFILE.TCPIP. TCP/IP configuration data set PROFILE.TCPIP ALTER authority for PROFILE.TCPIP Communications Server IP Port Reservations


Update Requests Offered by this Service
 
Update action System resources Updated Authorization Required
Set or modify selected entries in the Ports configuration files. The Communications Server IP Port Reservations service creates three data sets for the port reservations:
  • the active data set hlq.MSYS.YourSysplex.xxxx.TCPIP
  • the temporary data set hlq.MSYS.YourSysplex.xxxx.TEMP
  • the backup data set hlq.MSYS.YourSysplex.xxxx.BKUP
where:
hlq is defined by the user in the refresh dialog.
xxxx is the Communications Server IP Port Reservations instance id.
Note: If the sysplex you are using begins with a number that number is changed to the letter M and the number is appended to MSYS.
ALTER authority for the Ports configuration files