Check TCP/IP profile syntax without applying configuration changes

z/OS® V2R1 Communications Server improves the availability of TCP/IP by providing a method to check the syntax of TCPIP profile statements in an initial profile or in the profile data set that is specified on a VARY TCPIP,,OBEYFILE command without activating the profile.

With the VARY TCPIP,,SYNTAXCHECK command, you can check the syntax of configuration statements in profile data sets before using the statements to configure TCP/IP.

You do not need to issue the command on the system that will apply the profile; you can check the profile on any system that supports the VARY TCPIP,,SYNTAXCHECK command. For example, you can specify a TCP/IP stack on this command that is configured to support only IPv4 to check a profile that contains IPv6 profile statements.

Restriction: The VARY TCPIP,,SYNTAXCHECK command makes no attempt to update the active configuration; therefore, it does not detect and report conflicts with the active configuration.
Dependencies:
  • TCP/IP must be active before you issue this command.
  • For consistent syntax checking, you must issue the VARY TCPIP,,SYNTAXCHECK command against a stack that is at the same z/OS release level as the stack that activates the profile.
  • If your profile contains MVS™ system symbols, you must issue the VARY TCPIP,,SYNTAXCHECK command against the same stack that activates the profile to ensure consistent resolution of the MVS system symbols

Checking the TCP/IP profile syntax without applying configuration changes

To check the TCP/IP profile syntax without applying configuration changes, perform the appropriate tasks in Table 1.
Table 1. Check TCP/IP profile syntax without applying configuration changes
Task Reference
Control which users have access to the VARY TCPIP,,SYNTAXCHECK command. VARY TCPIP,,SYNTAXCHECK in z/OS Communications Server: IP System Administrator's Commands
Create or update a data set that contains profile statements. TCP/IP profile (PROFILE.TCPIP) and configuration statements in z/OS Communications Server: IP Configuration Reference
Issue the VARY TCPIP,,SYNTAXCHECK command to check the syntax of statements in the profile that you have created or updated. VARY TCPIP,,SYNTAXCHECK in z/OS Communications Server: IP System Administrator's Commands