SEQNCE

Specifies the required part of a logical unit's logon message.

If 'characters' is a logon message, optional information, which is not specified in the LOGCHAR macroinstruction, can be used by the logon-interpret routine (if the ROUTINE operand is specified), or by an application program's LOGON exit routine.

To specify an apostrophe (') or an ampersand (&) within the logon message, code a double apostrophe ('') or a double ampersand (&&) within the character string. If the terminal user enters the logon message in lowercase and the message is not translated to uppercase (for example, by USS translate table), the value for 'characters' must be coded in lowercase.

Do not specify leading and trailing device-control characters within a character string that is to be interpreted, because the USS facility deletes these characters. Device control characters coded within a logon message will be deleted; therefore, a blank should not be coded for each occurrence of these characters. However, if a character within the logon message will be translated to a blank by the interpret table, code a blank to represent that character.

For non-SNA terminals, the length of the entire logon message (required information plus optional information) is limited to the number of characters that can be accommodated on one line of the terminal screen, up to 255 characters. For SNA terminals, the length is limited to 255 characters (VTAM® deletes new-line [NL] characters before the INTRPRET macroinstruction is completed).

For non-SNA terminals, if you do not code SEQNCE in one LOGCHAR macroinstruction and a logon message does not match the character string of the SEQNCE operand in a preceding LOGCHAR macroinstruction in the interpret table, VTAM accepts this logon message and requests logon for this terminal to the application program specified in the LOGCHAR macroinstruction (the one in which SEQNCE is not coded). Therefore, do not place a LOGCHAR macroinstruction at the beginning of the interpret table (immediately after the INTAB macroinstruction) without coding the SEQNCE operand. Otherwise, the remaining logon messages in the interpret table are not compared with the logon message entered by the terminal user.

If you code LOGCHAR for SNA devices, you need to code SEQNCE. Otherwise, VTAM rejects an attempt to logon to the application specified in the APPLID operand when you press the enter key. VTAM issues a sense code stating the enter key RU is not valid because it is null length. Pressing the space key (an acceptable RU), then the enter key allows the logon.