Transfer CFT catalog query services

Call syntax

CALL     "CFTI"     USING     <verb>       <blk>       <param>     <rc>

Where:

  • <verb> is the command that you want to process
  • <blk> is a Transfer CFT specific field that must not be changed by the application
  • <param> is a character string of variable length that contains the command parameters. The end of the field is defined by a character initially set to low-value
  • <rc> is the return code

The available <verbs> are listed in the following table.

<verb>

Value

Service

F-OPEN

OPEN

Open catalog

F-SELECT

SELECT

Define selection criteria

F-NEXT

NEXT

Read next entry

F-MODIFY

MODIFY

Modify catalog entry state

F-CLOSE

CLOSE

Close catalog

The available <param> are listed in the following table.

<verb>

<param>

Explanation

F-OPEN

D-CAT

Path name or logical name of the catalog file. If the name is blank, Transfer CFTI uses a default name.

F-SELECT

Z-SEL

Selection criteria according to the format described in the "S election data description" in the cft.apicop file. If a field is blank or equal to binary zeros, it is considered not selective.

This field can contain:

  • the size of the selection criteria field (SLENTGTH) and the size of the field supporting the catalog entry (CLENGTH) in order to avoid recompiling the application program if these two fields are extended.
  • the transfer start and end date (BDATE and EDATE) to select transfers performed between these two dates.
  • a mask with the special characters "?" and *". The "?" character replaces any character. The "*" character replaces a character string of any length.

    Examples:
    A*D replaces ABCD, ABCED or AID
    A??D replaces ABCD, AXYD or AQZD
    *CD replaces ABECD, YXZCDor TYUICD
    ?CD replaces ACD, XCD or ZCD
    ?B* replaces ABCDEF, XBZWEO or *KBWXCV
    ???? replaces ABCD, XYZW or HGFD

F-NEXT

Z-CAT

Next catalog entry according to the format described in the "S election data description" in the cft.apicop file.

The length of this field is defined by the SELECT service. See the CLENGTH field in the Selection data description.

F-MODIFY

M-STATE

New state of a transfer to be placed in the catalog entry previously read:

  • ‘D’ at Disposal: only valid if the former state is H or K
  • ‘H’ Hold: only valid if the former state is D, C or K
  • ‘K’ Keep: only valid if the former state is D, C or H
  • ‘X’ eXecuted: only valid if the former state is T
  • ‘P’ Purge:  deletes the catalog entry

F-CLOSE

 

No <param> needed

Return codes

The return codes listed below apply to all services.

Mnemonic

Description

CAPI-NOERR

No error

CAPI-FUNC-UNDEF

Command not valid

CAPI-INT-BLK

<blk> parameter invalid

OPEN code only

CAPI-MEM-GET

Memory allocation error

CAPI-CAT-ALLOC

Catalog file allocation error

CAPI-CAT-OPEN

Catalog file opening problem

SELECT code only

CAPI-SEL-DIRECT

DIRECTION criterion incorrect

CAPI-SEL-TYPE

TYPE criterion incorrect

CAPI-SEL-STATE

STATE criterion incorrect

CAPI-CAT-EMPTY

Catalog empty

CAPI-SEL-DATE

EDATE value < BDATE value

CAPI-SEL-FDATE

FDATE criterion incorrect

CAPI-SEL-CDATE

CDATE criterion incorrect

CAPI-SEL-BDATE

BDATE criterion incorrect

CAPI-SEL-DATE

EDATE criterion incorrect

NEXT code only

CAPI-CAT-EOF

End of catalog file

CAPI-CAT-READ

Catalog file read error

MODIFY code only

CAPI-MOD-OSTATE

State invalid

CAPI-MOD-NSTATE

Requested new state incorrect

CAPI-INT-ERR2

Internal error

CAPIO-COM-OPEN

Communication medium opening error

CAPI-COM-WRITE

Communication medium write error

CAPI-COM-CLOSE

Communication medium closing problem

CLOSE code only

CAPI-MEM-FREE

Memory de-allocation error

CAPI-CAT-FREE

Catalog file de-allocation error

CAPI-CAT-CLOSE

Catalog file closing error

Related Links