Frequently asked questions

What is the shortest form of the NCOPY command?

In order to send a file to a partner system, it is usually sufficient to issue the following command. The entries to be replaced begin with lowercase letters:

Any FTAC transfer admission defined in the remote system (e.g. TRANSADM) may be entered for transAd. Alternative input: (user,acc,passwd).

You can also use the same entry for partners on Unix systems, provided, of course, that you do not object to entering the file name in uppercase letters in Unix systems.

The entry will also work for Windows partners, provided the file name is syntactically allowed there.

Please note that you should generally always specify only guaranteed abbreviations in procedures (e.g. *ANY instead of A) to remain independent of the current FT version being used.

How do I determine which FT requests have succeeded and which ones have failed?

The logging records output by:

FTSHWLOG

shows you the result of the last transfer.

/SHOW-FT-LOG ,n

FTSHWLOG ,n

The most recent entry is displayed first.

You can also select logging records using different criteria (e.g. partner, file name, etc.). Note that when openFT-AC is used, two entries are recorded for each NCOPY request: the first entry is the FTAC entry, which is identified by a C in the first column, and the second entry, which follows the first, contains the result of the transfer (identified with T).

If you want to see only the results of the transfer, enter:

FTSHWLOG (REC-TYPE=(,N)),n

How does one detect whether an error has occurred on the local or remote system?

The following rules apply:

If the NCOPY command is not accepted with FTR0000, but is rejected immediately instead, the error always lies on the local system.

For NCOPY commands that are rejected after being accepted with FTR0000, the error is almost always on the remote system. As of openFT V10, it is also possible to identify the origin of the problem from the message. If the reason for the rejection is FTR2169 Remote system: Transfer admission invalid, the cause in this case always lies in the remote system.

In cases where the partner cannot be reached at all (e.g. FTR0108), the situation is more ambiguous, and there is generally no way of knowing on which side the problem occurred.

Why was my FT request rejected even though I entered a correct transfer admission?

It is indeed possible for a request to be rejected despite a correctly specified transfer admission (in the form (user,accout,password), for example) or TRANSADM. This is because your request could also be rejected if the transfer admission does not allow you to execute all the actions you want. Here are some potential reasons:

• The user ID is locked on the remote system (e.g. by SEVER/LOCK-USER in BS2000).

• The remote system is not allowing any requests which use transfer admissions of the form (user, account,password), since all levels in the FTAC admission set have been set to 0.

• The desired direction of transfer or your system was rejected by the partner.

• The partner system does not allow the desired function, e.g. follow-up processing or even file management.

In addition, the transfer admission is often specified in uppercase instead of lowercase, and vice versa, especially when given over the phone. Uppercase letters can be effectively specified only within quotes.

Finally, it is possible that the transfer admission you specified was really invalid.

My call was rejected with FTR2169 Remote system: Transfer admission invalid. How do I find out the reason?

You have entered an NCOPY command that was accepted with FTR0000. It was then aborted with FTR2169.

The rejection comes from the partner system. Consequently, the cause can only be determined there.

With openFT products, the reason can be easily determined from the FTAC logging record.

To do this, ask your partner to display the last logging record or the last n logging records under the receiving ID:

• In BS2000 with /SHOW-FT-LOG [,n]

• In z/OS with FTSHWLOG [,n]

• In a Unix system and a Windows system with ftshwl [-nb=n] or via the respective graphical user interface.

Using the partner, file name, time, etc., as reference points, you will first need to look for the matching FTAC entry (type C or FTAC). The reason for the rejection will be given in the RC column. The meaning of the RC is output directly on a graphical user interface; it can be explicitly requested with /HELP FTCnnnn in BS2000 and with fthelp nnnn in Unix system or Windows system (where nnnn is the RC).

If your partner cannot find any logging record for your request, you have either not contacted the correct partner, or the specified transfer admission does not belong to the expected receiving ID. This could be primarily because the transfer admission does not exist (especially if you entered it incorrectly, for example).

What is an FTAC transfer admission and how can I set one up?

The normal way to identify oneself on a remote system is via the logon entries, i.e., the user ID, account number (only under BS2000 and z/OS) and password:
Operand TRANSFER-ADMISSION=(user-id,account,password).

A simpler method is to use a special authorization exclusively for the file transfer. This is named FTAC transfer admission or shortly transfer admission (TRANSFER-ADMISSION=transAdm). In order to avoid exposing all the details of his/her entire logon authorization, the owner of the transfer admission sets up a so-called admission profile as follows:

• In BS2000: /CREATE-FT-PROFILE name,,transAdm

• In z/OS: FTCREPRF name,,transAdm

• In a Unix system or a Windows system with ftcrep name transAdm or via the respective graphical user interface with File / New / Admission Profile.

In the above entries, name is the name under which the profile can be administered (e.g. deleted again) and may be up to 8 characters in length. transAdm is the admission which is assigned by the partner and which you specify in your FT command, and must be at least 8 characters. If blanks or other special characters appear in it or if a distinction between uppercase and lowercase letters is to be made, the entry must be enclosed within single quotes.

Under BS2000 and z/OS, admission profiles can be set up only on systems with openFT-AC.