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 |
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)
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)
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. |
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_
|
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
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)