NCAN - Dateiübertragungsauftrag abbrechen

Mit dem Makroaufruf NCAN können Sie einen FT-Auftrag zurücknehmen bzw. die Dateiübertragung abbrechen. openFT löscht den FT-Auftrag, der den angegebenen Auswahlkriterien entspricht, im FT-Auftragsbuch und bricht gegebenenfalls die zugehörige Dateiübertragung ab. Der Funktionsumfang entspricht dem im Handbuch "openFT (BS2000) - Kommandoschnittstelle" beschriebenen Kommando CANCEL-FILE-TRANSFER (NCANCEL).

Format des Makros NCAN (LIST-Form/Standard-Form)

Name	Operation	Operanden
[name]	NCAN	[MF=L,]  [TRANSID=adr]  [,SOWNER=adr]  [,PARTNER=adr]  [{,LFILE=adr/    ,LLIB=adr[,LEL=adr][,LELVER=adr][,LELTYP=adr]}]  [,JVNAME=adr]  [,JVPASS=adr]  [,INIT={BOTH / LOCAL / REMOTE}]  [,FORCE={NO / YES}  [,Version={1 / 2}]

Format des Makros NCAN (DSECT-Form)

Name	Operation	Operanden
[name]	NCAN	MF=(D[,xxx])

Das Präfix xxx (Standardwert YNA) darf 1 bis 3 Zeichen lang sein. Er muss Namen erzeugen, die in ASSEMBLER erlaubt sind. Folgende ASSEMBLER-Instruktionen werden abgesetzt:

xxxNCAN  DSECT
xxxHCAN  FHDR  MF=(C,&P)
xxxTRID  DS    A                       A(TRANSFER-ID)
xxxTRIDL DS    XL2                     L(TRANSFER-ID)
xxxLNCA1 EQU   *-xxxNCAN               L(MACRO VERSION 1)
*
xxxSOWNL DS    XL2                     L(OWNER-ID)
xxxSOWN  DS    AL4                     A(OWNER-ID)
xxxPART  DS    AL4                     A(PARTNER-SYSTEM)
xxxPARTL DS    XL2                     L(PARTNER-SYSTEM)
xxxLFILL DS    XL2                     L(FILE-NAME)
xxxLFIL  DS    AL4                     A(FILE-NAME)
xxxLLIB  DS    AL4                     A(LIBRARY-NAME)
xxxLLIBL DS    XL2                     L(LIBRARY-NAME)

xxxLELL  DS    XL2                     L(ELEMENT-NAME)
xxxLEL   DS    AL4                     A(ELEMENT-NAME)
xxxLEV   DS    AL4                     A(ELEMENT-VERSION)
xxxLEVL  DS    XL2                     L(ELEMENT-VERSION)
xxxLETYL DS    XL2                     L(ELEMENT-TYPE)
xxxLETY  DS    AL4                     A(ELEMENT-TYPE)
xxxJVNM  DS    AL4                     A(JV-NAME)
xxxJVNML DS    XL2                     L(JV-NAME)
xxxJVPSL DS    XL2                     L(JV-PASSWORD)
xxxJVPS  DS    AL4                     A(JV-PASSWORD)
xxxINIT  DS    XL1                     INITIATOR
*
xxxIBOTH EQU   0                       INITIATOR = BOTH
xxxILOC  EQU   192                     INITIATOR = LOCAL
xxxIREM  EQU   128                     INITIATOR = REMOTE
*
&P.LNCA2  EQU   *-&.NCAN               L(MACRO VERSION 2)
*
&P.FORCE DS    XL1                     FORCE-CANCELLATION
xxxFNO   EQU   X’00’                   FORCE = NO
xxxFYES  EQU   X’01’                   FORCE = YES
*
xxxLNCA EQU *-xxxNCAN

Bedeutung der Felder

Mit dem Makroaufruf NCAN stehen Ihnen dieselben Möglichkeiten offen, wie mit dem Kommando CANCEL-FILE-TRANSFER (NCANCEL), beachten Sie daher bitte die entsprechende Kommandobeschreibung. Die folgende Tabelle ordnet die Parameter im Makroaufruf NCAN den Operanden des Kommandos zu:

Operand (L-Form)	Adressfeld (D-Form)	Bedeutung im Kommando
TRANSID	TRID	TRANSFER-ID
SOWNER	SOWN	OWNER-IDENTIFICATION
PARTNER	PART	PARTNER-NAME
LFILE	LFIL	FILE-NAME
LLIB	LLIB	LIBRARY
LEL	LEL	ELEMENT
LELVER	LEV	VERSION
LELTYP	LETY	TYPE
JVNAME	JVNM	MONJV
JVPASS	JVPS	JV-PASSWORD
INIT	INIT	INITIATOR
FORCE	FORCE	FORCE-CANCELLATION
VERSION	FCTV	(Art der Returncode-Ausgabe (alt/neu))1

¹In Abhängigkeit vom Wert des Operanden VERSION, wird im Header FHDR die FUNCTION INTERFACE VERSION NUMBER gesetzt.

Wenn Sie in den Feldern für die OWNER-ID nichts angeben, wird Ihre eigene Kennung als Wert eingesetzt (das entspricht der Angabe des Standard-Wertes *OWN an der Kommandoschnittstelle. Füllen Sie das Feld für OWNER-ID explizit mit Leerzeichen auf, so werden alle Benutzerkennungen eingesetzt (das entspricht der Angabe von *ALL an der Kommandoschnittstelle).

Der Wert FORCE=YES darf nur gesetzt werden, wenn Sie im Adressfeld TRID explizit eine Transfer-ID spezifiziert haben. Dieser Auftrag muss vorher bereits einmal mit dem Aufruf FORCE=NO abgebrochen worden sein. Die Angabe von FORCE=YES ist nur unter der Kennung erlaubt, die das FT-ADM Privileg besitzen.