Messages and return codes automatically issued by openFT (z/OS)

openFT sends you automatically, i.e. without your needing to make a specific request, a message indicating acceptance or rejection of the file transfer request immediately after it has been submitted.

The request confirmation or rejection is issued to the TSO terminal from which the NCOPY command was entered.

At the same time, a return code is entered in system variable &LASTCC ("control variable") indicating whether the NCOPY command (not the file transfer request) has been successful. The return codes are described in the section “Introduction to the NCOPY command”.

If a result list is requested in the NCOPY command and this result list is automatically printed out by openFT (LISTING=*SYSLST, see the operand description for LISTING in the section “Full form of the NCOPY command”), an asynchronous message indicating termination of the print job is additionally issued to the TSO user whose user ID was specified in the TRANSFER-ADMISSION for the local system. This message is generated by means of the job parameter NOTIFY in the appropriate format.

Example of a NOTIFY message:

14.04.24 JOB05252 $HASP165 OPFTWITY ENDED AT P391  MAXCC=0 CN(INTERNAL)
   |         |                |
   |         |              Name of the print job(see below)
   |       Job number of the print job
 Current time of the print job, format hh.ss.ss (hour.minute.second)

This message does not contain the job ID and does not indicate whether the file transfer was successful.

(This type of message is only issued if the job used to print out the result list contains a NOTIFY parameter; please consult your FT administrator.)

The FT administrator can also set openFT so that, once a transfer request is completed, an asynchronous message is issued to the TSO user whose user ID was specified in the TRANSFER-ADMISSION for the system involved.

(openFT can only issue this type of message if it is "APF authorized"; please consult your FT administrator.)

The FT administrator can specify the circumstances under which this type of message is to be output.

The FT administrator can also determine the text of these messages. Unless otherwise specified, the following default messages are issued:

• following successful file transfer:

  FJM 2100 FILE TRANSFERRED, TRANS_ID:nnnnnnnnnn

• following unsuccessful file transfer:

  FJM 2101 FILE NOT TRANSFERRED, TRANS_ID:nnnnnnnnnn

where "nnnnnnnnnn" is the ID of the file transfer request in the system involved.

openFT uses the TSO command SEND with the LOGON specification for issuing these messages. This means that

• the user, if already logged on to a TSO terminal, receives the message immediately. Otherwise, the user receives the message immediately after logging on.

• the user can suppress the output of these messages and other messages created by means of the SEND command (TSO command PROFILE NOINTERCOM) and cancel this suppression (PROFILE INTERCOM).

The FT administrator can also specify whether or not console traps are to be output. If console traps are output, the message FTR0340 (success) or FTR0341 (failure) is generate for each request provided that the request was entered in the request queue.