NLMOD - Lokale FT-Dateiattribute ändern

Mit dem Makroaufruf NLMOD können Sie die FTAM-Attribute einer Datei im lokalen System ändern und die Attribute so anpassen, wie Sie für einen Dateiübertragungs- oder Dateima-nagement-Auftrag mit einem FTAM-Partner zur Verfügung stehen sollen. Der Funktionsumfang entspricht dem Kommando MODIFY-FILE-FT-ATTRIBUTES.

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

Name	Operation	Operanden
[name]	NLMOD	[MF=L,]  FILE=adr  [,FPASS={*NONE / adr}]  [,PERMACT=[*]UNCHG  /      [,PREADF={[*]NO / [*]YES}]      [,PINSU={[*]NO / [*]YES}]      [,PREPLF={[*]NO / [*]YES}]      [,PEXTDF={[*]NO / [*]YES}]      [,PERAU={[*]NO / [*]YES}]      [,PREADA={[*]NO / [*]YES}]      [,PCHNGA={[*]NO / [*]YES}]      [,PDELF={[*]NO / [*]YES}]  [,TRATT=[*]UNCHG  /      [,DATA={[*]UNCHG / [*]BIN / [*]CHAR}]                [,DCHRS={[*]GRSTR / [*]GENER / [*]IA5 /                         [*]VISIB}]      [,RECFORM=[*]UNCHG]      [,RECSIZE={*UNCHG / int}]  [,MSGINS={*NONE / adr}]  [,AFPASS={[*]GRAPH / [*]OCTET}]  [,Version={1 / 2}]

 

Format des Makros NLMOD (DSECT-Form)

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

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

xxxNLMO  DSECT
xxxHLMO  FHDR  MF=(C,&P)
xxxFILE  DS    A                    A(FILE-NAME)
xxxFILEL DS    XL2                  L(FILE-NAME)
xxxFPASL DS    XL2                  L(FILE-PASSWORD)
xxxFPAS  DS    A                    A(FILE-PASSWORD)
xxxMSG   DS    A                    A(MESSAGE)
xxxMSGL  DS    XL2                  L(MESSAGE)
*
xxxIFPAS DS    XL1                  FILE-PASSWORD: NONE
xxxIREC  DS    XL1                  RECORD-SIZE: UNCHG
xxxRECS  DS    XL4                  (RECORD-SIZE)
*
xxxTRATT DS    XL1                  TRANSFER-ATTRIBUTES: UNCHG / PAR
xxxDATA  DS    XL1                  DATA-TYPE: UNCHG / BIN / CHAR
xxxCHRS  DS    XL1                  CHAR.SET: GRSTR/GENER/IA5/VISIB
xxxRECF  DS    XL1                  REC.FORMAT: UNCHG
*
xxxPACT  DS    XL1                  PERMITTED-ACTIONS: UNCHG / PAR
xxxPREAF DS    XL1                  READ-FILE:         NO / YES
xxxPINSU DS    XL1                  INSERT-DATA-UNIT:  NO / YES
xxxPREPF DS    XL1                  REPLACE-FILE:      NO / YES
*
xxxPEXTF DS    XL1                  EXTEND-FILE:       NO / YES
xxxPERAU DS    XL1                  ERASE-DATA-UNIT:   NO / YES
xxxPREAA DS    XL1                  READ-ATTRIBUTES:   NO / YES
xxxPCHNA DS    XL1                  CHANGE-ATTRIBUTES: NO / YES
*
xxxPDELF DS    XL1                  DELETE-FILE:       NO / YES
xxxAPAS  DS    XL1                  TYPE-FILE-PASSWORD: GRAPH/OCTET
*
xxxSFPWD DS    XL1                  SET / RESET FILE-PWD: NO / UNCHG
xxxRESRV DS    XL1                  RESERVED
*
xxxFPWD  DS    A                    A(FILE-PASSWORD FOR SET)
xxxFPWDL DS    XL2                  L(FILE-PASSWORD FOR SET)
*
xxxRES2  DS    XL2                  RESERVED
*
*
xxxLNLM  EQU   *-xxxNLMO

Bedeutung der Felder

Die Bedeutung der Parameter im Makroaufruf entspricht der Bedeutung der Parameter im Kommando MODIFY-FILE-FT-ATTRIBUTES. Bitte beachten Sie daher die entsprechende Kommandobeschreibung im Handbuch "openFT (BS2000) - Kommandoschnittstelle".

Operand (L-Form)	Adressfeld (D-Form)	Bedeutung im Kommando
FILE	FILE	FILE-NAME
FPASS	FPAS	PASSWORD der Datei
PERMACT	PACT	PERMITTED-ACTIONS
PREADF	PREAF	READ-FILE in der Struktur PERMITTED-ACTION
PINSU	PINSU	INSERT-DATA-UNIT in der Struktur PERMITTED-ACTION
PREPLF	PREPF	REPLACE-FILE in der Struktur PERMITTED-ACTION
PEXTDF	PEXTF	EXTEND-FILE in der Struktur PERMITTED-ACTION
PERAU	PERAU	ERASE-DATA-UNIT in der Struktur PERMITTED-ACTION
PREADA	PREAA	READ-ATTRIBUTES in der Struktur PERMITTED-ACTION
PCHNGA	PCHNA	CHANGE-ATTRIBUTES in der Struktur PERMITTED-ACTION
PDELF	PDELF	DELETE-FILE in der Struktur PERMITTED-ACTION
TRATT	TRATT	TRANSFER-ATTRIBUTES
DATA	DATA	DATA-TYPE in der Struktur TRANSFER-ATTRIBUTES
DCHRS	CHRS	CHARACTER-SET in DATA-TYPE
RECFORM	RECF	RECORD-FORMAT in der Struktur TRANSFER-ATTRIBUTES
RECSIZE	RECS	RECORD-SIZE in der Struktur TRANSFER-ATTRIBUTES
MSGINS	MSG	Rückgabewert des Aufrufs
AFPASS	APAS	Codierung des FPASS (GRAPHIC oder OCTETT)
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.