For UNIX Systems

Job Management Partner 1/File Transmission Server/FTP

Description, Reference and Operator's Guide

3020-3-S37(E)


Contents

Notices
Preface

1. Overview of JP1/FTP
1.1 Features
1.2 Functions
1.2.1 Functions depending on the OS
1.2.2 File transmission function
1.2.3 Operations-Manager function
1.2.4 JP1 program linkage function
1.3 Flow of JP1/FTP operations
1.3.1 Registering JP1/FTP definition information
1.3.2 Transmitting a file
1.3.3 Saving and recovering JP1/FTP settings
1.3.4 Checking the JP1/FTP definition information for another host

2. Installation and Setup
2.1 JP1/FTP system configuration
2.1.1 Basic system configuration
2.2 Installing and uninstalling
2.3 Setting up
2.3.1 Setting the path
2.3.2 Setting the language type
2.3.3 Setting the port numbers
2.3.4 Setting the system log
2.4 Starting and terminating JP1/FTP
2.4.1 Starting and terminating the JP1/FTP daemon
2.4.2 Starting and terminating the Operations-Manager Agent
2.4.3 Starting and terminating the log daemon

3. File Transmission by JP1/FTP
3.1 Defining an environment for JP1/FTP
3.1.1 Defining an environment for JP1/FTP
3.1.2 Checking the JP1/FTP environment
3.1.3 Using environment variables to define a JP1/FTP environment
3.2 Registering the users who can log in to a JP1/FTP server
3.3 Registering auto-start programs
3.3.1 Registering auto-start programs
3.3.2 Changing auto-start programs
3.3.3 Deleting auto-start programs
3.3.4 Checking the registered information about auto-start programs
3.3.5 Changing how information is displayed in the Auto-Start Program Registration window
3.4 Registering transmission information
3.4.1 Registering transmission information onto a transmission card
3.4.2 Changing the information registered on a transmission card
3.4.3 Deleting transmission cards
3.4.4 Checking the contents of a transmission card
3.5 Transmitting files
3.5.1 Executing transmission by specifying a transmission card (Select Card method of file transmission)
3.5.2 Executing transmission by entering a transmission card (Enter Information method of file transmission)
3.6 Checking the transmission logs
3.6.1 Using the Log Information window to check the details of transmission results and errors
3.6.2 Changing the information displayed in the Log Information window
3.6.3 Changing the log file that is displayed in the Log Information window
3.6.4 Using the ftshistory command to display logs
3.7 Saving and recovering JP1/FTP settings
3.7.1 Information that can be saved and recovered
3.7.2 Saving and recovering JP1/FTP settings
3.8 Outputting definition information as text
3.8.1 Outputting definition information as text
3.9 Function for controlling remote logins
3.9.1 How to specify
3.9.2 Examples of definition
3.9.3 Notes
3.10 Event log function
3.10.1 Starting output of event logs to a file
3.10.2 Stopping output of event logs to a file
3.11 File transmission in the PASV mode
3.11.1 Registering the host name
3.11.2 Notes
3.12 Changing the maximum number of concurrent transmissions
3.13 Function for controlling remote host connections
3.13.1 Registering host names
3.13.2 Notes
3.14 Function for limiting directory access
3.14.1 Registering user names
3.14.2 User environment settings with the function for limiting directory access enabled
3.14.3 Notes
3.15 Using JP1/FTP in a multiple IP address environment
3.15.1 How to specify
3.15.2 Definitions for each function
3.15.3 Note
3.16 Collecting access logs
3.16.1 Settings for collecting access logs
3.16.2 Access log output file
3.16.3 Messages that are output to the access logs
3.17 FTP connection response message control function
3.17.1 Definition method
3.17.2 FTP connection response message that is displayed

4. JP1/FTP Operations Management
4.1 Setting up the Operations-Manager Console
4.1.1 Adding managed hosts
4.1.2 Deleting managed hosts
4.2 Organization and functions of the Operations-Manager Console windows
4.2.1 Environment Definition window
4.2.2 Auto-Start Program Registration window
4.2.3 Transmission Registration window
4.2.4 Log Information window
4.3 Examples of Operations-Manager Console menu operations
4.3.1 Example of registering transmission information
4.3.2 Example of distributing (copying) transmission information
4.3.3 Example of displaying log information
4.3.4 Example of outputting multiple registration information items as text

5. Linkage with Other JP1 Programs
5.1 Linking to JP1/AJS3
5.1.1 System configuration for linking to JP1/AJS3
5.1.2 Specifying the settings for linking to JP1/AJS3
5.1.3 Performing scheduled transmissions
5.2 Linking to JP1/IM
5.2.1 System configuration for linking to JP1/IM
5.2.2 Specifying the settings for linking to JP1/IM
5.2.3 Starting the services
5.2.4 Monitoring transmission results by JP1/IM

6. Commands
List of commands
Details of commands
jftsd - starts the JP1/FTP daemon
ftsstop - terminates the JP1/FTP daemon
ftsdefine - displays the Environment Definition dialog box
ftsutil - changes and displays environment information
ftsauto - displays the Auto-Start Program Registration window
ftsautoma - registers, deletes, and displays auto-start programs
ftsclient - displays the Registration And Execution Of Transmission Requests window
ftstran - executes transmission
ftsregc - registers, changes, deletes, and displays transmission information
ftsregcv - displays transmission information
ftshist - displays the Log Information window
ftshistory - displays log information
ftsconsole - starts the Operations-Manager Console
jftsa - starts the Operations-Manager Agent
ftsastop - terminates the Operations-Manager Agent
jftslogd - starts the log daemon
ftslogstop - terminates the log daemon
jftsdstatus - checks the JP1/FTP daemon status
jftsastatus - checks the Operations-Manager Agent status
jftslogdstatus - checks the log daemon status

7. API Library
How to use the library
Example of library usage
List of functions
Details of functions
fts_ftp_open() - establish connection with the JP1/FTP daemon
fts_ftp_syn_request_ex() - register transmission requests (synchronous)
fts_ftp_asyn_request_ex() - register transmission requests (asynchronous)
fts_ftp_event_ex() - obtain the transmission-end results
fts_ftp_close() - release connection with JP1/FTP
fts_ftp_get_card_info() - obtain transmission information
fts_ftp_buftoll() - reference the full_trans_size and full_trans_size_comp transmission-end structure members

8. Messages
8.1 Format of displayed messages
8.1.1 Format of message explanations
8.2 List of messages
8.2.1 Messages related to the JP1/FTP daemon
8.2.2 Messages related to file transmission (client)
8.2.3 Messages related to file transmission (server)
8.2.4 Messages issued by the ftsstop command
8.2.5 Messages issued by the ftstran command
8.2.6 Messages issued by the ftsutil command
8.2.7 Messages issued by the ftsregc command
8.2.8 Messages issued by the ftsautoma command
8.2.9 Messages issued by the ftshistory command
8.2.10 Messages issued by the ftsregcv command
8.2.11 Messages issued by the Operations-Manager Agent
8.2.12 Messages issued by the ftsastop command
8.2.13 Messages issued by the ftsconsole command
8.2.14 Messages related to the log daemon
8.2.15 Messages issued by the ftslogstop command
8.2.16 Messages issued by the jftsdstatus command
8.2.17 Messages issued by the jftsastatus command
8.2.18 Messages issued by the jftslogdstatus command
8.3 Event log messages
8.3.1 Output format of event log messages
8.3.2 Format of event log message explanations
8.3.3 List of event log messages
8.4 Access log messages
8.4.1 Output format of access log messages
8.4.2 Format of access log message explanations
8.4.3 List of access log messages
8.5 Details of error numbers

9. Troubleshooting
9.1 Error handling procedures
9.2 Types of log information
9.2.1 Common message log
9.2.2 Trace log output by JP1/FTP
9.3 Data to collect when a problem occurs
9.3.1 Log information about the operating system (OS)
9.3.2 Information about JP1/FTP
9.3.3 List of JP1/FTP processes
9.3.4 Operation information
9.3.5 Error information on screen displays
9.3.6 How to collect data

Appendixes
A. List of Files and Directories
B. Port Numbers
B.1 List of port numbers
B.2 Firewall passage directions
B.3 Items to check when performing transmission via a firewall
C. List of Processes
D. JP1 Events
D.1 List of JP1 events
D.2 Attributes of JP1 events
E. Format Files Used for Output of Definition Information
E.1 Creating a format file
F. Specification of Fonts for GUI Windows (X Windows)
G. Transmission Rejection Messages
H. Log Information Deletion Tool after Changing the Maximum Number of Concurrent Transmissions
I. Notes about Operation
J. Changes in Each Version

Index

[Trademarks]

All Rights Reserved. Copyright (C) 2010, Hitachi, Ltd.