Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

DROPTFT - Release TFT entry

Macro type: type S (C form/D form/E form/L form/M form); see "Macro types"

The DROPTFT macro releases a LOCK-FILE-LINK lock for an entry in the task file table (TFT). If a REMOVE-FILE-LINK command or RELTFT macro call is still pending for this entry, it is processed now, i.e. the TFT entry is deleted according to the command/macro parameters and the private devices connected to it are released.

Format

Operation

Operands

DROPTFT

,LINK = <c-string 1..8> / <var: char:8>

,VERSION = <integer 1..1>

,MF = C / D / E / L / M

,PARAM = <addr> / <(r)>

,PREFIX = D / <pre>

,MACID = MAD / <macid>

Operand descriptions

File link name of the TFT entry to be released.

Default value:

 The first TFT entry with the link name *BLANK is released.

= <c-string 1..8>

File link name (specified in quotes).

= <var: char: 8>
Name of a variable that contains the file link name.

MACID
Only evaluated with MF=C/D/M; this defines the second, third and fourth characters of the field names and equates that are generated in the data area when the macro is expanded.

Default value:

 MACID = MAD

= macid 

“macid” is a three-character string that defines the second, third and fourth characters of the generated field names and equates.

MF
The forms of the MF operand are described in detail in the appendix ("Macro types").

Default value:

 Operand list and SVC as previously

PARAM

Designates the address of the operand list and is only evaluated in conjunction with MF=E (see also "Macro types").

= addr
The symbolic address (name) of the operand list.

= (r)
The number of the register containing the address of the operand list. The register must be loaded with this address value before calling the macro.

PREFIX

Only evaluated with MF=C/D/M; this defines the first character of the field names and equates that are generated in the data area when the macro is expanded.

Default value:

PREFIX = D

= pre

Single-character prefix with which the field names and equates generated by the assembler should begin.

VERSION = <integer 1..1>
Control operand; controls generation.

Programming notes

The error is returned in the standard header of the parameter area. Program termination with STXIT can be initiated in the following cases:

  • parameter address incorrect (e.g. shorter than the standard header)

  • parameter address not aligned on a word boundary

  • UNIT or FUNCTION in header incorrect

  • header is write-protected

Return codes

Standard header: ccbbaaaa

The following code relating to execution of the DROPTFT macro is returned in the standard header (cc = SUBCODE2, bb = SUBCODE1, aaaa = MAINCODE):

X'cc'

X'bb'

X'aaaa'

Meaning

X'02'

X'00'

X'0662'

Link name missing or invalid. No action necessary


X'40'

X'06FF'

BCAM connection not operational or is closed


X'01'

X'xxxx'

RFA not supported for version < 12