Your Browser is not longer supported

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

{{viewport.spaceProperty.prod}}

Description of long output of FTSHWLOG

&pagelevel(4)&pagelevel

Long output form outbound (example, openFT <= V12.1C00)

LOGGING-ID    = 9479        RC        = 0000          TIME       = 2016-07-11 14:31:29

    TRANS      = TO          REC-TYPE= FT            FUNCTION = TRANSFER-FILE
    PROFILE    =             PCMD      = NONE          STARTTIME= 2016-07-11 14:31:29

    TRANS-ID = 67052       WRITE     = REPLACE       REQUESTED= 2016-07-11 14:31:28

    TRANSFER =           1 kB                      CCS-NAME = IBM1047
    SEC-OPTS = ENCR+DICHK, RSA-2048 / AES-256

    INITIATOR= OPFTUID

    USER-ADM = OPFTUID
    PARTNER    = BS2PART

    FILENAME = FILE.TEST

    FNC-MODE = *TRANSPARENT

LOGGING-ID    = 9478        RC        = 0000          TIME       = 2016-07-11 14:31:28

    TRANS      = TO          REC-TYPE= FTAC          FUNCTION = TRANSFER-FILE

    PROFILE    =             PRIV      =

    INITIATOR= OPFTUID
    USER-ADM = OPFTUID

    PARTNER    = BS2PART

    FILENAME = FILE.TEST

Long output form outbound (example, openFT >= V12.1C10):

LOGGING-ID  = 111       RC      = 0000        TIME     = 2021-02-11 12:35:35

   TRANS    = TO        REC-TYPE= FT          FUNCTION = TRANSFER-FILE

   PROFILE  =           PCMD    = NONE        STARTTIME= 2021-02-11 12:35:35

   TRANS-ID = 65643     WRITE   = REPLACE     REQUESTED= 2021-02-11 12:35:35

   TRANSFER =        28 kB                    CCS-NAME = IBM1047

   SEC-OPTS = NCR+DICHK, RSA-2048 / AES-256

   INITIATOR= OPFTUID

   USER-ADM = OPFTUID

   PARTNER  = BS2PART

   FILENAME = LOCAL-FILE

   FNC-MODE = *TRANSPARENT

   REMOTE-FN= REMOTE-FILE

Long output form inbound (example)

LOGGING-ID    = 9473        RC        = 0000          TIME       = 2016-07-11 14:25:00

    TRANS      = FROM        REC-TYPE= FT            FUNCTION = TRANSFER-FILE

    PROFILE    =             PCMD      = NONE          STARTTIME= 2016-07-11 14:24:59
    TRANS-ID = 67046       WRITE     = REPLACE       STORETIME= 2016-07-11 14:25:00

    TRANSFER =           1 kB                      CCS-NAME = IBM1047

    SEC-OPTS = ENCR+DICHK+DENCR+DDICHK+LAUTH2+RAUTH2, RSA-1024 / AES-256
    INITIATOR= *REMOTE                           GLOB-ID    = 66279

    USER-ADM = OPFTUID

    PARTNER    = BS2PART
    PTNR-ADDR= BS2PART

    FILENAME = TEST1

    FNC-MODE = *TRANSPARENT

LOGGING-ID    = 9472        RC        = 0000          TIME       = 2016-07-11 14:24:59

    TRANS      = FROM        REC-TYPE= FTAC          FUNCTION = TRANSFER-FILE

    PROFILE    = PROFIL1     PRIV      = NO
    INITIATOR= *REMOTE                           GLOB-ID    = 66279

    USER-ADM = OPFTUID

    PARTNER    = BS2PART
    PTNR-ADDR= BS2PART

    FILENAME = TEST1

Long output format for an ADM log record (example)

LOGGING-ID    = 299120      RC        = 0000          TIME       = 2016-08-29 08:55:12

    TRANS      = TO          REC-TYPE= ADM           FUNCTION = REM-ADMIN
    TRANS-ID = 156730      PROFILE = Profil06

    SEC-OPTS = ENCR+DICHK, RSA-2048 / AES-256

    INITIATOR= *REMOTE                           GLOB-ID    = 17232
    USER-ADM = FTADMIN1

    PARTNER    = REMADMIN

    ADM-CMD    = FTSHWLOG
    ADMIN-ID =

    ROUTING    =

Explanation of long output form (column-wise)

The table below also describes fields and values that can only occur in ADM log records.

Name

Explanation

LOGGING-ID

Number of the log record (up to twelve digits)

TRANS

Transfer direction:

TO

The request direction is to the partner system. This direction
is specified for a

  • send request, i.e. the data is transferred to the partner.

  • request to view remote file attributes

  • request to view remote directories

FROM

The request direction is to the local system (inbound). This
direction is specified for a

  • receive request, i.e. the data are transferred to the local
    system

  • request to modify remote file attributes

  • request to delete remote files

BOTH

File management request with two-way data transfer.

PROFILE

Name of the profile to be used for the transfer (empty in the FT logging record)

TRANS-ID

Transfer ID number

TRANSFER

Amount of data transferred

SEC-OPTS

Security options and encryption algorithms used. This line is only output if at least
one of the options is used.

ENCR

Encryption of the request queue

DICHK

Data integrity check of the request queue

DENCR

Encryption of data content during the transfer

DDICHK

Data integrity check of the file data to be transferred

LAUTH

Authentication of the local system on a partner
(authentication level 1)

LAUTH2

Authentication of the local system on a partner
(authentication level 2)

RAUTH

Authentication of the partner on a local system
(authentication level 1)

RAUTH2

Authentication of the partner on a local system
(authentication level 2)

RSA-nnnn

Length of the RSA key

DES /
AES-128 /
AES-256

Encryption algorithm used

INITIATOR

Initiator (user ID) in the case of requests issued locally issued;
if initiative is from remote system: *REMOTE

USER-ADM

User ID in the local system used by the requests

PARTNER

Provides information about the partner system. The output includes the symbolic
name under which the system administrator has entered the partner system in the
partner list. If dynamic partners are admitted, the partner system can be output as
partner address.

PTNR-ADDR

Address  of the partner system, only output for inbound requests.

FILENAME

Filename resp. preprocessing or postprocessing in local system.
If the file is a library element, the output will be of the format
<Bibliotheksname>/<Typ>/<Elementname>[(<Version>)]. For security
reasons, only the first 32 characters (or 42 characters in the case of FTEXECSV
preprocessing operations) of a preprocessing or postprocessing command are
taken over into the logging record. By arranging the call parameters accordingly or
by inserting spaces, you can influence the command parameters that are not to
appear in the logging record. FTEXECSV is the reaction to an ftexec command
issued in a remote Windows or Unix system.

FNC-MODE

Encoding mode for file names and follow-up processing:

*TRANSPARENT

File names and follow-up processing are represented in a
fixed binary code, independent of local character code
settings (transparent mode).

*CHAR, FNCCS=ccs

File names and follow-up processing are seen in their
character presentation (character mode). ccs specifies the
character set that was relevant for the creation of the FT
request, e.g. iso88591 on Unix systems.

ADM-CMD

Only output for an ADM log record:
Administration command without parameters

ADMIN-ID

Only output for an ADM log record:
Remains always empty in z/OS because only relevant on the remote administration
server

ROUTING

Only output for an ADM log record:
Routing information on the openFT instance to be administered

RC

Reason-Code.
Indicates if a request was successfully executed, or if not, why it was rejected or
terminated. If an FT request is rejected for “FTAC reasons” (e.g. 2169), the exact
reason behind the termination can be found in the FTAC logging record of the
system that rejected the request. Further information on the reason code can be
obtained using the FTHELP xxxx command.

REC-TYPE

Specifies if this is an FT or FTAC or ADM logging record.

PCMD

Status of follow-up processing:

NONE

No follow-up processing defined.

STARTED

Follow-up processing was started.

NOT-STARTED

Follow-up could not be started.

PRIV

specifies whether the admission profile is privileged.

WRITE

Write rules:

NEW

A new file is created. If a file with the same name already
exists, the transfer will be aborted.

EXT

An existing file is extended and stored as new.

REPLACE

An existing file is extended.

TIME

Time when the logging record was written

FUNCTION

Definition of FT function:

  • TRANSFER-FILE: transfer file

  • MOVE-FILE: transfer file and delete send file (only inbound possible)

  • READ-FILE-ATTRIBUTES: read file attributes

  • DELETE-FILE: delete file

  • CREATE-FILE: create new file

  • MODIFY-FILE-ATTRIBUTES: modify file attributes

  • READ-DIRECTORY: read directory

  • CREATE-DIRECTORY: create directory

  • MODIFY-DIRECTORY: modify directory

  • DELETE-DIRECTORY: delete directory

  • LOGIN: inbound FTP access

  • REM-ADMIN: remote administrator

STARTTIME

Time request was started

STORETIME

Time request was accepted (inbound)

REQUESTED

Time request was accepted (outbound)

CCS-NAME

Name of the character set, used for code conversion as necessary.

CHG-DATE

Specifies whether the change date of the send file is taken over for the receive file.

SAME

The change date of the send file is take over.

INITSN

TSN from which the request came, entered only in the case of outbound requests.

GLOB-ID

Global request identification, displayed only in the case of inbound requests from
openFT and FTAM partners (INITIATOR=REMOTE). This corresponds to the
request identification (=TRANSFER-ID) on the initiator system.

REMOTE-FN

From openFT V12.1C10:
Filename in remote system (outbound).

If the file is a library element, the output will be of the format
<library name>/<type>/<element name>[(<version>)].

Examples

  1. The FT administrator wants to display all logging records that were created for the user ID Smith and logged between 01.09.2016 and 31.122016. If you are the owner of the User ID Smith, you can omit the parameter OWNER-IDENTIFICATION=.

    FTSHWLOG SELECT=*PARAMETERS(OWNER-IDENTIFICATION=SMITH,            -

                      CREATION-TIME=*INTERVAL(FROM=2016-09-01(00:00), -

                      TO=2016-12-31(23:59))),NUMBER=*ALL

    You want to see the first record of the output in detail.

    FTSHWLOG (OWN=SMITH,CRE-TIME=*INTERVAL(FROM=2016-09-01(00:00), -

               TO=2016-12-31(00:00))),INF=*ALL

  2. An (FT or FTAC) administrator wants to view all log records. He/She wants all the information to be output in the most compact possible form because he/she wants to back up the log records before deleting them. To do this, he/she combines the specifications for "comprehensive output" and "output in CSV format". This is achieved using the following command:

    FTSHWLOG SELECT=*ALL,NUMBER=*ALL,INF=*ALL,OUTPUT=*STDOUT(*CSV)

    This command may take a few minutes to output comprehensive information.

  3. The FT or FTAC administrator wishes to display the names of the current log file and and current offline log files:

    FTSHWLOG INF=*LOGGING-FILES

      'OPFTUID.STD.SYSLOG.L160802.L093109'

      logoff'OPFTUID.STD.SYSLOG.L160723.L061619'

  4. The FT administrator wants to display all logging records that were created for the filename REMOTE-FILE. The short output will only show the name of the local file.

    /FTSHWLOG SELECT=*PARAMETERS(FILE-NAME=REMOTE-FILE, -
     /                               ),NUMBER=*ALL

    TYP LOG-ID TIME     RC    PARTNER  INITIAT. PROFILE  USER-ADM FILENAME

    2021-03-19

    T    111   12:35:35 0000 >locBS   OPFTUID           OPFTUID  LOCAL-FILE

    To see the remote filename the long output format has to be used:

    /FTSHWLOG SELECT=*PARAMETERS(FILE-NAME=REMOTE-FILE, -

    /                               ),INF=*ALL

    LOGGING-ID  = 111       RC      = 0000        TIME     = 2021-02-11 12:35:35

       TRANS    = TO        REC-TYPE= FT          FUNCTION = TRANSFER-FILE

       PROFILE  =           PCMD    = NONE        STARTTIME= 2021-02-11 12:35:35

       TRANS-ID = 65643     WRITE   = REPLACE     REQUESTED= 2021-02-11 12:35:35

       TRANSFER =        28 kB                    CCS-NAME = IBM1047

       SEC-OPTS = NCR+DICHK, RSA-2048 / AES-256

       INITIATOR= OPFTUID

       USER-ADM = OPFTUID

       PARTNER  = BS2PART

       FILENAME = LOCAL-FILE

       FNC-MODE = *TRANSPARENT

       REMOTE-FN= REMOTE-FILE

Powered by Atlassian Confluence and Scroll Viewport.