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.

ENHANCED-SECURITYFLAG

input

A 1-byte field indicating whether

Enhanced Security is intended for this

request.

TIRSECV-CMCB

input/

output

A structure containing the following

items:

CLIENT-USERID

input

A 64-byte field containing a copy of the

Userid sent by the client.

CLIENT-PASSWORD

input

A 64-byte field containing a copy of the

Password sent by the client.

SECURITY-TOKEN-LEN

input

The length of the security token sent by

the client.

SECURITY-TOKEN-PTR

input

A pointer to a security token sent by the

client.

TIRSECV-TRANCODE

input

The server load module transaction code.

TIRSECV-RETURNCODE

output

A 2-byte character field returning the

result of the validation attempt. The

following values are supported:

SECURITY-USED—defined as SPACES

SECURITY-NOT-USED—defined as "02"

SECURITY-APPLICATION-ERROR—

defined as "03"

TIRSECV-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 SECURITY-APPLICATIONERROR.