An ECB-controlled program executes this general macro whenever a portion of
a message to or from the IBM 3614 Consumer Transaction Facility needs to be
enciphered or deciphered. Issuing the CIFRC macro causes the
IBM-supplied cipher program BQKCIPH or BQKDES to be executed.
Format
- label
- A symbolic name can be assigned to the macro statement.
- TEXT
- This parameter is required and must be coded exactly as shown.
- PGM
- This parameter identifies the cipher program being requested. It
must be either AET or DES. When this parameter is omitted a default is
used. If support for only one cipher program is generated, that will be
the default. If support for both cipher programs is generated, then the
default is AET.
- AET
- Causes program BQKCIPH to be executed.
- DES
- Causes program BQKDES to be executed.
Entry Requirements
- R9 must contain the address of the ECB being processed.
- R1 must contain the address of a 3-word parameter list. The
parameter list must contain the following information:
- Word
- Contents
- 0
- Request code: 0 indicates that the text is to be enciphered;
any other value indicates that the text is to be deciphered.
- 1
- Address of an 8-byte key to use in the enciphering or deciphering.
Any value is valid as a key.
- 2
- Address of the text to be enciphered or deciphered. This is also
the address at which the cipher program stores the enciphered or deciphered
text. Storage protection is disabled when the text is stored, so the
addressed main storage area may have any storage protection key. When
AET is specified, four bytes of text are used. When DES is specified,
eight bytes of text are used.
Only the first 4 or 8 bytes at this address are enciphered or
deciphered. To encipher or decipher more data, the CIFRC macro must be
executed again.
Return Conditions
- Control is returned to the next sequential instruction.
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
- The input text pointed to by the third word (word 2) of the input
parameter list is replaced by the enciphered or deciphered text.
Programming Considerations
- This macro can be executed on any I-stream.
- For a discussion of 3614 programming considerations, including data
enciphering, see the 3614 Programmer's Guide.
Examples
None.