The ftshwo command outputs the operating parameters of the local openFT sys- tem. Alongside the standard output and output in CSV format, output may also be specified as a platform-specific command sequence. In this way, it is possible to save the settings and then load them onto another computer.
The FT administrator can set or modify the operating parameters with the ftmodo command.
Format ftshwo -h |
[ -csv | -px | -pw | -p2 | -pz ]
Description
-h Displays the command syntax on the screen. Entries after the -h are ignored.
-csv The operating parameters are output in CSV format. The individual val- ues are separated by semicolons.
-px The operating parameters are output as a command string. This can be called as a shell procedure on UNIX systems in order to regenerate iden- tical operating parameters on different systems.
-pw The operating parameters are output as a command string. This can be called as a batch procedure on Windows systems in order to regenerate identical operating parameters on different systems.
-p2 The operating parameters are output as a command string. This can be called as an SDF procedure on BS2000/OSD systems in order to regen- erate identical operating parameters on different systems.
-pz The operating parameters are output as a command string. This can be called as a Clist procedure on z/OS systems in order to regenerate iden- tical operating parameters on different systems.
No option specified
Output format of ftshwo Example
# ftshwo
STARTED PROC-LIM CONN-LIM RQ-LIM MAX-RQ-LIFE TU-SIZE KEY-LEN CCS-NAME *YES NONE 16 2000 30 32480 768 ISO88591 PTN-CHK DYN-PART SEC-LEV FTAC-LOG FT-LOG
STD *ON 1 ALL ALL
OPENFT-APPL FTAM-APPL FTP-PORT USE TNS *STD *STD 4444 *NO HOST-NAME IDENTIFICATION / LOCAL SYSTEM NAME ath0000l ath0000l.city.cp.net / $FJAM,ATH0000L
TRAP: SS-STATE FT-STATE PART-STATE PART-UNREA RQ-STATE TRANS-SUCC TRANS-FAIL CONS OFF OFF OFF OFF OFF OFF OFF TRACE: SWITCH PARTNER-SELECTION REQUEST-SELECTION OPTIONS
OFF ALL ALL NONE
Meaning of the output together with the associated command options:
Field name Meaning and values Command/
option
STARTED Specifies whether the asynchronous openFT server has started (*YES) or not (*NO).
ftstart ftstop
PROC-LIM Maximum number of processes available for the processing of asynchronous requests.
ftmodo -pl=
CONN-LIM Maximum number of asynchronous requests that can be processed simultaneously.
ftmodo -cl=
RQ-LIM Maximum number of file transfer requests that can simultaneously be present in the local sys- tem’s request queue.
ftmodo -rql=
MAX-RQ-LIFE Maximum lifetime of requests in the request queue (in days).
ftmodo -rqt=
TU-SIZE Upper limit for message length at transport lev- el (in bytes)
ftmodo -tu=
KEY-LEN Length of the RSA key currently used to en- crypt the AES/DES key.
ftmodo -kl=
CCS-NAME Name of the character set used by default for file transfer requests, see page 113
ftmodo -ccs=
PTN-CHK Setting for sender verification: ADDR: address
STD: identification
DYN-PART Setting for dynamic partner entries: *ON (activated)
*OFF (deactivated)
ftmodo -dp=
SEC-LEV Default security level for partners in the partner list for which no security level has been set:
ftmodo -sl=
1..100:
Fixed security level. 1 is the lowest and 100 the highest security level.
B-P-ATTR:
The security level is depending on the partner’s attributes, i.e.:
10 if the partner has been authenticated. 90 if the partner is known in the transport system.
100 otherwise, i.e. if the partner has only been identified by its address.
FTAC-LOG Scope of FTAC logging: ftmodo -lc=
ALL
All FTAC access checks MODIFY
Modifying file management requests and re- jected FTAC access checks
REJECTED
Only rejected FTAC access checks
FT-LOG Scope of FT logging: ftmodo -lt=
ALL: All requests
FAIL: Only errored FT requests NONE: Logging deactivated
OPENFT-APPL Port number of the local openFT server, possi- bly extended by the transport selector. STD means that the default value (1100) is used.
ftmodo -openft=
FTAM-APPL Port number of the local FTAM server, possibly extended by the transport selector, the session selector and the presentation selector. STD means that the default value (4800) is
ftmodo -ftam=
Field name Meaning and values Command/
FTP-PORT Port number used by FTP. NONE means that the FTP server is set to inactive.
ftmodo -ftp=
USE TNS Specifies whether the TNS is to be used (*YES) or not (*NO).
ftmodo -tns=
HOST-NAME Host name of the local computer, *NONE means that no host name has been assigned.
--- IDENTIFICATION Instance identification of the local openFT in-
stance.
ftmodo -id=
LOCAL- SYSTEM- NAME
Name of the local system. ftmodo -p= -l=
TRAP The TRAP settings are output here. The possi- ble values are ON and OFF. The row CONS in- dicates the console traps. The columns desig- nate the events for which traps may be gener- ated:
ftmodo -tpc=
SS-STATE
Change of the status of the openFT subsystem FT-STATE
Change of the status of the openFT control pro- cess
PART-STATE
Change of the status of partner systems PART-UNREA
Partner systems unreachable RQ-STATE
Change of the status of request administration TRANS-SUCC
Requests completed successfully TRANS-FAIL
Failed requests
Field name Meaning and values Command/
TRACE The monitoring settings (traces) are output here. The meanings of the individual columns are as follows:
SWITCH
Monitoring activated (ON) or deactivated (OFF)
ftmodo -tr=
PARTNER-SELECTION
Selection based on the partner system’s proto- col type. Possible protocol types:
OPENFT, FTP, FTAM.
ALL means that nothing is selected, i.e. all partner systems
ftmodo -trp=
REQUEST-SELECTION ftmodo -trr=
Selection based on the request type The following are possible:
ONLY-SYNC/ONLY-ASYNC (only synchro- nous or only asynchronous requests) ONLY-LOCAL/ONLY-REMOTE (only locally or only remotely submitted requests). ALL means that nothing is selected, i.e. all requests. OPTIONS:
NONE: No options
NO-BULK-DATA: Minimum trace, i.e. bulk data (file contents) is not logged. In addition, no rep- etitions of data log elements are logged.
ftmodo -tro=
Field name Meaning and values Command/