4.5 act-file-trns

Use this command to start a file transfer between the system and a remote computer.

Parameters

loc (optional)
The location of the fixed disk to or from which the file is to be uploaded or downloaded.
Range:
1114, 1116

Active and standby TDM locations

Default:
The active TDM location
retries (optional)
The number of times the system retries a packet before giving up.
Range:
1 - 20
Default:
10
timeout (optional)
The number of seconds the system waits for a packet before sending a negative acknowledgment or retransmitting the previous packet. This parameter also specifies the number of seconds to wait for a transfer initiation message from the remote computer.
Range:
1 - 120
Default:
30

Example

act-file-trns:loc=1116

Dependencies

The loc parameter must specify a TDM card.

Only one file transfer can be active at a time.

This command cannot be entered on a telnet terminal (IDs 17-40).

Notes

Output messages indicating transfer initiated and transfer terminated (whether successful or not) are sent to the output devices in the Security Administration output group.

When used to output seculog, the copy-seculog command sends data to the FTA. Extracting seculog data from the FTA requires:

  • A computer with a VT320 or KSR connection to the system
  • A communication program that both emulates VT terminals and supports Kermit file transfer
  • A spreadsheet program that can import Comma Separated Value (CSV) text files

A PC running ProComm© for Windows and Microsoft Excel© can be used.

Extracting seculog file from the FTA

  1. Display the contents of the FTA. Enter disp-fta-dir:loc=xxxx.

    Where xxxx = the active TDM (1114 or 1116)

  2. Delete any existing files from the FTA. Enter dlt-fta:loc=xxxx:all=yes.

    Where xxxx = the active TDM (1114 or 1116)

  3. Enter the command to send seculog to the FTA. For example: copy-seculog:slog=act:dloc=stb:dfile="seculog_copy"

  4. Activate the file transfer. Enter act-file-trns:loc=xxxx.

    Where xxxx = the active TDM (1114 or 1116)

  5. Display a list of the files transferred to the FTA. Enter disp-fta-dir:loc=xxxx.

    Where xxxx = the active TDM (1114 or 1116)

  6. Use the get command from within the communications program configured to run Kermit in ASCII mode to transfer the desired files (with the .csv suffixes) to the PC.

    For example:

    > get seculog_copy.csv

    > finish

  7. After all files are successfully transferred and confirmed, remove the files from the FTA. Enter dlt-fta:loc=xxxx:all=yes.

    Where xxxx = the active TDM (1114 or 1116)

Output

Normal session output to non-Security Administration user's terminal.

act-file-trns:loc=1114:timeout=20:retries=2

    rlghncxa03w 04-01-05 14:37:05 EST  EAGLE 31.3.0
    act-file-trns:loc=1114:timeout=20:retries=2
    Command entered at terminal #1. 
;
    rlghncxa03w 04-01-05 14:37:05 EST  EAGLE 31.3.0
    Awaiting File Transfer with remote.
    Please initiate binary Kermit session on local computer 
;
    rlghncxa03w 04-01-05 14:38:33 EST  EAGLE 31.3.0
    File Transfer : 0 file(s) DOWNLOADED from location 1114 successfully
    File Transfer : 1 file(s) UPLOADED to location 1114 successfully
    File Transfer : Kermit Session terminated NORMALLY

Normal session output to Security Administration group terminals.

act-file-trns:loc=1114:timeout=20:retries=2

    rlghncxa03w 04-01-05 14:40:42 EST  EAGLE 31.3.0
    File Transfer : INITIATED on terminal #1 
;
    rlghncxa03w 04-01-05 14:41:07 EST  EAGLE 31.3.0
    File Transfer: 511_byte.bin UPLOADED to location 1114 successfully. 
;
    rlghncxa03w 04-01-05 14:41:44 EST  EAGLE 31.3.0
    File Transfer : terminated NORMALLY on terminal #1

Normal session output to Security Administration user's terminal.

act-file-trns:loc=1114:timeout=20:retries=2

    rlghncxa03w 04-01-05 14:42:51 EST  EAGLE 31.3.0
    act-file-trns:loc=1114:timeout=20:retries=2
    Command entered at terminal #1. 
;
    rlghncxa03w 04-01-05 14:43:29 EST  EAGLE 31.3.0
    File Transfer : INITIATED on terminal #1 
;
    rlghncxa03w 04-01-05 14:43:53 EST  EAGLE 31.3.0
    Awaiting File Transfer with remote.
    Please initiate binary Kermit session on local computer
    rlghncxa03w 04-01-05 14:44:19 EST  EAGLE 31.3.0
    File Transfer: 511_byte.bin UPLOADED to location 1114 successfully. 
;
    rlghncxa03w 04-01-05 14:44:52 EST  EAGLE 31.3.0
    File Transfer : 0 file(s) DOWNLOADED from location 1114 successfully
    File Transfer : 1 file(s) UPLOADED to location 1114 successfully
    File Transfer : Kermit Session terminated NORMALLY 
;
    rlghncxa03w 04-01-05 14:45:31 EST  EAGLE 31.3.0
    File Transfer : terminated NORMALLY on terminal #1 
;