Remove crypto password from the job’s crypto password table
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The REMOVE-CRYPTO-PASSWORD command removes one, several or all crypto passwords from the crypto password table of a job. All passwords which are not explicitly removed with the command are automatically deleted at the end of the job.
Each time a crypto password is removed without error the counter for the number of crypto passwords in the crypto password table is decremented.
Crypto passwords can be up to 8 characters long. Crypto passwords with less than 8 characters are stored left-justified within the system and filled with binary zeros. This means that the two crypto passwords C’ABCD’ and C’ABCD'BLANK''BLANK''BLANK''BLANK'’ which are specified in the form of a C string are not identical, and owing to the different internal representation two different crypto passwords are calculated by the cryptographic algorithm:
| internal: |
|
| internal: |
|
The message DMS06DC notifies the caller that a specified crypto password could not be found in the crypto password table.
For information on encrypting files, see also the “Introductory Guide to DMS” [13].
REMOTE-FILE-ACCESS
The REMOVE-CRYPTO-PASSWORD command is automatically forwarded to all RFA partner processes by the requesting job.
Format
REMOVE-CRYPTO-PASSWORD | Alias: RMCPW |
PASSWORD = *ALL / *SECRET / list-poss(20): <c-string 1..8> / <x-string 1..16> | |
Operands
PASSWORD = *ALL / *SECRET / list-poss(20): <c-string 1..8> / <x-string 1..16>
Passwords which are to be removed from the crypto password table.
Up to 20 crypto passwords can be specified in a command. The specification is not case sensitive.
The PASSWORD operand has the following special features:
The value entered is not logged.
In guided dialog, the entry field is automatically blanked out.
If *SECRET or ^ is specified, in unguided dialog and in foreground procedures SDF provides a nondisplaying entry field for concealed entry of the password.
PASSWORD = *ALL
All entries are removed from the job’s crypto password table.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | CMD0202 | Syntactical or semantic error in the command | |
32 | DMS05C7 | Unexpected error in DMS | |
64 | DMS066A | Specified crypto password cannot be used | |
64 | DMS0691 | Crypto password table at maximum size | |
64 | DMS0692 | Maximum number of crypto passwords per task reached | |
64 | DMS06FF | BCAM connection severed | |
130 | DMS0594 | Not enough virtual memory available |