The DRIVER statement must follow the related NODE statement, which in turn is followed by the related LINK statements. For information about the NODE statement, see the section Entire Net-Work NODE Statement.
The following is the format of the Entire Net-Work IUCV DRIVER statement. The access method name IUCV instructs Entire Net-Work to load the line driver module NETIUCV.
For more information about syntax conventions and rules used in this section, read Conventions.
The DRIVER statement parameters are read from a sequential file during system startup, and can be modified after startup using the ALTER operator command. See the ALTER operator command in the section IUCV Operator Commands .
Some parameters can be modified when the line driver is open or closed. Others can be modified only when the line driver is closed. The open/closed requirement for each parameter is included in the following descriptions.
This section describes all of the parameters that can be used for the IUCV DRIVER statement.
For more information about syntax conventions and rules used in this section, read Conventions.
This optional parameter determines whether the line driver will accept connections from systems that have not been previously defined with LINK statements. The ACCEPTUI parameter can be modified when the line driver is open or closed.
Valid values are "Y" (Yes) or "N" (No).
If "Y" is specified, Entire Net-Work will accept connection requests from an undefined system and the required control blocks are built dynamically. Normal "handshaking" procedures with the new connections are performed.
If "N" is specified, Entire Net-Work will reject incoming requests from unknown source nodes.
This optional parameter specifies the special character used to designate that an operator command should be directed to this line driver rather than to a specific link. The DRVCHAR parameter can be modified only when the line driver is closed.
This optional parameter causes the driver to issue an IUCV RETRIEVE BUFFER command if the initialization to IUCV services detects an IUCV user program active in the related virtual machine that is not using an IUCV macro interface. The FORCE parameter can be modified only when the line driver is closed.
Specifying FORCE=Y will terminate IUCV communications for all other products in the virtual machine using IUCV communications. For more information about mutual use of IUCV, read Factors Affecting Compatibility and Performance.
This parameter is the IUCV resource ID for the Entire Net-Work IUCV line driver. The resource ID is a logical name for an IUCV service. The standard resource ID for Entire Net-Work is SAGNETWK. This parameter should be issued only when it is necessary to run two separate versions of Entire Net-Work with IUCV line drivers concurrently. An example for this could be a test and a production network. If specified, the resource ID should be the same on all nodes. The RESID parameter can be modified only when the line driver is closed. Its value cannot be modified using the ALTER operator command.
If RESID is specified on the DRIVER statement, the same value for the RESID parameter must be specified on the LINK statements of the other nodes that are to be connected to this node. In addition to specifying the RESID parameter in the DRIVER statement, the RESID parameter of NETSIP or NETSIR must be specified on z/VSE nodes with non-z/VM mode supervisors.
This optional parameter specifies the retry interval in seconds (interval) and the number of retries (retries) that Entire Net-Work will attempt to reopen the access method with the API after a shutdown due to a failure. The RESTART parameter can be modified when the line driver is open or closed.
If RESTART is not specified, or interval is specified as zero, no retry is attempted. By specifying (retries) as zero, an infinite number of retries can be requested.
If RESTART is specified on the IUCV DRIVER statement, a corresponding RESTART parameter value should be specified on each IUCV LINK statement to control restart attempts on the individual link.
The TIMER parameter on the NODE statement affects the RESTART parameter (see the section Entire Net-Work NODE Statement.) The retry interval should not be less than the TIMER parameter, and should be a multiple of this value. If a retry interval other than zero is specified that is less than the value of the TIMER parameter, the TIMER value is used instead.
This optional parameter specifies the amount of time, in seconds, before statistics are automatically printed or reset. The STATINT parameter can be modified when the line driver is open or closed.
There is no maximum value. A value of 0 is reset to 3600. The default is 3600.
This parameter, which applies to z/VSE guest operating systems only, specifies the Entire Net-Work SVC number; that is, the number under which NETSVC has been installed, not the number of the Adabas SVC. The SVCNO parameter can be modified only when the line driver is closed.
This parameter indicates whether tracing for this line driver should be active (Y) or not (N). When tracing is activated, trace information is placed in the trace table. The default is N (no). The TRACE parameter can be modified when the line driver is open or closed.
This is equivalent to specifying
TRACE=linedriver-code or
TRON=linedriver-code in the
NODE statement
(for example, TRACE=CTCA).