Transfer CFT 3.2.2 Users Guide 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
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