Previous Topic: DCMT VARY PTERM ParametersNext Topic: Example: DCMT VARY PTERM

DCMT VARY Commands › DCMT VARY PTERM › DCMT VARY PTERM Usage

DCMT VARY PTERM Usage

LISTENER or DDSTCPIP type PTERM OFFLINE Requirements

The following table contains the parameters that are accepted for a LISTENER or DDSTCPIP type PTERM. The last column indicates if the owning PTERM must be OFFLINE to allow the corresponding parameter to be changed dynamically.

 

LISTENER PTERM

DDSTCPIP PTERM

PTERM OFFLINE

BACKLOG

X

 

X

IDLE INTERVAL

 

X

 

MAXIMUM CONNECTIONS

X

X

 

MODE SYSTEM/USER

X

 

X

PARM

X

 

X

PERMANENT CONNECTIONS

 

X

 

PORT

X

 

X

PORT RANGE OFF

 

X

 

PORT RANGE <range>

 

X

*

TARGET ADDRESS

 

X

X

TARGET NAME

 

X

X

TARGET PORT

 

X

X

TASK

X

 

X

TCP/IP ADDRESS

X

 

X

TCP/IP NAME

X

 

X

TCP/IP STACK

X

X

X
*

If the corresponding PTERM is ONLINE, the <range> value can be changed dynamically only if the port range parameter was not assigned to OFF at the time the PTERM was opened.

Managing a Generic Listener

The DCMT VARY PTERM statement can assist in managing generic listeners for TCP/IP. You can vary a listener PTERM OFFLINE to shut down the generic listener or vary the PTERM ONLINE to start the service. Using the DCMT VARY PTERM command you can dynamically change parameters on a listener PTERM.

Note: Varying a generic listener OFFLINE only affects the listener butit does not affect server tasks that are executing.

Stack-ip-name, stack-ip-address, and stack-host-name are mutually exclusive. Usually, it is undesirable to specify any of these parameters because doing so can tie a central version to an operating system image. There is an exception to this rule: if the central version runs on a multi-homed host and listening should be restricted to a specific TCP/IP stack.

Specifying a Trace Option

Each bit in the trace options byte specifies a trace option. To include a memory area in the trace dump, turn on the associated bit (1=on). The following table identifies bit assignments:

Bit

Associated memory area

X'01' (bit 7)

The data area associated with the physical terminal

X'02' (bit 6)

The physical terminal element (PTE)

X'04' (bit 5)

Type physical line element (PLE)

X'08' (bit 4)

LISTENER PTERM with TRACE ALLIO or GOODIO only: propagate the TCP/IP TRACE options assigned to the LISTENER LTERM to all the attached BULK PTERMs.

X'10' (bit 3)

LISTENER PTERM with TRACE ALLIO or GOODIO only: write extended time trace records to the log file.

X'20' (bit 2)

The data control block (operating system DCB) or the access method block (VTAM ACB), as applicable

X'40' (bit 1)

The I/O block (operating system DEB) or the node initialization block (VTAM NIB), as applicable

X'80' (bit 0)

The data event control block (operating system DECB) or the request parameter list (VTAM RPL), as applicable

Example Trace Options Values

You can turn on as many trace options as necessary in a given trace option byte. The following examples show how a trace-options-byte value represents trace options:

Hexadecimal Value

Trace Options byte

Options requested

EF

1110 1111

Requests all trace options (bit 3 unused)

06

0000 0110

Requests that the PTE and the PLE be snapped

More Information