Previous Topic: PurposeNext Topic: Return Code


Arguments

The following table gives a brief description of each of the arguments.

Name

I/O

Description

RUNTIME-PARM1

input

Under CICS, this is CICS EXEC Interface Block - DFHEIBLK.

RUNTIME-PARM2

input

Under CICS, this is DFHCOMMAREA.

TIRDCRYP-CMCB

input/ output

A pointer to a structure containing the following items:

 

 

DATA-BUFFER-PTR

input/ output

On input, a pointer to the starting location of the encrypted View Data and Client Security sections within the CFB work buffer.

On output, a pointer to the starting location of the area that now contains the unencrypted version of the input data. The length of this decrypted data cannot exceed DECRYPTION-MAX-SIZE.

BUFFER-SIZE

input/ output

On input, BUFFER-SIZE is the current buffer size (in bytes) of the encrypted data.

On output, BUFFER-SIZE should be updated by this exit to contain the length of the decrypted data. The length of the decrypted data cannot exceed DECRYPTION-MAX-SIZE.

DECRYPTION- MAX-SIZE

input

A field that contains the maximum available buffer space (in bytes) that the decrypted data can occupy.

TIRDCRYP-RETURN-CODE

output

A 2-byte character field returning the result of the decryption attempt. The following values are supported:

DECRYPTION-USED—defined as SPACES

DECRYPTION-SIZE-EXCEEDED-MAX—defined as 01

DECRYPTION-NOT-USED—defined as 02

DECRYPTION-APPLICATION-ERROR—defined as 03

FAILURE-MSG

output

An 80-byte character field, to be populated by this exit, to describe the failure with a message of choice. This failure message will be incorporated into an error message that is returned back to the client. Used in conjunction with a return code of DECRYPTION-APPLICATION-ERROR.