Exit 9 – Auto-Answer Sign-On Validation

Use Exit 9 to create an accounting record or reject a sign-on attempt when an auto-answer port receives a valid sign-on card.

Your exit routine can reject sign-on cards using the criteria you define for your installation. For example, you can make some Binary Synchronous Communications (BSC) links ineligible for an auto-answer session or you can make links ineligible at defined times.

Point of Processing

Process Exit Attribute
Auto-answer Reentrant

Exit 9 is called when an auto-answer task receives a phone call and has verified that the sign-on record is valid. However, RSCS has not completed the link validation process.

On return, if the exit routine does not issue return code 8, RSCS transforms the dial-up task into the link driver specified on the sign-on record.

Entry Conditions

The following table shows the parameters passed in R0 and R1 to the first exit routine associated with this exit point. For more information about other register contents, see Standard Entry Conditions.

Register Contents
R0 Not applicable
R1 Address of a parameter list that contains:
Word 1 (+0)
Address of the CVT
Word 2 (+4)
Address of the PORT entry
Word 3 (+8)
Address of the LINKTABL entry
Word 4 (+12)
Address of a halfword field containing the length of the sign-on record
Word 5 (+16)
Address of the sign-on record

Exit Conditions

On return, Exit 9 sets the standard register contents (see Standard Exit Conditions).

Return Codes

Return Code Results
0 RSCS calls the next exit routine associated with this exit point and continues usual processing.
4 RSCS does not call any other exit routines associated with this exit point and continues usual processing.
8 RSCS rejects this sign-on attempt.

Programming Considerations

  • If RSCS recognizes the sign-on identification and finds a valid link identifier within the sign-on card, it determines that the sign-on card is valid. However, each link driver must determine if the entire sign-on card is valid for that link. For example, a password may be incorrect or may not have been specified.
  • Your exit routine should not modify any accessible control blocks.
  • To generate an accounting record at this exit, use CP DIAGNOSE code X'4C'. For more information, see z/VM: CP Programming Services.