Decrypt an encrypted file
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The DECRYPT-FILE command converts an encrypted file into an unencrypted file. This is only possible if the crypto password specified for this file in the ENCRYPT-FILE command is entered in to the task-specific crypto password table (see the ADD-CRYPTO-PASSWORD command).
The conversion of an encrypted file is logged by SAT, whereby the output audit attribute is taken from the catalog entry of the converted file (see the CREATE-FILE command, AUDIT operand).
By converting into an encrypted file, the auxiliary file is created and automatically deleted after completion of the function execution. The auxiliary file requires as much storage place as the converting file.
The file name of the auxiliary file has the following structure: S.DMS.<tsn>.<date><time>.CRYPTO
Notes on command execution
File locking and protection attributes which reject write access to the catalog entry or the content of the file prevent its conversion via the DECRYPT-FILE command.
The file conversion with the DECRYPT-FILE command requests having owner rights for executing operations on the file. The conversion takes place only in the following cases:
- The file is under user ID of the calling task.
- The called task is under a user ID with TSOS privilege.
- The user ID of a called task is a co-owner of the file, and the file is not temporary.
DECRYPT-FILE is rejected if the converted file can be accessed only via RFA.
Privileged functions
If the called task has the TSOS privilege, the following additional functions are possible:
- Temporary files that belong not to this current task, but to another one can be specified too.
- Temporary files can be allocated on another pubset set as default one for this user ID (such files are not automatically deleted after completion the called task).
Format
DECRYPT-FILE |
FILE-NAME = <filename 1..54 without-gen> |
Operands
FILE-NAME = <filename 1..54 without-gen>
Name of the file to be converted.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | CMD0202 | Syntactical or semantic error in the command | |
1 | 0 | CMD0001 | No action required |
2 | 0 | DMS05B6 | Time conversion UTC to LT errored |
2 | 0 | DMS05F5 | Defective blocks were not copied |
130 | DMS0524 | System address space exhausted | |
130 | DMS0582 | The file is currently locked or in use and cannot be processed | |
130 | DMS0585 | An error was detected during catalog processing or during multiprocessor processing. | |
130 | DMS0588 | Disk storage could not be assigned | |
130 | DMS0594 | Insufficient virtual memory available | |
32 | DMS0584 | During processing a status was reported which prevents the function from being continued. | |
32 | DMS05C7 | Unexpected internal error in DMS | |
64 | CMD0216 | Privileges error | |
64 | DMS0501 | Requested catalog not available | |
64 | DMS0512 | Requested catalog not found | |
64 | DMS051B | Requested user ID not in pubset | |
64 | DMS051C | User does not have access right for pubset | |
64 | DMS0535 | Specified file not shareable | |
64 | DMS057C | Processing not possible because of HSMS error | |
64 | DMS057E | File migrated, HSMS not available | |
64 | DMS0585 | An error was detected during catalog processing or during multiprocessor processing. | |
64 | DMS0588 | Disk storage could not be assigned | |
64 | DMS05FC | Specified user ID not in the home pubset | |
64 | DMS0609 | Access to system file not possible | |
64 | DMS0681 | DMS error while executing job | |
64 | DMS0684 | File does not exist | |
64 | DMS06B5 | File open or catalog entry not updated after system error |