$ADD NETSRV(nnn) - Add a network server

Function

To dynamically create a network server device, as a JES2 TCP/IP interface.

Parameters

(nn)|(nn-mm)

A single or range of numeric values between 1 to 999.

RESTART=(Yes|No,interval)

Specifies whether this NETSRV is restarted if it is drained. The interval is the time (in minutes) between attempted restarts. The valid range for interval is 0-1440. An interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used. The default RESTART value is No, and the default interval value is 0.

SOCKET=

Specifies the name of a local socket upon which the NETSRV should listen.

TRaceio=(YES|NO|JES=YES|NO|COMMON=YES|NO|VERBOSE=YES|NO)

Specifies whether tracing is to be active, and which types of traces are to be activated for the server.

YES

Indicates that all types of tracing are to be done (JES,COMMON,VERBOSE).

NO

Indicates that no tracing is to be done. If you omit the TRACEIO keyword or specify its value as NO, the subparameters (JES,COMMON,VERBOSE) will be set to NO.

JES=YES|NO

Indicates whether data and control records that are passed between JES and TCP/IP are to be traced for this server.

COMMON=YES|NO

Indicates whether TCP/IP and other services that are called by IAZNJTCP are to be traced.

VERBOSE=YES|NO

Indicates whether diagnostic messages are to be issued to the master console and SYSLOG.

STACK=

Specifies the name of a TCP/IP stack to be used by this server when the Common INET (CINET) configuration is being used. If not specified, all stacks on the local machine is used. When only an INET configuration is being used, specification of a stack name is ignored.

SECURE=OPTIONAL|REQUIRED|USE_SOCKET

Indicates whether the NETSERV should accept only connection requests with a secure protocol in use such as TLS/SSL. When SECURE=REQUIRED is specified, the NETSERV rejects all connection requests that do not specify a secure protocol is to be used for the connection. When SECURE=OPTIONAL is specified, the NETSERV allows connections with or without a secure protocol in use.

The default, USE_SOCKET, inherits the SECURE setting from the SOCKET statement associated with the NETSERV. If the SOCKET says SECURE=YES, then processing is the same as specifying SECURE=REQUIRED on the NETSERV.

To specify that the NETSERV should use NJENET-SSL (2252) as the PORT it is listening on and the default port for outgoing connections, but not require all connections to use TLS/SSL, you must specify SOCKET SECURE=YES on the socket that is associated with the NETSERV and set the NETSERV to SECURE=OPTIONAL.

Authority Required

This command requires device authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.

Scope

Single member. The values supplied for this command is in effect for this member only.

Messages

$HASP898