Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-FT-OPTIONS

&pagelevel(3)&pagelevel

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

1Now only support for reasons of compatibility. The value is only set if all the console traps are activated (*ON) or if all the console traps are deactivated (*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