Note on usage
Function: Display operating parameters
User group: FT user and FT administrator
Alias name: FTSHWOPT
Functional description
The command SHOW-FT-OPTIONS can be used at any time to obtain the information listed below on the operating parameters of your FT system:
Information on whether or not openFT has been started
Name of the BCAM host
Instance identification
Maximum values for operation (maximum number of file transfer requests in the request file, maximum lifetime of requests, maximum number of processes and transport connections, maximum size of a transport unit)
Security settings (FTAC security level of the partner systems, extended sender verification)
Logging settings (scope, intervals for automatic deletion)
Trace settings
Settings for traps (console traps, SNMP traps, ADM traps)
Settings for the monitoring functions
Format
SHOW-FT-OPTIONS / FTSHWOPT |
OUTPUT = *SYSOUT (...) / *SYSLST(...) *SYSOUT (...) / *SYSLST(...) LAYOUT = *STD / *CSV / *BS2-PROC / *ZOS-PROC |
Operands
OUTPUT =
Output medium.
OUTPUT = *SYSOUT (...)
Output takes place on SYSOUT.
OUTPUT = *SYSLST(...)
Output takes place on SYSLST.
LAYOUT = *STD
Output is put into a user-friendly form for reading.
LAYOUT = *CSV
Output takes place in Character Separated Values format. This is a special tabular format, widely used in the PC world, where the individual fields are separated by semicolons “;“ (see section “SHOW-FT-OPTIONS”).
LAYOUT = *BS2-PROC
The operating parameters are output as a command sequence. This can be called as an SDF procedure at BS2000 systems in order to recreate the identical operating parameters.
If this output is redirected to a file using the SYSFILE command, you should note that the BS2000 SYSFILE management prefixes each line with the space (printer feed control character). The first column of the file must therefore be removed before the procedure generated in this way can be called.
LAYOUT = *ZOS-PROC
The operating parameters are output as a command sequence. This can be called as a Clist procedure at z/OS systems in order to recreate the identical operating parameters.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
83 | 32 | CMD0221 | Internal error. |
88 | 32 | CMD0221 | Error during OPS generation. |
35 | 64 | FTR1035 | Command only permissible for FT administrator. |
2 | 0 | FTR2225 | Information output canceled. |
SC1/2 = Subcode 1/2 in decimal notation For additional information, see section “Command return codes”. |
OPS variables
The following table shows the OPS variables for the command SHOW-FT-OPTIONS.
Element | Type | Output |
REQ-LIM | Integer | |
TASK-LIM | String | |
CONN-LIM | Integer | |
TRANSPORT-UNIT-SIZE | Integer | |
PARTNER-CHECK | String | *STD / *TRANSP-ADDR |
SEC-LEV | String | Value / *BY-PARTNER-ATTRIBUTES |
TRACE | Struct | |
.STATE | String | *ON / *OFF |
.OUT | String | *FILE / empty |
.PARTNER-SEL | Struct | |
.OPENFT | String | *YES / *NO |
.FTAM | String | *YES / *NO |
.FTP | String | *YES / *NO |
.ADM | String | *YES / *NO |
.REQUEST-SEL | Struct | |
.SYNC | String | *YES / *NO |
.ASYNC | String | *YES / *NO |
.LOCAL | String | *YES / *NO |
.REMOTE | String | *YES / *NO |
.OPTIONS | Struct | |
.BULK-DATA | String | *YES / *NO |
LOG | Struct | |
.TRANS-F | String | *ON / *OFF / *FAILURE |
.FTAC | String | *ON / *REJECTED / *MODIFICATIONS |
.ADM | String | *ON / *OFF / *FAILURE / *MODIFICATIONS |
MAX-REQ-LIFETIME | String | *UNLIMITED / max-request-lifetime |
SNMP-TRAPS | Struct | |
.SUBSYSTEM-STATE | String | *OFF / *ON |
.FT-STATE | String | *OFF / *ON |
.PARTNER-STATE | String | *OFF / *ON |
.PARTNER-UNREACHABLE | String | *OFF / *ON |
.REQUEST-QUEUE-STATE | String | *OFF / *ON |
.TRANSFER-SUCCESS | String | *OFF / *ON |
.TRANSFER-FAILURE | String | *OFF / *ON |
CONSOLE-TRAPS1 | String | *OFF / *ON |
CONS-TRAPS | Struct | |
.SUBSYSTEM-STATE | String | *OFF / *ON |
.FT-STATE | String | *OFF / *ON |
.PARTNER-STATE | String | *OFF / *ON |
.PARTNER-UNREACHABLE | String | *OFF / *ON |
.REQUEST-QUEUE-STATE | String | *OFF / *ON |
.TRANSFER-SUCCESS | String | *OFF / *ON |
.TRANSFER-FAILURE | String | *OFF / *ON |
ADM-TRAPS | Struct | |
.DESTINATION | Struct | |
. PARTNER | String | Value |
.SELECTION | Struct | |
.FT-STATE | String | *OFF / *ON |
.PARTNER-STATE | String | *OFF / *ON |
.PARTNER-UNREACHABLE | String | *OFF / *ON |
.REQUEST-QUEUE-STATE | String | *OFF / *ON |
.TRANSFER-SUCCESS | String | *OFF / *ON |
.TRANSFER-FAILURE | String | *OFF / *ON |
ADM-CONN-LIM | Integer | Value |
HOST-NAME | String | Name of the BCAM host |
IDENTIFICATION | String | Identification of the local openFT instance |
DYNAMIC-PARTNERS | String | *ON / *OFF |
KEY-LEN | Integer | Value |
RSA-MINIMUM | Integer | 0 / 768 / 1024 / 2048 / 3072 / 4096 |
AES-MINIMUM | String | *NONE / 128 / 256 |
STARTED | String | *YES / *NO |
OPENFT-APPLICATION | String | *STD / Value |
FTAM-APPLICATION | String | *STD / Value |
FTP-PORT | String | *NONE / Value |
OPENFT-STD | String | *STD / Value |
ADM-PORT | String | Value |
OPENFT-APPL-STATE | String | *DISABLED / *ACTIVE / *INACTIVE |
FTAM-APPL-STATE | String | *NAVAIL / *DISABLED / *ACTIVE / *INACTIVE |
FTP-STATE | String | *NAVAIL / *DISABLED / *ACTIVE / *INACTIVE |
ADM-STATE | String | *DISABLED / *ACTIVE / *INACTIVE |
MONITORING | Struct | |
.STATE | String | *ON / *OFF |
.PARTNER-SEL | Struct | |
.OPENFT | String | *YES / *NO |
.FTAM | String | *YES / *NO |
.FTP | String | *YES / *NO |
.REQUEST-SEL | Struct | |
.SYNC | String | *YES / *NO |
.ASYNC | String | *YES / *NO |
.LOCAL | String | *YES / *NO |
.REMOTE | String | *YES / *NO |
ACTIVE-APPLICATIONS | Struct | |
.OPENFT | String | *ON / *OFF |
.FTP | String | *ON / *OFF |
.ADM | String | *ON / *OFF |
DEL-LOG | Struct | |
.STATE | String | *ON / *OFF |
.RETENTION | Integer | Value |
.REPEAT | String | *DAILY / *WEEKLY / *MONTHLY |
Element | Type | Output |
.DAY | Integer | Value |
.TIME | String | hh:mm:ss |
ENC-MAND | Struct | |
.IN | String | *YES / *NO |
.OUT | String | *YES / *NO |
RECOVERY-OUTBOUND | String | *ON / *OFF |
RECOVERY-INBOUND | String | *ON / *OFF |
Meaning of the output of the OPS variables
Only the OPENFT-STD variable is described below. The meanings of the other variables correspond to the associated output parameters of SHOW-FT-OPTIONS, see Descriptionof the output of SHOW-FT-OPTIONS.
OPENFT-STD
Port number used to address openFT partners if these are addressed via their host names without any port number specification.
*STD means that the default port number 1100 is used.
The value can be modified using the OPENFT-STD operand in the MODIFY-FT-OPTIONS command
Default setting following installation: *STD