ENABLE

Authorization

C, S, U

Purpose

The ENABLE command begins a previously disabled switched telecommunication port, or resets a pending disabled status from a previous DISABLE command. The port then becomes available to receive an incoming dialed call. ENABLE also changes the TRACE status of a port.

The port to be started must have been previously defined by the PORT command or configuration file statement. Previously enabled ports are not affected by the ENABLE command except to alter their logging status, if so requested. For information on the PORT statement, see z/VM: RSCS Networking Planning and Configuration.

Operands

ccuu

is the virtual address of the switched telecommunication port to be started.

ALL

starts all previously defined switched telecommunication ports.

TRace

starts or stops the logging of I/O activity on the port or ports. The file is queued for real printer output when the log trace is deactivated for the port.

ALL

starts the full-buffer logging of I/O activity on the port or ports.

LOG

starts the partial-buffer logging of I/O activity on the port or ports.

OFF

stops the logging of I/O activity on the port or ports, and begins printing out the log data.

RECords

logs any NJE record segments sent and received on this link after the link is started. This option is valid only for GATEWAY-type, LISTPROC-type, NJE-type, SNANJE-type, and TCPNJE-type links (the networking links).

When RSCS attaches a link to this port, it may not be a networking link. Because RECORDS does not apply to non-networking links, RSCS sets the link to TRACE ALL when attaching a non-networking link. TRACE ALL will remain in effect until RSCS attaches a networking link to this port. Once RSCS attaches a networking link, the trace reverts to RECORDS.

TO userid

TO SYSTEM

identifies the virtual machine that is to receive the log output. If the output is to be sent to the system unit record device, the userid must be specified as SYSTEM.

If specified, the TO operand must be the rightmost operand string. If TO is omitted, RSCS sends the log output to the user ID specified on the TRACEDEST configuration file statement. If a TRACEDEST statement is not specified, RSCS sends the output to the local printer.

nodeid

is the remote destination location. When userid or SYSTEM is specified with a nodeid, they can identify a virtual machine, a workstation, a 3270 printer, or the system record device on the specified remote system. If a nodeid is not specified, the local system is assumed.

Usage Notes

1. RSCS closes a trace file only when you specify TRACE OFF. If tracing is not already in effect and you specify TRACE ALL, LOG, or RECORDS, RSCS will open a trace file and begin tracing the specified activity.

   If tracing is in effect for one of the three activities (ALL, LOG, or RECORDS) and you enter an ENABLE command with a new TRACE option, RSCS will start tracing the new activity without closing the trace file.

2. The routing specified by the TO option happens only when the trace file is closed by the specification of OFF or if the port is disabled using the RSCS DISABLE command. So the routing can be changed after tracing has started, because only the last routing that was specified is used.
3. Because an MRJE-type link in workstation mode is intended to handle only job data, it will not handle log output. If log output is routed to an MRJE-type link, it will be purged.
4. To check the status of all switched telecommunication ports, enter an RSCS QUERY SYSTEM PORTS command.