Extending Security Through Site Security Exits › CA Top Secret Exit/User Entry Points › UNDEFIND - Undefined Acid Entry

UNDEFIND - Undefined Acid Entry

Receives control after PREINIT processing and the initiation request determines that the original or assigned ACID is not defined to CA Top Secret.

When signon occurs in:

• FACILITY TYPE=CICS the UNDEFIND exit point is ignored, invoke default ACID processing through OPTION(20) and the facility DEFACID
• FACILITY TYPE=IMS the UNDEFIND exit point is ignored, invoke default ACID processing through IMS(IMSATSDF) and the facility DEFACID

Some reasons a valid ACID is assigned to security initialization are:

• Automatic terminal signon (ATS)
• FACILITY control option DEFACID
• JOBACID control option
• SUBACID control option

After all automatic assignments have failed, this exit point allows a new ACID to be assigned (for example to log the failure). The ACID assigned should have low power.

Parameters

TXAIUSER

@ Input ACID.

TXAIPASS

@ Password.

+0 = old password (8 byte maximum length)

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

TXAIPGMR

@ Programmer name (address can be zero, in which case no data).

TXAIACCT

@ Accounting data (address can be zero, in which case no data).

• +0 = 1 byte accounting field count (0 implies null positional field)
• +1 = 1 or more accounting data structures (if field count not zero)
• +0 = 1 byte length field
• +1 = accounting data field data

TXAITERM

@ Terminal id or reader name.

TXAIJOBN

@ JOB name.

TXA#FEED

@ TSS Feedback Area.

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.

Output

TXA#ACID

@ New assigned ACID (this is different from input).

TXAIPASS

@ Password.

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

TXAIJOBN

@ Original/altered JOB name.

TXAITERM

@ Original/altered reader or terminal ID.

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

Security initialization will be rejected as normal for undefined ACID. (Changes to parameters are ignored.)

10

Retry with altered parameters (must include TXA#ACID)