Delete TFT entry
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The REMOVE-FILE-LINK command deletes the entry with the specified file link name from the Task File Table (TFT) and releases all the private volumes and devices linked to the name. The reservation is also canceled for any files which were exclusively reserved using the SECURE-RESOURCE-ALLOCATION command. The command will be ignored if the TFT entry referred to is still locked by a LOCK-FILE-LINK, and will only be executed when this lock is canceled by an UNLOCK-FILE-LINK command (or at LOGOFF time).
The user can specify whether:
the task for tape devices is to retain an NDM-internal device type reservation (RELEASE-DEVICE),
tapes which were reserved for the file are to be released (UNLOAD-RELEASED-TAPE).
Default: devices are released, but tapes remain reserved.
If the TFT entry which is to be canceled is linked to a TST entry, the file counter in the TST entry is decremented by 1. As soon as this reaches the value 0, the TST entry is deleted, and DMS releases all the devices linked to this TST entry. As long as the TST entry is still linked to at least one TFT entry (file counter > 0), DMS will only release those devices which were requested for the TFT entry named in the REMOVE-FILE-LINK command.
If the TFT entry which is to be canceled does not point to a TST entry, all the devices linked to the TFT entry will be released.
Format
REMOVE-FILE-LINK | Alias: RMFL |
LINK-NAME = *FIRST-BLANK / <filename 1..8 without-gen with-wild(80)> ,RELEASE-DEVICE = *YES / *NO ,UNLOAD-RELEASED-TAPE = *NO / *YES ,SUPPRESS-ERRORS = *NONE / *LINK-NAME-NOT-FOUND | |
Operands
LINK-NAME = *FIRST-BLANK / <filename 1..8 without-gen with-wild(80)>
The file link name of the TFT entry which is to be deleted.
LINK-NAME = *FIRST-BLANK
If *FIRST-BLANK is specified, the first TFT entry whose file link name consists of spaces will be processed.
LINK-NAME = <filename 1..8 without-gen with-wild(80)>
The file link name of the TFT entry which is to be deleted.
Use of wildcards allows more than one TFT entry to be specified. If the first character in a wildcard sequence is “*”, it must be followed by at least one other wildcard character.
RELEASE-DEVICE = *YES / *NO
Specifies whether an NDM-internal device type reservation is to be retained when tapes of the task are released.
The reservation can then be used to request a device again. The reservation can be displayed using the SHOW-RESOURCE-ALLOCATION command and deleted with the SECURE-RESOURCE-ALLOCATION command.
RELEASE-DEVICE = *YES
When a tape is released an NDM-internal device type reservation is not retained.
RELEASE-DEVICE = *NO
When a tape is released an NDM-internal device type reservation is retained.
UNLOAD-RELEASED-TAPE = *NO / *YES
Specifies whether the tapes which were linked to this TFT entry are to be released.
UNLOAD-RELEASED-TAPE = *NO
The tapes to be released will not be unloaded.
UNLOAD-RELEASED-TAPE = *YES
The tapes to be released will be unloaded.
If the job requires to access these volumes again, they will have to be requested again.
Note
If there are several active files on a tape which is being released, then this volume will not actually be released until a REMOVE-FILE-LINK command has been issued for each of the active files.
SUPPRESS-ERRORS = *NONE / *LINK-NAME-NOT-FOUND
Specifies which errors are to be suppressed.
SUPPRESS-ERRORS = *NONE
All errors lead to the DMS error messages provided and, in non-S and ENTER procedures, trigger the spin-off mechanism, and, in S procedures, SDF-P error handling.
SUPPRESS-ERRORS = *LINK-NAME-NOT-FOUND
If no TFT entry is found in the LINK-NAME operand, the command is executed as though no error had occurred: no error message is issued, and the spin-off mechanism and SDF-P error handling are not triggered.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | 0 | CMD0001 | No action required |
2 | 0 | DMS059C | In conjunction with wildcards: not all the selected TFT entries can be deleted |
1 | CMD0202 | Syntactical or semantic error in command | |
130 | DMS0582 | File is currently locked or being used and cannot be processed |
Example
See the LOCK-FILE-LINK command.