Extending Security Through Site Security Exits › CA Top Secret Exit/User Entry Points › PREINIT

PREINIT

Receives control on all initiation requests after the initial parameter list validation, but prior to processing.

Parameters

TXAIUSER

@ Userid (ACID) being signed on

TXAIPGMR

@ Programmer name field (20 chars, batch only)

TXAIACCT

@ Accounting information (batch only)

• +0 = 1 byte. Number of fields following this field format
• +0 = 1 byte length (0 implies null positional field)
• +1 = accounting data

TXAIPASS

@ Password.

• +0 = old password (8 byte maximum length)
• +128 = new password (if specified, 8 byte maximum length).

TXAIFACM

@ System facility matrix entry

TXAIGRP

@ Group assigned by job or sign on process prior to actual initiation of sign on.

TXAIPHRA

@ Old password phrase followed by new password phrase as 256 character areas. Applicable for z/OS 1.8 and above only.

• +0 = 1 byte length (0 implies no old password phrase)
• +1 = old password phrase data
• +256 = 1 byte length (0 implies no new password phrase data)
• +257 = new password phrase data

Note: You can only change the TXAIPHRA parameter if a password phrase is entered on the incoming parameter list. Otherwise, the TXAIPHRA parameter contains an address of 0.

Output

TXAIPASS

@ Password.

+0 = old password (8 byte maximum length)

+128 = new password (if specified, 8 byte maximum length)

$TXAIIMC

Flag indicating that a change in user mode or TXA#MODE has occurred. This flag is part of TXAIIND and must have an OR function applied with field TXAIIND to be set.

$TXAIAUD

Flag indicating that a user or session/job should be audited. This flag is part of TXAIIND and must have an OR function applied with field TXAIIND to be set.

$TXAISUS

Flag indicating that a user should be suspended and session/job should be cancelled. This flag is part of TXAIIND and must have an OR function applied with field TXAIIND to be set.

TXAIPHRA

@ Old password phrase followed by new password phrase in 256 character areas.

• +0 = 1 byte length (0 implies no old password phrase)
• +1 = old password phrase data
• +256 = 1 byte length (0 implies no new password phrase data)
• +257 = new password phrase data

Note: You can only change the TXAIPHRA parameter if a password phrase is entered on the incoming parameter list. Otherwise, the TXAIPHRA parameter contains an address of 0.

Return Codes

00

Normal continuance.

04

Fail request.

08

Continue without further checking.

0c

Continue in BYPASS mode.

10

Reserved.

14

Continue without password checking.

Any other

Fail request with RC=28 DRC=02.