Return information and error displays

After every CALL macro to openFT (BS2000), return information is provided in the structure FT-RETURN-INFO.

FT-RETURN-INFO

The range FT-RETURN-INFO describes the return information returned by openFT (BS2000). FT-RETURN-INFO must be defined in the WORKING-STORAGE SECTION and can be copied to there with the statement

COPY FTRETC OF linkname.

FT-RETURN-INFO is defined as follows:

 01  FT-RETURN-INFO.
     05 FILLER                  PIC X(4)   VALUE "V300".
     05 TRANSFER-ID             PIC X(10).
*
     05 FT-RETURN-CODE.
         10 MAIN-RETURN-CODE    PIC S9(5) COMP.
             88 OKAY                       VALUE 0.
         10 SUB-RETURN-CODE     PIC S9(5) COMP.
*
         10 DMS-RETCODE         PIC X(8).
         10 LINK-RETCODE REDEFINES DMS-RETCODE PIC X(8).
*

The version specification at the beginning of the structure FT-NCOPY-LIST serves to identify the COPY element and must not be overwritten.

Description of the data fields

TRANSFER-ID

The fields contains

• after a successful NCOPY macro, the transfer ID of the generated request (left-justified, filled with right-justified blanks)
  or

• after an unsuccessful NCOPY macro, the character string ’##########’.

For a NCANCEL-/NSTATUS macro, the fields remains unchanged.

For a NMOD-/NSHOW-/NDEL-/NLMOD- or NLSHOW macro, the field has no meaning.

FT-RETURN-CODE

This field contains the return messages.

Set-up of the FT-RETURN-CODE field

The return code field is set up as follows:

The field with the return code meets the conventions for return codes as of BS2000 Version 9.