Operator commands for the TCP/IP server

Overview

Various operator MODIFY commands are available for controlling the TCP/IP server.

The long and the short version of each command are shown in the following table.

Command (long)

Command (short)

Purpose

ACT TCP

A TCP

Start the server for a particular port

INACT TCP

IN TCP

Stop the server for a particular port

REFRESH TCP

REF TCP or R TCP

Stop and restart the server

DISPLAY TCP

D TCP

Display the status of ports and users

CANCEL TCP

C TCP

Cancel the users logged onto the port

ACT: Starting the server for a special port

Use the ACT command ACT to start (activate or reactivate) servers for particular ports, e.g. when the retry cycle for a port has elapsed. You cannot start servers for ports that are not available in the LST member.

Command keywords that are not entered in the command will be taken from the product LST member, or the default values for the LST keywords will be used.

If none of the parameters described is available in the LST member, the parameters marked as required in the list of LST parameters must be specified in the command.

Command

Keyword

ACT TCP

-OR-

A TCP

PORT(portnumber)

PROD(product)

TYPE(porttype)

-OR-

-OR-

P(portnumber)

PR(product)

 

Replace...

 

With...

 

portnumber

The number of the port you want to activate.

If you enter *, the ports entered in the LST parameters of the product the server is running under will be started. If other ports are to be started, * must also be entered for parameter PROD.

 

product

2-digit product identifier (for example: 93). Masks are allowed (for example: *).

 

porttype

The name of the port to be activated, for example, BWE, OSY, BSA or * (where BSA and * are identical).

Examples

F betastc,ACT TCP,P(4711) PR(*) TYPE(*)

F betastc,ACT TCP,PORT(*) PR(*) TYPE(*)

F betastc,A TCP,P(4711) PROD(93) TYPE(BWE)

INACT: Stopping the server

Use the INACT command to stop (deactivate) a server for a specific port. All users logged onto the system via specific port will then be canceled.

Command

Keyword

INACT TCP

-OR-

IN TCP

PORT(portnumber)

PROD(product)

TYPE(porttype)

-OR-

-OR-

P(portnumber)

PR(product)

 

Replace...

 

With...

 

portnumber

The number of the port you want to stop.

 

product

2-digit product identifier (for example: 93).

 

porttype

The name of the port to be activated, for example, BWE, OSY, BSA or * (where BSA and * are identical).

Examples

F betastc,INACT TCP,P(4711) PR(93) TYPE(BWE)

F betastc,IN TCP,P(4711) PROD(92) TYPE(OSY)

REFRESH: Stopping and restarting the server

Use the REFRESH command to automatically stop and restart the server.

All users are canceled.

Command

Keyword

 

 

REFRESH TCP

-OR-

REFR TCP

PORT(portnumber)

PROD(product)

TYPE(porttype)

-OR-

-OR-

P(portnumber)

PR(product)

 

Replace...

 

With...

 

portnumber

The number of the port you want to refresh.

 

product

2-digit product identifier (for example: 93).

 

porttype

The name of the port to be activated, for example, BWE, OSY, or BSA.

DISPLAY: Displaying server and user status

Use the DISPLAY command to display the status of all the ports activated for the server, and to display all the users who are logged onto the server through these ports.

When user status is displayed, a message informing you about the number of users logged onto the server will be written to the console, and detailed user information will be written to the SYSLOG of the started task (STC).

Command

Keyword

 

 

DISPLAY TCP

-OR-

D TCP

PORT(portnumber)

PROD(product)

[ USER(username) ]

TYPE(porttype)

[ connections ]

-OR-

-OR-

-OR-

P(portnumber)

PR(product)

[ U(username) ]

 

Replace...

 

With...

 

portnumber

The number of the port you want to display. When you enter *, all the ports entered in the LST parameters of the product the server is running under will be displayed.

 

username

The name of the user who is to be displayed. If you enter *, all users activated for this port will be displayed. Masks are allowed, for example BER*. If you want to display only the users logged onto one product, use the parameter PROD.

product

2-digit product identifier (for example: 93). Masks are allowed (for example: *).

 

porttype

The name of the port to be displayed, for example, BWE, OSY, or BSA.

 

connections

CONNECT (or CONN or CO) to display all connections that are currently active

CONNALL to display all connections (active and active) that have occurred during the runtime of the BSA TCP/IP server.

CONNENC to show all connections (active and active) where the encryption method requested by the client does not match the encryption method of the server

Note: The requested information must be available (Bnn_TCPIP_ CONNECT_ INFO = YES; the default is: YES).

Examples

F betastc,DISPLAY TCP,U(*) PR(*) P(*) TYPE(*)

F betastc,D TCP,U(BER*) PORT(4711) PR(*) TYPE(BWE)

F betastc,D TCP,P(*) PR(*) TYPE(*) CONNENC

CANCEL: Canceling users

Use the CANCEL command to cancel users who are logged onto the server.

Command

Keyword

 

 

CANCEL TCP

-OR-

C TCP

PORT(portnumber)

PROD(product)

USER(username)

TYPE(porttype)

-OR-

-OR-

-OR-

P(portnumber)

PR(product)

U(username)

 

Replace...

 

With...

 

portnumber

The number of the port where you want to cancel users.

 

product

2-digit product identifier (for example: 93).

 

username

The name of the user who is to be displayed. If you enter *, all users activated for this port will be displayed. Masks are allowed, for example BER*. If you want to display only the users logged onto one product, use the parameter PROD.

 

porttype

The name of the port where the user is to be canceled, for example, BWE, OSY, or EDF.

Examples

F betastc,CANCEL TCP,U(*) PORT(4711) PR(93) TYPE(BWE)

F betastc,C TCP,U(BER*) PORT(4711) PR(92) TYPE(OSY)