openFT V12.1C (en)

&pagelevel(4)&pagelevel

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

%LOGGING-ID = 38735 RC = 0000 TIME = 2016-07-11 13:58:21

% TRANS = TO REC-TYPE= FT FUNCTION = TRANSFER-FILE
% PROFILE = PCMD = NONE STARTTIME= 2016-07-11 13:58:21

% TRANS-ID = 721206 WRITE = REPLACE REQUESTED= 2016-07-11 13:58:21

% TRANSFER = 10 kB CCS-NAME =
% SEC-OPTS = ENCR+DICHK, RSA-1024 / AES-256

% INITIATOR= TSOS INITSN = 83VV

% USER-ADM = TSOS
% PARTNER = LINUX01

% FILENAME = $USER1.FILE.TEST

% FNC-MODE = *TRANSPARENT

%LOGGING-ID = 38734 RC = 0000 TIME = 2016-07-11 13:58:21

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

% PROFILE = PRIV =

% INITIATOR= TSOS INITSN = 83VV
% USER-ADM = TSOS

% PARTNER = LINUX01

% FILENAME = $USER1.FILE.TEST

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

%LOGGING-ID = 113 RC = 0000 TIME = 2021-02-02 17:18:53

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

% PROFILE = PCMD = NONE STARTTIME= 2021-02-02 17:18:53

% TRANS-ID = 86017 WRITE = REPLACE REQUESTED= 2021-02-02 17:18:52

% TRANSFER = 32 kB CCS-NAME =

% INITIATOR= TSOS INITSN = 0AEJ

% USER-ADM = TSOS

% PARTNER = LOCSIN

% FILENAME = $USER1.LOCAL-FILE

% FNC-MODE = *TRANSPARENT

% REMOTE-FN= $USER1.REMOTE-FILE

Long output form inbound (example)

LOGGING-ID = 38733 RC = 0000 TIME = 2016-07-11 13:49:44

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

% PROFILE = PCMD = NONE STARTTIME= 2016-07-11 13:49:44
% TRANS-ID = 721204 WRITE = REPLACE STORETIME= 2016-07-11 13:49:44

% TRANSFER = 1 kB CCS-NAME =

% CHG-DATE = SAME
% SEC-OPTS = ENCR+DICHK+DENCR+DDICHK, RSA-1024 / AES-256

% INITIATOR= *REMOTE GLOB-ID = 66277

% USER-ADM = USER1
% PARTNER = LINUX01

% PTNR-ADDR= LINUX01

% FILENAME = TEST1
% FNC-MODE = *CHAR, FNCCS=iso88591

LOGGING-ID = 38732 RC = 0000 TIME = 2016-07-11 13:49:44

% TRANS = FROM REC-TYPE= FTAC FUNCTION = TRANSFER-FILE
% PROFILE = PROF1 PRIV = NO

% INITIATOR= *REMOTE GLOB-ID = 66277

% USER-ADM = USER1
% PARTNER = LINUX01

% PTNR-ADDR= LINUX01

% FILENAME = TEST1

Long output format for an ADM log record (example)

LOGGING-ID = 45067 RC = 0000 TIME = 2016-08-29 09:43:57

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

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

INITIATOR= *REMOTE GLOB-ID = 192929
USER-ADM = FTADMIN8

PARTNER = REMADMIN

ADM-CMD = SHOW-FT-LOGGING-RECORDS
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
PROTECT	Specifies whether the protection attributes are transferred. Is only output if this option was specified in the transfer request.
	SAME	The protection attributes of the file were 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 via FTP protocol. For requests using the openFT or FTAM protocol the BCAM processor name is output.
FILENAME	Filename resp. preprocessing or postprocessing in local system. If the file is a library element, the output will be of the format <library name>/<type>/<element name>[(<version>)].
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 BS2000 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 BS2000 command HELP-MSG-INFORMATION (FTCxxxx for FTAC type or FTRxxxx for FT type).
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>)].

¹When modifying the access rights of a file from an FTAM partner system, two logging records are written. In this case, no direction is specified before the PARTNER output.

Examples

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=.

/SHOW-FT-LOGGING-RECORDS 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.

/SHOW-FT-LOG-REC (OWN=Smith,CRE-TIME=*INTERVAL(FROM=2016-09-01(00:00), -

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

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:
/SHOW-FT-LOG-REC SELECT=*ALL,NUMBER=*ALL,INF=*ALL,OUTPUT=*SYSLST(*CSV)
This command may take a few minutes to output comprehensive information.
The FT or FTAC administrator wishes to display the names of the current log file and and current offline log files:
/SHOW-FT-LOG-REC INF=*LOGGING-FILES
% $SYSFJAM.SYSLOG.L160806.L132626
% $SYSFJAM.SYSLOG.L160806.L132615

The openFT 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.

/SHOW-FT-LOGGING-RECORDS SELECT=*PARAMETERS(FILE-NAME=REMOTE-FILE, -

/ ),NUMBER=*ALL

%TYP LOGG-ID TIME RC PARTNER INITIATOR INIT USER-ADM FILENAME

%2021-03-19

%T 113 17:18:53 0000 >LOCSIN TSOS 0AEJ TSOS $USER1.LOCAL-FILE

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